termal.in

← Blog

Los flags de SSH que de verdad usarás (una hoja de referencia práctica)

· actualizado 12 nov 2026 · Termalin Team sshcheat-sheetproductivitytutorial

Respuesta corta: Los flags que más echarás mano: -p <port> (puerto no estándar), -i <key> (fuerza una clave concreta), -L / -R / -D (reenvíos locales, remotos y dinámicos), -J <bastion> (salta a través de un bastión), -N -f (manda un túnel a segundo plano sin shell), -t (fuerza un TTY para sudo), -o Option=value (fija cualquier directiva de ssh_config en línea), y -vvv (depura una conexión que falla). Cualquier cosa que pases dos veces va en ~/.ssh/config, así que ssh web1 la lleva sin un solo flag.

ssh --help vuelca cuarenta flags en orden alfabético, que es la forma menos útil de aprenderlos. Echas mano de los flags según lo que intentas hacer — conectarte como otro usuario, reenviar un puerto, saltar por un bastión, depurar un rechazo — así que aquí tienes el mismo conjunto organizado por tarea, con una nota sobre cuáles dejar de teclear y poner en tu ssh_config (en inglés) en su lugar.

La regla que hay debajo de todo esto: los flags son para cosas puntuales; la configuración es para lo permanente. Cualquier cosa que pases dos veces va en el archivo.

Lo básico de conexión

Los flags que responden a «quién, dónde y con qué clave».

  • -p <port> — conecta a un puerto no estándar. ssh -p 2222 user@host. (-p en minúscula; la -P en mayúscula es el flag de puerto de scp, con lo que todo el mundo tropieza una vez.)
  • -l <user> — el usuario de inicio de sesión, una alternativa al prefijo user@. ssh -l deploy host equivale a ssh deploy@host; verás -l en scripts y en documentación antigua.
  • -i <identity> — apunta a una clave privada concreta. ssh -i ~/.ssh/work_ed25519 user@host. El flag más útil cuando la autenticación falla: fuerza la clave exacta en lugar de dejar que el agente adivine.
  • -F <configfile> — usa un archivo de configuración distinto. ssh -F ./project.sshconfig web1, o -F /dev/null para ignorar tu configuración personal y probar sin ninguna personalización.
  • -v / -vv / -vvv — verbosidad, y el flag que acaba con la mayoría de los misterios. Un -v muestra los métodos de autenticación probados y las claves ofrecidas; -vvv muestra el apretón de manos completo. Cuando algo falla, vuelve a ejecutarlo con -vvv antes de teorizar — leer esa traza es una destreza en sí misma.

La vía de escape -o

Este es el flag que vale la pena entender a fondo, porque engloba docenas de los demás. -o fija cualquier opción de ssh_config en línea. Cualquier cosa que pudieras escribir en ~/.ssh/config bajo un bloque Host, la puedes pasar como -o Option=value — no una lista corta de opciones bendecidas, sino todo el vocabulario de configuración, disponible para una única conexión.

Unas cuantas que salen constantemente:

ssh -o IdentitiesOnly=yes -i ~/.ssh/right_key user@host   # ofrece solo esta clave
ssh -o StrictHostKeyChecking=accept-new user@host          # confía en hosts nuevos, pero sigue detectando cambios
ssh -o ServerAliveInterval=30 user@host                    # keepalive para un enlace inestable
ssh -o ProxyJump=bastion.example.com db.internal           # salta por un bastión en línea

-o IdentitiesOnly=yes es el arreglo para Too many authentication failures cuando tu agente ofrece seis claves y un servidor estricto te corta después de cinco. -o StrictHostKeyChecking=accept-new es el término medio sensato — confiar automáticamente en un host que nunca has visto, pero seguir gritando si la clave de un host conocido cambia.

La idea: no necesitas un flag especial para cada comportamiento. Si conoces la directiva de configuración, conoces el flag — es -o Directive=value. En cuanto estés pasando tres o cuatro cada vez, muévelos a la configuración para siempre.

Reenvíos y túneles

