Un túnel SSH local creado con ssh -L 5432:localhost:5432 usuario@servidor abre el puerto 5432 en tu equipo y reenvía cada conexión, cifrada dentro de SSH, al PostgreSQL del servidor. La base de datos sigue escuchando solo en el localhost remoto, sin abrir el puerto a Internet, y tu cliente se conecta a 127.0.0.1 como si fuera local.

Cómo funciona ssh -L 5432:localhost:5432 paso a paso

La sintaxis de -L es [dirección_local:]puerto_local:host_destino:puerto_destino, y el host de destino se resuelve desde el servidor SSH, no desde tu equipo. Por eso el localhost del medio significa «la máquina remota». La referencia completa está en la página de manual de ssh.

# Túnel en primer plano, sin abrir shell remota
ssh -N -L 5432:localhost:5432 [email protected]

# En otra terminal, conecta como si PostgreSQL fuera local
psql -h 127.0.0.1 -p 5432 -U app nombre_bd
  • -L 5432:localhost:5432: escucha en el 5432 local y entrega el tráfico al 5432 del servidor.
  • -N: no ejecuta ningún comando remoto; la conexión solo sirve de túnel.
  • -f (opcional): manda ssh a segundo plano después de autenticarse.

Si la base de datos vive en otra máquina de la red interna, cambia el destino: ssh -N -L 5432:db.interna:5432 admin@bastion. El tramo entre el bastión y db.interna ya no va cifrado por SSH, así que solo tiene sentido en una red de confianza. Por defecto ssh enlaza el puerto local a la interfaz de loopback; no lo expongas en 0.0.0.0 ni actives GatewayPorts salvo que sepas quién más llega a tu equipo.

Si ya tienes un PostgreSQL local en el 5432, ssh avisará con bind: Address already in use. Usa otro puerto local, por ejemplo -L 15432:localhost:5432, y conecta con -p 15432.

LocalForward en ~/.ssh/config: el túnel SSH sin recordar flags

LocalForward es la directiva de ssh_config equivalente a -L: primero el puerto local y después el host:puerto de destino, separados por un espacio.

Host db-prod
    HostName servidor.ejemplo.com
    User admin
    IdentityFile ~/.ssh/id_ed25519
    LocalForward 15432 localhost:5432
    ExitOnForwardFailure yes
    ServerAliveInterval 30

Con este bloque basta con ssh -N db-prod. Tres decisiones del ejemplo:

  1. Puerto 15432 en local: evita chocar con un PostgreSQL que ya escuche en el 5432 de tu equipo.
  2. ExitOnForwardFailure yes: si el puerto local está ocupado, ssh termina en lugar de abrir una sesión sin túnel que parece funcionar.
  3. ServerAliveInterval 30: envía un keepalive cada 30 segundos y detecta antes una conexión muerta.

OpenSSH es estricto con los permisos: ~/.ssh en 700 y la clave privada en 600. Todas las directivas aparecen en la documentación oficial de ssh_config.

Comprobar que el túnel SSH local escucha y conecta

El síntoma típico de un túnel roto es Connection refused en el cliente de base de datos; antes de tocar PostgreSQL, comprueba cada extremo por separado.

# En tu equipo: ¿hay algo escuchando en el puerto local?
ss -ltn | grep 15432              # Linux
lsof -iTCP:15432 -sTCP:LISTEN     # macOS

# En el servidor: ¿PostgreSQL escucha en loopback?
ss -ltn | grep 5432

# Depuración del propio ssh
ssh -v -N db-prod

Con -v verás si el servidor rechaza el reenvío con un mensaje administratively prohibited. En sshd_config, AllowTcpForwarding no desactiva los túneles; revisa también los bloques Match que lo restrinjan para ciertos usuarios.

Túnel SSH local desde el móvil: qué cambia frente al escritorio

