termal.in

← Blog

Como ler a saída do ssh -vvv: as linhas de debug que realmente importam

· atualizado 29 de set. de 2026 · Termalin Team sshtroubleshootingdebuggingtutorial

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

  • -v imprime as linhas debug1: 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.
  • -vv acrescenta o debug2: os detalhes da negociação — listas completas de algoritmos dos dois lados, a decisão tomada chave por chave.
  • -vvv acrescenta o debug3: o rastro no nível de pacote, incluindo as linhas send 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:

  1. Reproduza com o ruído removido. ssh -vvv -o IdentitiesOnly=yes -i ~/.ssh/the_key user@host oferece exatamente uma chave, então o rastro contém uma tentativa em vez de seis, e um type 51 só pode significar uma coisa.
  2. 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.
  3. Veja quem definiu o quê. Quando o comportamento não bate com a sua intenção, as linhas Reading configuration data e Applying options for no 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.

Experimente em um host.

Termalin é um cliente SSH rápido para você — e para seus agentes.

Plano gratuito · 14 dias de Pro grátis · preços

Adicionar o Termalin como fonte preferida no Google