Los flags de la fontanería de puertos. El modelo mental — qué lado abre el puerto — tiene su propia lectura en el reenvío de puertos SSH explicado; aquí va el resumen de flags.

  • -L <local>:<host>:<port> — reenvío local. Abre un puerto en tu máquina que tuneliza hacia un destino alcanzable desde el servidor. ssh -L 5432:localhost:5432 db.example.com trae una base de datos remota a tu 127.0.0.1:5432.
  • -R <remote>:<host>:<port> — reenvío remoto. Abre un puerto en el servidor que tuneliza de vuelta a tu lado — el truco del túnel inverso para llegar a una máquina detrás de NAT.
  • -D <port> — reenvío dinámico. Un proxy SOCKS en tu máquina; el destino se elige por conexión. ssh -D 1080 jump.example.com, y luego apunta un navegador a 127.0.0.1:1080.
  • -N — no ejecutes ningún comando remoto. Combínalo con cualquier reenvío cuando quieras solo el túnel y ninguna shell.
  • -f — manda ssh a segundo plano después de conectar. Combínalo con -N para un túnel de lanzar y olvidar: ssh -fN -L 5432:localhost:5432 db.example.com.
  • -g — deja que otras máquinas de tu LAN usen un reenvío local (-L/-D), no solo 127.0.0.1. Una pequeña exposición — estás abriendo el túnel a toda tu red, así que úsalo de forma deliberada.

Jump hosts y el agente

Llegar al siguiente salto, y el flag con el que deberías tener cuidado.

  • -J <jumphost> — ProxyJump. Tuneliza a través de un bastión y autentica de extremo a extremo desde tu portátil hasta el destino. ssh -J bastion.example.com db.internal. El bastión solo transporta bytes cifrados; tu clave nunca aterriza en él — la forma correcta de pasar por un gateway. El caso completo: ProxyJump: llega a servidores detrás de un bastión.
  • -A — reenvío del agente. Expone un socket en el host remoto que hace de proxy de las peticiones de firma hacia tu agente local, de modo que un proceso de ahí puede autenticarse como tú ante el siguiente servidor. Cómodo y más arriesgado de lo que parece: cualquiera con root en ese host puede tomar prestada tu identidad mientras la sesión esté abierta. Usa -J para «llegar al siguiente salto» y reserva -A para hosts en los que confíes por completo — las razones están en el reenvío del agente es cómodo y peligroso (en inglés).

Entre los dos: -J lleva tu shell a un host detrás del bastión sin prestarle tus claves a nadie; -A presta el uso en vivo de tus claves a la máquina a la que te conectaste. No es el mismo trato.

Control de sesión

Los flags pequeños que arreglan molestias concretas.

  • -t — fuerza un pseudo-terminal. Necesario para un comando remoto que espera un TTY interactivo: ssh -t host 'sudo systemctl status nginx' te da un terminal de verdad para el diálogo de sudo y la salida con colores. Dóblalo (-tt) para forzar uno cuando no hay TTY local.
  • -q — modo silencioso. Suprime los avisos y los banners; útil en scripts donde solo quieres la salida propia del comando.
  • -C — solicita compresión. Una ventaja real en enlaces lentos y de alta latencia; insignificante o ligeramente negativa en una LAN rápida.
  • -o BatchMode=yes — nunca pidas nada. Si la autenticación necesitara una contraseña o una frase de contraseña, falla de inmediato en lugar de quedarse colgado. Esto es lo que hace que SSH sea seguro dentro de cron y CI — un diálogo atascado en un script desatendido se cuelga para siempre.

¿Qué puerto usa SSH?

SSH usa el puerto TCP 22 por defecto — es lo que ssh, scp, sftp y git sobre SSH asumen todos cuando no dices otra cosa. Para llegar a un servidor que escucha en otro sitio, pasa el puerto con -p:

ssh -p 2222 user@host

Para cambiar el puerto en el que escucha el servidor, pon Port en /etc/ssh/sshd_config y reinicia sshd — luego abre el puerto nuevo tanto en el cortafuegos del host como en el grupo de seguridad de la nube antes de cerrar la sesión, porque mover SSH sin permitir el puerto nuevo es la forma más rápida de dejarte fuera. (Salir del 22 acalla a los escáneres de paso; no es seguridad de verdad por sí solo.) Fíjalo una vez por host en tu ssh_config (en inglés) como Port 2222 y no vuelves a teclear -p.

Cómo ejecutar un comando por SSH sin una shell

