Cuando SSH falla, el error de la última línea suele ser un resumen, no un diagnóstico — Permission denied (publickey) te dice el resultado de una negociación, no dónde se torció. La historia de verdad está en ssh -vvv, que es por lo que la gente acaba pegando fragmentos en crudo como debug3: receive packet: type 51 en un buscador. No hace falta memorizar el protocolo para leer esa traza. Hace falta conocer el puñado de líneas que responden a preguntas reales, y cuáles son ruido.
Esto es una guía de lectura: qué añade cada nivel de -v, las fases que verás en orden, y un descifrador de las líneas en las que vale la pena detenerse. (Para los errores en sí — rechazado, tiempo agotado, avisos de clave de host — los arreglos están en el descifrador de errores.)
Qué añaden de verdad -v, -vv y -vvv
-vimprime las líneasdebug1: la narración de alto nivel. Qué archivos de configuración se leyeron, a dónde se conecta, qué ofreció el servidor, qué claves se probaron, qué método de autenticación ganó. Para la mayoría de los problemas, con esto basta.-vvañadedebug2: los detalles de la negociación — las listas completas de algoritmos de ambos lados, la decisión clave por clave.-vvvañadedebug3: la traza a nivel de paquete, incluidas las líneassend packet: type N/receive packet: type N. Este es el nivel que nombra los números de mensaje del protocolo, y de donde salen las misteriosas líneas que acabas buscando.
Empieza con -v. Recurre a -vvv cuando la historia de -v se corta en seco y necesitas ver el paquete exacto en el que murió.
Las fases, en el orden en que las verás
Toda conexión con éxito recorre el mismo camino, y la salida de depuración lo sigue. Conocer las fases significa que puedes decir dónde ocurrió un fallo antes de entender qué falló.
1. Configuración. Las primeras líneas son Reading configuration data /home/you/.ssh/config y .../etc/ssh/ssh_config, seguidas de Applying options for <pattern> por cada bloque Host que coincidió. Si SSH está usando un puerto, un usuario o una clave que no esperabas, el culpable aparece nombrado justo aquí — algún bloque que habías olvidado se está aplicando. (Qué va en ese archivo, y cómo funciona la coincidencia: la guía de ~/.ssh/config (en inglés).)
2. Conexión TCP. Connecting to host [1.2.3.4] port 22. y luego Connection established. Si en cambio ves connect to address ... Connection refused o Connection timed out, deja de leer — nada a partir de este punto importa, porque no hay ningún «después». Mira abajo.
3. Intercambio de versión. Local version string SSH-2.0-OpenSSH_... y Remote protocol version 2.0, remote software version ... — los dos extremos se presentan en texto plano. Útil sobre todo para detectar servidores vetustos y confirmar que siquiera llegaste a un sshd.
4. Intercambio de claves y clave de host. SSH2_MSG_KEXINIT sent / received, luego los algoritmos elegidos (kex: algorithm: ..., kex: host key algorithm: ...), y después la clave de host del servidor se coteja con tu known_hosts: Host 'x' is known and matches the ED25519 host key / Found key in ~/.ssh/known_hosts:12. Un desajuste aborta aquí con el gran banner de aviso.
5. Autenticación. Authentications that can continue: publickey,password es el servidor enumerando lo que aceptará. Luego el cliente recorre métodos y claves, un intento cada vez, hasta que algo tiene éxito — o nada lo tiene. En esta fase es donde se concentra la mayor parte de la lectura, así que tiene su propio descifrador.
Una traza anotada, de principio a fin
Aquí tienes una ejecución real (recortada) de -vvv del fallo más buscado — Permission denied (publickey) — con las líneas que importan señaladas. Cada fase de arriba se ve en orden:
$ ssh -vvv deploy@203.0.113.10
OpenSSH_9.6p1, OpenSSL 3.0.13
debug1: Reading configuration data /home/you/.ssh/config
debug1: /home/you/.ssh/config line 12: Applying options for 203.0.113.10 # ← un bloque Host coincidió; sospecha de él si el usuario/clave/puerto es incorrecto
debug1: Connecting to 203.0.113.10 [203.0.113.10] port 22.
debug1: Connection established. # ← el TCP está en pie: aquí quedan descartados «refused» y «timed out»
debug1: Local version string SSH-2.0-OpenSSH_9.6
debug1: Remote protocol version 2.0, remote software version OpenSSH_8.9p1 # ← llegaste a un sshd de verdad
debug1: SSH2_MSG_KEXINIT sent
debug1: SSH2_MSG_KEXINIT received
debug1: kex: algorithm: curve25519-sha256
debug1: Server host key: ssh-ed25519 SHA256:abc123...
debug1: Host '203.0.113.10' is known and matches the ED25519 host key. # ← la fase de clave de host pasó; no es un problema de known_hosts
debug1: Authentications that can continue: publickey # ← solo claves; nunca se ofrecerá una contraseña
debug1: Offering public key: /home/you/.ssh/id_ed25519 ED25519 SHA256:def456... # ← la clave que el cliente intentó de verdad
debug3: receive packet: type 51 # ← SSH_MSG_USERAUTH_FAILURE: el servidor rechazó esa clave
debug1: Trying private key: /home/you/.ssh/id_rsa # ← claves del agente agotadas; ahora recurre a los archivos de clave
debug1: No more authentication methods to try.
deploy@203.0.113.10: Permission denied (publickey).
Léelo de abajo arriba. El fallo es Permission denied (publickey); el último intento real por encima de él es el ofrecimiento de id_ed25519 que provocó un type 51. Así que el servidor vio esa clave y la rechazó — un problema del lado del servidor (usuario de inicio de sesión equivocado, la clave no está en authorized_keys, o permisos de ~/.ssh), no una clave que falta. Si id_ed25519 no hubiera aparecido en ninguna línea Offering public key, el diagnóstico cambiaría al lado del cliente: la clave nunca se envió.
El descifrador: líneas que responden a preguntas reales
Will attempt key: / Offering public key: ... — la respuesta a «¿qué claves está probando, y en qué orden?». En -v verás cada candidata: ruta del archivo o entrada del agente, tipo de clave, huella. Si la clave que querías no está en esta lista, el servidor nunca la vio — por mucho que arregles cosas en el lado del servidor, no servirá de nada. Apúntala explícitamente con -i y revisa la fase de configuración por si hay una línea IdentityFile que te está sobrescribiendo.
debug3: receive packet: type 51 — esto es SSH_MSG_USERAUTH_FAILURE: el servidor rechazó ese intento de autenticación. No es fatal por sí solo — el cliente se encoge de hombros y pasa a la siguiente clave o método, así que a menudo verás varios type 51 en un inicio de sesión sano. Se convierte en el diagnóstico solo cuando viene después de la clave que esperabas que funcionara: entonces el servidor miró esa clave y dijo que no — usuario equivocado, clave ausente de authorized_keys, o permisos incorrectos en el lado del servidor. Ese triaje es la guía de Permission denied. (Para orientarte: type 50 es la petición que sale, type 52 es el éxito.)
Server accepts key: seguido de un fallo de todas formas — la interesante. El servidor ha confirmado que esta clave pública está en authorized_keys y ha invitado al cliente a demostrar su posesión; si la autenticación aun así falla después de esta línea, el problema está en tu lado de la prueba: el agente no pudo firmar (socket de agente equivocado, el agente no tiene en realidad esa clave privada), un diálogo de frase de contraseña falló, o la clave privada en disco no coincide con la clave pública que se ofreció. Mira la línea sign_and_send_pubkey: — o su ausencia — justo después.
No more authentication methods to try. — el estado final. Todos los métodos que el servidor permitía se han agotado, y la línea inmediatamente siguiente es Permission denied. No leas esta línea como el error; lee hacia arriba desde ella para encontrar el último intento real y por qué falló.
Un cuelgue en expecting SSH2_MSG_KEX_ECDH_REPLY — no es para nada un problema de autenticación. La respuesta de intercambio de claves del servidor es el primer paquete grande de la conexión, y si nunca llega aunque todo lo anterior funcionara, la causa clásica es un problema de MTU o un middlebox que se porta mal — las VPN y algunos cortafuegos corporativos fragmentan o descartan los paquetes grandes. Prueba desde otra red o sin la VPN; si conecta, ajusta la MTU en lugar de quedarte mirando las claves.
Unspecified GSS failure — ruido de Kerberos. El cliente intentó autenticación GSSAPI, no estás en un dominio Kerberos, falló, y recurrió al siguiente método. Si la conexión al final tiene éxito o falla por claves, esta línea no jugó ningún papel — ignórala a menos que uses de verdad SSO de Kerberos.
connect to address ... port 22: Connection refused / Connection timed out — la conexión nunca ocurrió, así que toda pregunta sobre autenticación es irrelevante. «Refused» significa que el host respondió y no hay nada escuchando; «timed out» significa silencio en el camino. Dos investigaciones distintas, ninguna relacionada con claves — el diagnóstico de dos minutos cubre ambas ramas.
El flujo de trabajo que lo encuentra rápido
Tres hábitos convierten un muro de texto de depuración en una lectura de dos minutos:
- Reproduce sin el ruido.
ssh -vvv -o IdentitiesOnly=yes -i ~/.ssh/the_key user@hostofrece exactamente una clave, así que la traza contiene un intento en lugar de seis, y un type 51 solo puede significar una cosa. - Lee de abajo arriba. Encuentra el fallo al final, luego sube hasta la última decisión anterior — el último
Offering public key, la frontera de fase que nunca cruzó. Las primeras treinta líneas de una traza casi siempre están sanas. - Comprueba quién fijó qué. Cuando el comportamiento no cuadra con tu intención, las líneas
Reading configuration datayApplying options forde arriba nombran el archivo y el bloque responsables. La mitad de los «SSH ignora mis flags» es un bloque de configuración ganando en silencio.
Menos trazas que leer, para empezar
La traza es la herramienta correcta cuando algo se rompe — pero una parte de lo que revela es estado que no deberías tener que redescubrir: qué clave quiere este host, qué usuario, qué puerto. Termalin los guarda con el host guardado, así que la clave correcta se ofrece a propósito en lugar de en cuarto lugar en la fila de un agente, y verifica la identidad de cada servidor en la primera conexión con un aviso sonoro si la huella llega a cambiar — la fase de clave de host, gestionada de forma deliberada. El estado en vivo del host responde a «¿es siquiera alcanzable la máquina?» antes de que te conectes, que es la rama de refused/timed-out de la traza anticipada por completo. El plan Free no tiene límite de hosts — descárgalo y reserva -vvv para los días de verdad raros.
Termalin es un cliente SSH gratuito y multiplataforma que guarda con el host los puertos, usuarios, claves y keepalives por host, y verifica la identidad del servidor en cada conexión — descárgalo, o explora la lista completa de funciones.