Mosh no hace port forwarding: transporta la sesión por UDP, por defecto en los puertos 60000-61000, y solo usa SSH para arrancar mosh-server. Un túnel -L exige una conexión SSH clásica abierta mientras lo uses, y en iOS y Android el sistema puede suspender las apps que pasan a segundo plano.

Vía de acceso¿Reenvía puertos?Qué necesitaCuándo encaja
ssh -L en escritorioSí, TCP dentro de SSHPuerto 22 accesible y AllowTcpForwarding activoClientes gráficos de base de datos, migraciones desde tu equipo
Mosh en iOS/AndroidNoUDP 60000-61000 y mosh-server en el servidorShell que sobrevive al paso de wifi a datos
psql en el servidor, dentro de tmuxNo hace faltaSesión SSH o Mosh y psql instaladoConsultas rápidas desde el móvil
Red en malla (Prialo, Tailscale)No; acceso directo por IP privadaAgente en cada equipoAcceso habitual sin puertos abiertos ni túneles

Desde el teléfono, la vía práctica suele ser abrir sesión con Mosh, entrar en tmux y lanzar psql en el propio servidor. Con una terminal SSH y Mosh para móvil como termi1, la sesión aguanta el cambio de red, tmux conserva la consulta larga que dejaste corriendo y el teclado propio aporta Ctrl, Tab y flechas para recorrer el historial de psql o salir con Ctrl+D. La IA convierte «conéctate a la base de datos app» en el comando y lo escribe en el prompt sin pulsar Intro; en conexiones etiquetadas como producción, Production Guard retiene lo que borra o cambia algo. Con SFTP integrado bajas un volcado de pg_dump sin salir de la sesión.

Cuándo no usar un túnel SSH local (-L)

Un túnel -L es una solución puntual para una persona y una sesión; fuera de ese caso suele haber algo mejor.

  • Acceso permanente o compartido: si varias personas necesitan la base de datos a diario, una red privada sin abrir puertos como Prialo o Tailscale evita mantener túneles individuales.
  • Sesiones Mosh: Mosh no reenvía puertos; si necesitas el túnel, abre una conexión SSH aparte.
  • Enlazar a 0.0.0.0 o usar GatewayPorts: convierte tu portátil en puerta de entrada a la base de datos para toda la red local.
  • Servidores con AllowTcpForwarding no: es una política del administrador, no un fallo que sortear.
  • Consultas puntuales desde el móvil: ejecutar psql en el servidor es más simple que mantener vivo un túnel.

Preguntas frecuentes

¿Qué significa localhost en ssh -L 5432:localhost:5432?

En ssh -L 5432:localhost:5432, localhost se resuelve desde el servidor SSH, no desde tu equipo. Apunta por tanto al PostgreSQL que escucha en el loopback de la máquina remota. Para llegar a otra máquina de la red interna, sustitúyelo por su nombre o su IP privada.

¿Cómo dejo un túnel SSH local en segundo plano?

Un túnel SSH local pasa a segundo plano con ssh -f -N -L 15432:localhost:5432 admin@servidor: -f envía ssh al fondo tras autenticarse y -N evita abrir una shell. Para cerrarlo, localiza el proceso con pgrep -f 15432 y termínalo con kill.

¿Se puede hacer un túnel de puertos con Mosh?

Mosh no permite túneles de puertos: no admite port forwarding ni X11 forwarding y transporta la sesión por UDP, por defecto en los puertos 60000-61000. Para reenviar un puerto hace falta una conexión SSH convencional, que puede convivir en paralelo con la sesión Mosh.

¿Es seguro un túnel SSH local hacia una base de datos de producción?

Un túnel SSH local hacia producción cifra el tráfico y evita exponer el puerto a Internet, pero cualquier proceso de tu equipo puede usar el puerto reenviado mientras siga abierto. Enlázalo solo a 127.0.0.1, ciérralo al terminar y usa un usuario de base de datos con permisos mínimos.