Quando o SSH falha, o erro na última linha costuma ser um resumo, não um diagnóstico — Permission denied (publickey) diz o resultado de uma negociação, não onde ela deu errado. A história de verdade está no ssh -vvv, e é por isso que as pessoas acabam colando fragmentos crus como debug3: receive packet: type 51 em um buscador. Você não precisa decorar o protocolo para ler esse rastro. Você precisa conhecer o punhado de linhas que respondem a perguntas de verdade, e quais são ruído.
Este é um guia de leitura: o que cada nível de -v acrescenta, as fases que você verá em ordem e um decodificador para as linhas em que vale a pena parar. (Para os erros em si — refused, timed out, avisos de chave de host — as correções estão em o decodificador de erros.)
O que -v, -vv e -vvv realmente acrescentam
-vimprime as linhasdebug1: a narrativa de alto nível. Quais arquivos de configuração foram lidos, para onde está se conectando, o que o servidor ofereceu, quais chaves foram testadas, qual método de autenticação venceu. Para a maioria dos problemas, isso basta.-vvacrescenta odebug2: os detalhes da negociação — listas completas de algoritmos dos dois lados, a decisão tomada chave por chave.-vvvacrescenta odebug3: o rastro no nível de pacote, incluindo as linhassend packet: type N/receive packet: type N. É o nível que nomeia os números das mensagens de protocolo, e é de onde vêm as linhas misteriosas que acabam no buscador.
Comece pelo -v. Recorra ao -vvv quando a história do -v termina de repente e você precisa ver o pacote exato em que ela morreu.
As fases, na ordem em que você vai vê-las
Toda conexão bem-sucedida percorre o mesmo caminho, e a saída de debug o segue. Conhecer as fases significa que você consegue dizer onde uma falha aconteceu antes de entender o que falhou.
1. Configuração. As primeiras linhas são Reading configuration data /home/you/.ssh/config e .../etc/ssh/ssh_config, seguidas de Applying options for <pattern> para cada bloco Host que casou. Se o SSH está usando uma porta, um usuário ou uma chave que você não esperava, o culpado é nomeado bem aqui — algum bloco de que você se esqueceu está sendo aplicado. (O que vai nesse arquivo, e como o casamento funciona: o guia do ~/.ssh/config (em inglês).)
2. Conexão TCP. Connecting to host [1.2.3.4] port 22. e então Connection established. Se, em vez disso, você vê connect to address ... Connection refused ou Connection timed out, pare de ler — nada depois deste ponto importa, porque não existe “depois”. Veja abaixo.
3. Troca de versão. Local version string SSH-2.0-OpenSSH_... e Remote protocol version 2.0, remote software version ... — as duas pontas se apresentam em texto puro. Útil sobretudo para identificar servidores antiquíssimos e confirmar que você chegou a um sshd, afinal.
4. Troca de chaves e chave de host. SSH2_MSG_KEXINIT sent / received, depois os algoritmos escolhidos (kex: algorithm: ..., kex: host key algorithm: ...), depois a chave de host do servidor é conferida contra o seu known_hosts: Host 'x' is known and matches the ED25519 host key / Found key in ~/.ssh/known_hosts:12. Uma divergência aborta aqui, com o grande banner de aviso.
5. Autenticação. Authentications that can continue: publickey,password é o servidor listando o que vai aceitar. Depois o cliente percorre métodos e chaves, uma tentativa de cada vez, até que algo dê certo — ou nada dê. É nesta fase que acontece a maior parte da leitura, então ela ganha o próprio decodificador.
Um rastro comentado, do início ao fim
Aqui está uma execução real (abreviada) de -vvv da falha mais buscada — Permission denied (publickey) — com as linhas que importam destacadas. Cada fase acima aparece em ordem:
$ 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 # ← um bloco Host casou; suspeite dele se o usuário/chave/porta estiver errado
debug1: Connecting to 203.0.113.10 [203.0.113.10] port 22.
debug1: Connection established. # ← o TCP subiu: refused / timed out está descartado aqui
debug1: Local version string SSH-2.0-OpenSSH_9.6
debug1: Remote protocol version 2.0, remote software version OpenSSH_8.9p1 # ← você chegou a um sshd de verdade
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. # ← a fase de chave de host passou; não é problema de known_hosts
debug1: Authentications that can continue: publickey # ← só chaves; nenhuma senha será oferecida
debug1: Offering public key: /home/you/.ssh/id_ed25519 ED25519 SHA256:def456... # ← a chave que o cliente de fato tentou
debug3: receive packet: type 51 # ← SSH_MSG_USERAUTH_FAILURE: o servidor rejeitou essa chave
debug1: Trying private key: /home/you/.ssh/id_rsa # ← chaves do agente esgotadas; agora recorrendo aos arquivos de chave
debug1: No more authentication methods to try.
deploy@203.0.113.10: Permission denied (publickey).
Leia de baixo para cima. A falha é Permission denied (publickey); a última tentativa real acima dela é a oferta de id_ed25519 que recebeu um type 51. Então o servidor viu essa chave e a recusou — um problema do lado do servidor (usuário de login errado, a chave não está em authorized_keys ou permissões de ~/.ssh), não uma chave ausente. Se id_ed25519 nunca tivesse aparecido em uma linha Offering public key, o diagnóstico viraria do lado do cliente: a chave nunca foi enviada.
O decodificador: linhas que respondem a perguntas de verdade
Will attempt key: / Offering public key: ... — a resposta para “quais chaves ele está tentando, e em que ordem?”. No -v você verá cada candidata: caminho do arquivo ou entrada do agente, tipo da chave, impressão digital. Se a chave que você queria não está nessa lista, o servidor nunca a viu — nenhum conserto do lado do servidor vai ajudar. Aponte para ela explicitamente com -i e confira na fase de configuração se há uma linha IdentityFile sobrepondo a sua escolha.
debug3: receive packet: type 51 — isto é SSH_MSG_USERAUTH_FAILURE: o servidor rejeitou aquela tentativa de autenticação. Não é fatal por si só — o cliente dá de ombros e passa para a próxima chave ou método, então você verá vários type 51 em um login saudável. Ele só vira o diagnóstico quando vem logo depois da chave que você esperava que funcionasse: aí o servidor olhou para essa chave e disse não — usuário errado, chave ausente de authorized_keys ou permissões ruins no lado do servidor. Essa triagem é o guia do Permission denied. (Para se orientar: type 50 é a requisição saindo, type 52 é sucesso.)
Server accepts key: seguido de falha mesmo assim — a interessante. O servidor confirmou que esta chave pública está em authorized_keys e convidou o cliente a provar que é o dono; se a autenticação ainda falha depois desta linha, o problema está do seu lado da prova: o agente não conseguiu assinar (socket de agente errado, o agente não guarda de fato aquela chave privada), um pedido de frase-senha falhou, ou a chave privada no disco não corresponde à chave pública que foi oferecida. Olhe a linha sign_and_send_pubkey: — ou a ausência dela — logo em seguida.
No more authentication methods to try. — o estado final. Todo método que o servidor permitiu foi esgotado, e a linha logo a seguir é Permission denied. Não leia esta linha como o erro; leia para cima a partir dela para achar a última tentativa real e por que ela falhou.
Um travamento em expecting SSH2_MSG_KEX_ECDH_REPLY — não é problema de autenticação nenhum. A resposta de troca de chaves do servidor é o primeiro pacote grande da conexão e, se ela nunca chega enquanto tudo antes dela funcionou, a causa clássica é um problema de MTU ou um middlebox mal-comportado — VPNs e alguns firewalls corporativos fragmentam ou descartam pacotes grandes. Teste a partir de outra rede ou sem a VPN; se conectar, ajuste o MTU em vez de ficar olhando para as chaves.
Unspecified GSS failure — ruído do Kerberos. O cliente tentou autenticação GSSAPI, você não está em um realm Kerberos, ela falhou e ele recuou para o próximo método. Se a conexão, no fim das contas, der certo ou falhar por causa de chaves, esta linha não teve parte nisso — ignore-a, a menos que você use Kerberos SSO de verdade.
connect to address ... port 22: Connection refused / Connection timed out — a conexão nunca aconteceu, então toda pergunta sobre autenticação é irrelevante. Refused significa que o host respondeu e nada está escutando; timed out significa silêncio no caminho. Duas investigações diferentes, nenhuma delas envolvendo chaves — o diagnóstico de dois minutos cobre os dois ramos.
O fluxo que encontra o problema rápido
Três hábitos transformam um paredão de texto de debug em uma leitura de dois minutos:
- Reproduza com o ruído removido.
ssh -vvv -o IdentitiesOnly=yes -i ~/.ssh/the_key user@hostoferece exatamente uma chave, então o rastro contém uma tentativa em vez de seis, e um type 51 só pode significar uma coisa. - Leia de baixo para cima. Ache a falha no fim e então suba até a última decisão antes dela — o último
Offering public key, a fronteira de fase que ela nunca cruzou. As primeiras trinta linhas de um rastro quase sempre estão saudáveis. - Veja quem definiu o quê. Quando o comportamento não bate com a sua intenção, as linhas
Reading configuration dataeApplying options forno topo nomeiam o arquivo e o bloco responsáveis. Metade dos casos de “o SSH está ignorando minhas flags” é um bloco de configuração vencendo em silêncio.
Menos rastros para ler, de saída
O rastro é a ferramenta certa quando algo quebra — mas boa parte do que ele revela é um estado que você não deveria ter de redescobrir: qual chave este host quer, qual usuário, qual porta. O Termalin guarda isso junto com o host salvo, então a chave certa é oferecida de propósito, em vez de ser a quarta na fila de um agente, e verifica a identidade de cada servidor na primeira conexão, com um aviso bem visível se a impressão digital mudar — a fase de chave de host, tratada deliberadamente. O status do host ao vivo responde “a máquina está sequer acessível?” antes de você conectar, o que elimina de uma vez o ramo refused/timed-out do rastro. O plano Free não tem limite de hosts — baixe o app e guarde o -vvv para os dias genuinamente estranhos.
O Termalin é um cliente SSH multiplataforma e gratuito que mantém portas, usuários, chaves e keepalives por host junto do host e verifica a identidade do servidor a cada conexão — baixe o app ou veja a lista completa de recursos.