Pon el comando entre comillas después del host y SSH lo ejecuta, imprime la salida y sale — no se abre ninguna shell interactiva:

ssh user@host 'df -h /'
ssh user@host 'systemctl is-active nginx'

Esto es la columna vertebral de los scripts y de cron: una conexión, un comando, un código de salida que puedes comprobar. Entrecomilla el comando para que tu shell local no lo expanda antes. Aquí importan dos flags:

  • -t fuerza un TTY para un comando que lo necesita — ssh -t user@host 'sudo systemctl restart nginx' le da a sudo un diálogo interactivo de verdad.
  • -o BatchMode=yes (o -n) evita que se quede esperando entrada, así que un trabajo desatendido falla rápido en lugar de colgarse en un diálogo.

Cómo salir de una sesión SSH

Escribe exit, o pulsa Ctrl-D, para cerrar la shell y soltar la conexión. Ambos envían fin de archivo a la shell remota, que te cierra la sesión y te devuelve a tu prompt local:

exit        # o pulsa Ctrl-D

Cuando una sesión está congelada — el enlace murió y el terminal ignora todo, incluso Ctrl-C — exit no puede ayudar, porque nada de lo que teclees llega al otro extremo. Usa en su lugar la propia secuencia de escape de SSH: pulsa Enter, luego teclea ~. (la virgulilla, y después un punto). Eso le dice a tu ssh local que derribe la conexión de inmediato, por muy atascado que esté el lado remoto. El escape ~ solo se lee justo después de un salto de línea, que es por lo que pulsas Enter primero.

La referencia compacta

FlagQué haceEquivalente en ssh_config
-p 2222Puerto no estándarPort 2222
-l user / user@Usuario de inicio de sesiónUser user
-i ~/.ssh/keyIdentidad concretaIdentityFile ~/.ssh/key
-F fileArchivo de configuración alternativo— (esto es la configuración)
-v … -vvvDetallado / depuraciónLogLevel DEBUG3
-o Opt=valCualquier opción de configuración en línea(la propia opción)
-L a:host:bReenvío localLocalForward a host:b
-R a:host:bReenvío remotoRemoteForward a host:b
-D 1080Reenvío dinámico (SOCKS)DynamicForward 1080
-NSin comando remotoRequestTTY no (+ ningún comando)
-fA segundo plano tras conectar— (solo puntual)
-gAbre el reenvío a tu LANGatewayPorts yes
-J hostSalta por un bastiónProxyJump host
-AReenvía el agenteForwardAgent yes
-tFuerza un TTYRequestTTY force
-qSilenciosoLogLevel QUIET
-CCompresiónCompression yes
-o BatchMode=yesNunca pide nadaBatchMode yes

La columna de la derecha es la señal. Casi todos los flags tienen un equivalente en la configuración, y ese es el flujo de trabajo: usa el flag una vez para comprobar que una conexión funciona, luego mueve los que vayas a repetir a ~/.ssh/config para que ssh web1 los lleve todos sin ningún flag. Los flags que no tienen equivalente en la configuración — -f, -F, la verbosidad de depuración — son los genuinamente puntuales.

Dónde un cliente guarda el estado por ti

Los flags y la configuración viven ambos en tus dot-files, por máquina, y eso duele a escala: ajustes copiados a mano entre portátiles, túneles que hay que relanzar tras cada suspensión, ninguna forma de ver cuál de cuarenta hosts está en pie. Termalin guarda los mismos datos que llevaría un flag — puerto, usuario, clave, jump host, keepalives, reenvíos locales/remotos/dinámicos guardados — asociados al host como datos estructurados, organizados en carpetas y etiquetas, sincronizados entre tus máquinas con cifrado de extremo a extremo. Verifica cada servidor en la primera conexión, muestra el estado en vivo por host, y levanta los túneles junto con la conexión en lugar de con un comando reescrito. Los flags te enseñan lo que está pasando; un cliente te libra de reescribirlos cada mañana.


Termalin es un cliente SSH gratuito y multiplataforma que guarda por ti los ajustes, las claves y los túneles por host — descárgalo, o lee cómo gestiona tus claves de forma segura.

Pruébalo en un host.

Termalin es un cliente SSH rápido para ti y para tus agentes.

Plan gratuito · 14 días de Pro de prueba · precios

Añade Termalin como fuente preferida en Google