Tutoriales de VPS
Túneles SSH en una VPS: reenvío local, remoto y proxy SOCKS
Accede a bases de datos y paneles privados, comparte vistas previas y configura SOCKS para aplicaciones concretas. Gestiona systemd, bastiones y cuentas limitadas, con límites de cifrado y publicación claros.

Una base de datos que solo escucha en 127.0.0.1, un panel Grafana privado y una vista previa en tu portátil comparten una necesidad: permitir acceso autorizado a un servicio TCP sin publicarlo innecesariamente. ssh de OpenSSH ya ofrece reenvío de puertos. Empieza con claves SSH verificadas y confirma que la política del servidor permita el reenvío necesario.
| Opción | Dónde escucha | Desde dónde conecta al destino |
|---|---|---|
-L | Cliente SSH | Servidor SSH |
-R | Servidor SSH | Cliente SSH |
-D | Proxy SOCKS local | El servidor alcanza el destino solicitado |
L significa Local, R Remote y D Dynamic. Puedes combinar varios reenvíos en una conexión. No confundas dónde se abre la escucha con quién resuelve y conecta al destino.
La notación original es:
ssh -L [本地地址:]本地端口:目标主机:目标端口 用户@跳板服务器
目标主机 significa host de destino. Sustituye todos los marcadores descriptivos por datos reales; ese destino se resuelve desde el servidor SSH.
ssh -N -L 3306:127.0.0.1:3306 [email protected]
El cliente escucha en su puerto 3306 y el servidor conecta a su propio 127.0.0.1 puerto 3306. Usa una cuenta no root autorizada para esa función. -N evita ejecutar un comando remoto y deja la conexión para el túnel. En configuraciones operativas indica expresamente loopback para las escuchas administrativas locales.
Mantén la base de datos privada según la guía de exposición de bases de datos, por ejemplo en 127.0.0.1.
# 本机 3307 转发到服务器的 3306(用 3307 避免和本机已有 MySQL 冲突)
ssh -N -L 3307:127.0.0.1:3306 [email protected]
En Navicat, DBeaver o TablePlus configura:
- Host:
127.0.0.1. - Puerto local:
3307, para evitar un MySQL local existente. - Credenciales: la cuenta de la base de datos, no la de SSH.
ssh -N -L 5433:127.0.0.1:5432 [email protected]
Aquí 5433 local apunta a PostgreSQL 5432 remoto.
ssh -N -L 6380:127.0.0.1:6379 [email protected]
# 另开一个终端
redis-cli -h 127.0.0.1 -p 6380
Aquí 6380 apunta a Redis 6379. La autenticación y ACL de Redis siguen siendo necesarias: el túnel no autoriza operaciones del servicio.
Distingue 127.0.0.1 de localhost. Algunos clientes MySQL interpretan localhost como socket Unix. Para el túnel elige TCP y 127.0.0.1, evitando una conexión localhost que termine usando el socket local.
Para Grafana, Portainer, Adminer, Metabase o pgAdmin privados, por ejemplo en 127.0.0.1:3000:
ssh -N -L 3000:127.0.0.1:3000 [email protected]
Abre http://localhost:3000 en tu ordenador. Reduce la exposición pública, pero conserva autenticación, permisos y actualizaciones del panel. Otros procesos del cliente pueden alcanzar el puerto reenviado. El túnel no reemplaza la seguridad de la aplicación; usa ~/.ssh/config más adelante para guardar la configuración.
ssh -N -L 8888:127.0.0.1:8888 [email protected]
El patrón sirve para Jupyter, Streamlit, Gradio o TensorBoard si sus listeners y autenticación están bien configurados. Mantén tokens o contraseñas y verifica la dirección de escucha real en vez de asumirla.
-N resulta cómodo en una terminal dedicada. Sin -N también se abre una sesión remota:
ssh -L 3307:127.0.0.1:3306 [email protected]
# 进去之后隧道一直有效,直到你退出这个会话
-f solicita pasar al segundo plano tras autenticar:
ssh -f -N -L 3307:127.0.0.1:3306 [email protected]
Para conexiones duraderas, -f por sí solo ofrece poca visibilidad y no recupera automáticamente el proceso. Utiliza un supervisor con SSH en primer plano y una forma definida de detenerlo.
ssh -N -R 8080:127.0.0.1:3000 [email protected]
El servidor escucha en 8080 y el cliente conecta a su propio loopback 3000. Con la política habitual, curl 127.0.0.1:8080 en el servidor puede funcionar mientras el acceso externo a 203.0.113.10:8080 falla.
Revisa la configuración efectiva de sshd_config:
#GatewayPorts no ← 官方默认值
GatewayPorts no normalmente mantiene los reenvíos remotos en loopback. Publicarlos en otras interfaces requiere una decisión explícita. El original muestra clientspecified:
sudo sed -i 's/^#\?GatewayPorts.*/GatewayPorts clientspecified/' /etc/ssh/sshd_config
sudo sshd -t && sudo systemctl reload ssh
El sed solo modifica una línea coincidente del archivo principal. Include, prioridad del primer valor y Match pueden controlar el resultado. Guarda los archivos, valida con sshd -t y sshd -T para la cuenta/dirección real, y recarga el servicio ssh/sshd correcto.
ssh -N -R 0.0.0.0:8080:127.0.0.1:3000 [email protected]
Escuchar en 0.0.0.0 puede exponer el servicio del portátil a cualquiera autorizado a alcanzar esa puerta del servidor. Revisa credenciales de aplicación, contenido y cortafuegos. Prefiere mantener GatewayPorts no: -R publica en loopback remoto y una conexión autorizada -L lo consume. Un compañero puede crear su propio -L limitado.
-R también permite que un equipo privado inicie SSH hacia fuera y que el servidor alcance el servicio elegido. Para acceso gestionado y duradero de varios servicios, evalúa FRP, Cloudflare Tunnel o Pangolin con sus políticas de identidad y publicación.
ssh -N -D 1080 [email protected]
El puerto local 1080 actúa como proxy SOCKS. Configura una aplicación compatible con socks5://127.0.0.1:1080. Solo pasa por él el tráfico de las aplicaciones configuradas; no cambia toda la red del ordenador.
-L fija un destino; -L necesita una asignación para cada caso, mientras -D admite destinos solicitados por el cliente SOCKS, según las restricciones del servidor.
Muchos clientes con socks5:// resuelven DNS localmente. Un cliente compatible puede usar socks5h://:
socks5h://127.0.0.1:1080
En Firefox revisa about:config, network.proxy.socks_remote_dns con valor true y la configuración de proxy real. El comportamiento DNS depende de la aplicación; compruébalo.
El tráfico de -D está cifrado dentro de SSH. HTTP ordinario sigue en claro desde el servidor al sitio de destino, mientras HTTPS mantiene su protección de extremo a extremo. También importan el tramo local y los equipos participantes. SOCKS aporta encaminamiento, no cifrado universal hasta cualquier destino.
Añade una entrada local en ~/.ssh/config:
Host db-tunnel
HostName 203.0.113.10
User root
IdentityFile ~/.ssh/id_ed25519
LocalForward 3307 127.0.0.1:3306
LocalForward 5433 127.0.0.1:5432
ServerAliveInterval 30
ServerAliveCountMax 3
ExitOnForwardFailure yes
SessionType none
Después ssh db-tunnel establece ambos túneles. Sustituye servidor, cuenta y clave, e indica las direcciones locales explícitamente.
- Varias líneas
LocalForwardabren varios reenvíos locales. RemoteForwardequivale a-R.SessionType nonecorresponde a-Nen un cliente compatible.ServerAliveInterval 30envía comprobaciones cifradas; el contador determina cuándo cerrar por falta de respuesta.ExitOnForwardFailure yestermina si no consigue establecer la escucha solicitada.
ExitOnForwardFailure no verifica que el servicio final responda: esas conexiones se realizan después. Prueba también la aplicación. Coloca Host específicos antes de los valores generales y comprueba opciones soportadas por clientes antiguos.
Cambios de red, inactividad y reinicios pueden romper el túnel. Un supervisor reinicia SSH en primer plano. autossh sigue siendo una alternativa que puedes evaluar; la fecha de commit de julio de 2024 citada por el original no demuestra por sí sola abandono ni constituye una evaluación actual.
Ejemplo de unidad en /etc/systemd/system/db-tunnel.service:
[Unit]
Description=SSH Tunnel for remote database access
After=network-online.target
Wants=network-online.target
[Service]
User=tunnel
ExecStart=/usr/bin/ssh -NT \
-o ExitOnForwardFailure=yes \
-o ServerAliveInterval=30 \
-o ServerAliveCountMax=3 \
-o StrictHostKeyChecking=accept-new \
-i /home/tunnel/.ssh/id_ed25519 \
-L 127.0.0.1:3307:127.0.0.1:3306 \
[email protected]
Restart=always
RestartSec=10
[Install]
WantedBy=multi-user.target
Crea primero el usuario local tunnel y su directorio; autoriza una clave independiente y limitada en la cuenta remota. Comprueba propietario, lectura de archivos y autenticación no interactiva. Verifica la clave del servidor por un canal fiable y prepara known_hosts; prefiere StrictHostKeyChecking=yes a tratar accept-new como verificación previa. Añade BatchMode=yes para que una credencial fallida termine en vez de esperar entrada. Las claves personales con frase y las de servicio desatendido necesitan tratamientos distintos.
sudo systemctl daemon-reload
sudo systemctl enable --now db-tunnel
127.0.0.1 en -L 127.0.0.1:3307:... evita publicar accidentalmente en la LAN con 0.0.0.0. Las dependencias de network-online.target mejoran el orden de arranque, pero no garantizan acceso al servidor remoto. Conserva reintentos, examina journalctl -u db-tunnel y prueba detención, reinicio del equipo y acceso real a la base de datos.
ssh -J [email protected]:22 [email protected]
-J existe desde OpenSSH 7.3. Verifica las identidades de ambos servidores y configura sus cuentas:
Host internal-server
HostName 10.0.0.5
User deploy
ProxyJump [email protected]
IdentityFile ~/.ssh/id_ed25519
También puedes reenviar a través del salto:
ssh -J [email protected] -N -L 3307:127.0.0.1:3306 [email protected]
El destino 127.0.0.1 pertenece al servidor final 10.0.0.5. El bastión transporta la conexión SSH; no es aquí el endpoint de la base de datos.
El túnel utiliza la conectividad y permisos del servidor. Puede alcanzar otro host interno si el servidor lo alcanza y la política lo permite; no se limita a sus propios puertos. Las credenciales de aplicación siguen controlando las operaciones.
No actives GatewayPorts yes, ni clientspecified con 0.0.0.0, sin una decisión de publicación. Revisa AllowTcpForwarding: el valor upstream yes puede estar modificado por la imagen. En sistemas compartidos, limita usuarios o grupos en sshd_config:
AllowTcpForwarding no
Match Group tunnelusers
AllowTcpForwarding yes
Ese grupo es un punto de partida, no una cuenta completamente restringida. Si conservas shell arbitrario, un usuario puede implementar otros métodos de reenvío; una opción SSH no lo aísla.
Usa una cuenta dedicada para túneles desatendidos. Una shell nologin puede funcionar con -N, pero PAM y políticas de cuenta varían: pruébalo. El ejemplo de authorized_keys usa command= y permitopen=:
command="/bin/false",no-pty,no-agent-forwarding,permitopen="127.0.0.1:3306" ssh-ed25519 AAAA... tunnel-key
permitopen limita destinos locales/dinámicos, no escuchas de reenvío remoto. Para un acceso exclusivo a esa base de datos, limita además la cuenta en el servidor:
Match User tunnel
AllowTcpForwarding local
PermitOpen 127.0.0.1:3306
PermitListen none
AllowStreamLocalForwarding no
X11Forwarding no
AllowAgentForwarding no
PermitTTY no
ForceCommand /bin/false
Valida soporte de versión y opciones efectivas antes de recargar, conserva recuperación administrativa y prueba el rechazo de otros destinos, reenvíos inversos y shells. Sustituye la pública truncada por una completa y verificada. El comando forzado no se ejecuta en una sesión -N sin comando; quitar -N del servicio requiere revisar esta política.
Un túnel TCP/SOCKS no crea una interfaz de red general, aunque sí alcanza destinos TCP internos autorizados. Para conectar redes o varios equipos, considera WireGuard o Tailscale/Headscale.
bind: Address already in use: cambia el puerto local o identifica quién escucha:
# Linux / macOS
sudo ss -lntp 'sport = :3307'
# Windows
netstat -ano | findstr :3307
ss es de Linux; en macOS usa lsof -nP -iTCP:3307 -sTCP:LISTEN. En Windows identifica el PID. Consulta conflictos de puertos.
channel 2: open failed: connect failed: Connection refused: comprueba el destino desde el equipo que establece esa conexión:
# 在服务器上执行
sudo ss -lntp 'sport = :3306'
En reenvío local, revisa listener, dirección y red/publicación Docker del servidor SSH. En -R, el destino está del lado del cliente. Connection refused suele indicar falta de listener, aunque también puede ser un rechazo explícito de red.
channel 3: open failed: administratively prohibited: revisa sshd_config / AllowTcpForwarding efectivos y las restricciones de authorized_keys, incluidas permitopen y no-port-forwarding.
SSH conecta, la aplicación no: comprueba en este orden:
- Habilita
ExitOnForwardFailure yespara detectar errores de escucha. - Verifica el listener del destino con
ssen el lado correcto. - Apunta al
127.0.0.1;localhostpuede seleccionar un socket u otra dirección. - Usa el puerto local reenviado real y después comprueba credenciales y protocolo.
Desconexiones: ServerAliveInterval 30 puede ayudar con inactividad; revisa registros y cortes SSH. Permission denied (publickey) es un fallo de autenticación previo al túnel; consulta Permission denied.
¿Está cifrado? El tramo SSH sí. El tramo posterior necesita TLS cuando corresponda; no extiendas un ejemplo MySQL en el mismo host a tráfico de base de datos por redes no fiables.
¿Pueden compartirlo otros usuarios? Escuchar en 0.0.0.0 puede prestarles tu acceso. Prefiere identidades individuales y loopback, con auditoría propia de la aplicación.
¿Cuánto ralentiza? Depende de cifrado, CPU, latencia y almacenamiento. El 10–20 % del original es ilustrativo, no una medición prometida. Mide tu carga.
¿Admite UDP? Los reenvíos normales -L/-R/-D transportan TCP, no un túnel UDP general. Para UDP utiliza una solución de red apropiada.
¿Vuelve tras reiniciar? Un servicio correcto con enable puede arrancar otra vez. Un ssh -L manual no se recrea; deben funcionar red y autenticación.
¿Y Windows? Verifica o instala OpenSSH Client en una versión compatible. Las opciones son similares, con rutas y comillas propias. MobaXterm o Termius pueden ofrecer gestión gráfica según sus condiciones de almacenamiento y acceso.
¿Qué herramienta elegir?
- Pocos puertos temporales autorizados: SSH cuando la política existente lo permita.
- Acceso duradero a servicios: evalúa FRP o Cloudflare Tunnel.
- Conectividad de red: evalúa WireGuard o Tailscale.
Todos necesitan una política de identidad y publicación; incluso SSH puede requerir cambios de servidor aunque no instales otro daemon.
- Claves SSH — credenciales limitadas.
- Bases de datos fuera de la internet pública.
- Diagnosticar desconexiones SSH.
- FRP para acceso inverso gestionado.
- Redes con WireGuard.