Ir para o conteúdo
Promovaweb

Diagnostique uma conexão SSH no Tailscale

Revisado em

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:

Terminal
ssh -v usuario@nome-da-vps

Adapte 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:

Terminal
sudo ss -lntp

Se 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.