Diagnostique uma conexão SSH no Tailscale
Antes de começar
Separe timeout, conexão recusada e erro de autenticação no SSH pela tailnet. Confira serviço, porta e política antes de alterar o acesso ao servidor.
- Destino, usuário local e porta SSH confirmados.
- Console alternativo ao servidor e identificação do tipo de SSH utilizado.
Sintomas
- SSH expira sem conectar.
- Connection refused ou Permission denied.
Guarde a mensagem completa do SSH e identifique se o destino usa SSH convencional ou Tailscale SSH. Os dois modelos usam a rede privada, mas autorizam a sessão de formas diferentes.
Se houver timeout
Confira se o destino está online e se o endereço pertence à máquina correta. Teste o caminho com tailscale ping. Depois, revise a permissão para a porta SSH e o firewall do destino.
Uma resposta no teste do caminho Tailscale não comprova que a porta da aplicação está permitida. Preserve a separação entre diagnóstico de transporte e abertura da sessão.
Se a conexão for recusada
No console do servidor, confira qual serviço atende a porta e em qual interface ele escuta. No SSH convencional, a porta pode ter sido alterada. Use a mesma porta na chamada do cliente.
Não reinicie o servidor inteiro antes de verificar o processo e seus registros. Uma aplicação parada pode ser corrigida sem interromper os demais serviços.
Se aparecer Permission denied
No SSH convencional, confira usuário, chave selecionada e permissões dos arquivos de autenticação. Use ssh -v para obter mais detalhes, removendo informações privadas antes de compartilhar a saída.
No Tailscale SSH, confira a identidade da origem, o destino da autorização, o usuário local permitido e a exigência do modo check. Uma mudança de dispositivo pessoal para tag pode alterar a autorização aplicável.
Capture a etapa exata da falha
No computador cliente, execute o SSH convencional com mensagens adicionais:
ssh -v usuario@nome-da-vpsAdapte usuário, destino e porta. A saída permite distinguir resolução do nome, abertura da conexão e tentativa de autenticação. Antes de compartilhá-la, retire nomes privados, endereços e caminhos que identifiquem seu ambiente. Mantenha a chave privada no cliente, fora dos registros compartilhados.
No console de um servidor Linux, consulte as portas TCP em escuta:
sudo ss -lntpSe a porta esperada não aparecer, confira o serviço SSH e sua configuração. Se aparecer apenas em uma interface diferente, investigue a escuta antes de alterar a política de rede. O nome da unidade systemd pode variar entre distribuições.
Uma advertência sobre mudança da chave do host exige comparação por um acesso confiável. Não apague o arquivo known_hosts inteiro. Quando o destino usa Tailscale SSH, confira também o usuário local autorizado e a confirmação exigida pelo modo check, descritos no guia específico.
Se a chave do host mudou
Confirme pelo console ou por um canal já conhecido se a mudança é esperada. Não apague automaticamente a entrada de known_hosts apenas para eliminar o aviso. Depois de confirmar o servidor, atualize o registro correspondente e abra uma nova sessão.
Confira o resultado
Uma nova sessão abre com o usuário correto. A correção corresponde ao erro observado sem desativar a conferência da chave do host.
Fontes e conferência
Procedimento revisado a partir da documentação oficial em 2 de novembro de 2026. Não executado em uma tailnet de laboratório nesta edição.
