Mensagens de erro do SSH na VPS (Connection refused, Permission denied e outras): o que significam

Quando o comando ssh root@<IP_DA_VPS> não entra, a mensagem que o terminal mostra diz em que etapa a conexão falhou: chegar até a VPS (rede, porta e firewall), provar quem você é (senha ou chave) ou confiar na identificação do servidor. As mensagens abaixo são as do OpenSSH, o cliente que vem no Linux, no Mac e no Windows 10 ou 11.

Para que serve

Cada etapa se resolve num lugar diferente. Erro de rede se resolve no painel (VPS ligada, IP certo, firewall); erro de autenticação, na senha root ou na chave; aviso de identificação, no arquivo known_hosts do seu computador. Ler a mensagem certa evita trocar a senha à toa ou mexer no firewall sem necessidade.

Erros para chegar até a VPS

Connection refused

• O que quer dizer: a VPS respondeu, mas nada está atendendo o SSH naquela porta. Mensagem típica: ssh: connect to host <IP_DA_VPS> port 22: Connection refused.
• Causas comuns: o serviço do SSH está parado, o SSH foi mudado para outra porta, a VPS está terminando de reiniciar ou uma regra de firewall rejeita a conexão.
• Para onde ir: "SSH dá "Connection refused" ou "Connection timed out" na VPS: o que fazer".

Connection timed out

• O que quer dizer: o pedido de conexão saiu do seu computador e não teve resposta. Mensagem típica: ssh: connect to host <IP_DA_VPS> port 22: Connection timed out (no Mac, Operation timed out).
• Causas comuns: VPS desligada, IP errado, firewall descartando a porta 22 ou bloqueio na rede de onde você está.
• Para onde ir: "SSH dá "Connection refused" ou "Connection timed out" na VPS: o que fazer".

No route to host

• O que quer dizer: o seu computador não achou caminho na rede até o IP. Mensagem típica: ssh: connect to host <IP_DA_VPS> port 22: No route to host.
• Causas comuns: IP digitado errado, VPS desligada, firewall que rejeita a conexão ou problema na rede local (VPN, Wi-Fi corporativo).
• Para onde ir: confira o IP em "Como ver os IPs e a rede da VPS pelo painel", teste de outra rede e siga "SSH dá "Connection refused" ou "Connection timed out" na VPS: o que fazer".

Connection closed by remote host

• O que quer dizer: a conexão chegou a abrir, mas a VPS a encerrou antes ou logo depois do login. Mensagens típicas: Connection closed by <IP_DA_VPS> port 22 ou Connection reset by peer.
• Causas comuns: proteção contra tentativas repetidas (como o fail2ban) bloqueou o seu IP por um tempo, limite de conexões simultâneas, disco da VPS cheio ou serviço do SSH com configuração inválida.
• Para onde ir: espere alguns minutos e tente de novo. Se continuar, entre pelo Console SSH do painel ("Como acessar sua VPS pelo Console SSH do painel") e confira o espaço em disco; veja "Disco cheio na VPS ("No space left on device"): o que fazer".

Erros de autenticação

Permission denied (password) ou Permission denied, please try again

• O que quer dizer: a VPS recusou a senha.
• Causas comuns: senha digitada errada (lembre que ela não aparece enquanto você digita), usuário errado ou senha root trocada.
• Para onde ir: "SSH dá "Permission denied" na VPS: o que fazer" e "Como redefinir a senha root da VPS pelo painel".

Permission denied (publickey)

• O que quer dizer: a VPS só aceita login por chave, e nenhuma chave oferecida pelo seu computador foi aceita.
• Causas comuns: login por senha desativado, chave errada, chave pública não copiada para a VPS ou usuário diferente do que tem a chave.
• Para onde ir: "SSH dá "Permission denied" na VPS: o que fazer" e "Como acessar a VPS por chave SSH em vez de senha, via SSH".

Too many authentication failures

• O que quer dizer: o seu computador ofereceu chaves demais antes da certa, e a VPS encerrou a tentativa. Mensagem típica: Received disconnect from <IP_DA_VPS> port 22:2: Too many authentication failures.
• Causas comuns: muitas chaves carregadas no agente SSH do seu computador.
• Para onde ir: indique a chave exata com ssh -i <CAMINHO_DA_CHAVE> -o IdentitiesOnly=yes root@<IP_DA_VPS>. Se entra por senha, use ssh -o PubkeyAuthentication=no root@<IP_DA_VPS>.

Avisos sobre a identificação do servidor

WARNING: REMOTE HOST IDENTIFICATION HAS CHANGED!

• O que quer dizer: a identificação (chave do servidor) que o seu computador guardou para aquele IP é diferente da que a VPS apresentou agora.
• Causas comuns: a VPS foi reinstalada ou o IP passou a ser de outra máquina. Raramente, pode ser alguém no meio da conexão.
• Para onde ir: "Aviso "REMOTE HOST IDENTIFICATION HAS CHANGED" ao acessar a VPS: o que fazer". Se você não reinstalou a VPS, não continue: fale com o Suporte antes.

Host key verification failed

• O que quer dizer: o SSH não conseguiu confirmar a identificação do servidor e parou a conexão. Costuma aparecer logo depois do aviso acima, ou quando a pergunta Are you sure you want to continue connecting não foi respondida com yes.
• Para onde ir: se veio junto com o aviso de identificação, siga o artigo dele. Se foi a primeira conexão, rode o comando de novo e responda yes.

Como funciona na StayCloud

Onde ficam os dados de acesso

O IP, o usuário (root), a porta (22) e a senha root ficam no painel, em Minhas VPS › sua VPS › Sistema › Acesso SSH, junto com o comando SSH pronto para copiar.

O acesso de emergência

O Console SSH do painel não passa pela rede da VPS. Por isso ele funciona mesmo quando o SSH pelo terminal dá Connection refused, Connection timed out ou quando uma regra de firewall bloqueou a porta 22.

Duas camadas de firewall

A porta do SSH precisa estar liberada no firewall do painel e, se você usa, no UFW dentro da VPS. Veja "Como criar uma regra de firewall na sua VPS pelo painel" e "Como liberar portas com o firewall UFW na VPS via SSH".

Em quais planos está disponível

Vale para todas as VPS da StayCloud. Na hospedagem de sites, o acesso SSH não vem liberado; para usar, peça a liberação ao Suporte, como explica "Como ver os dados de acesso da sua hospedagem".

Limites e cuidados

• Mantenha a senha root guardada: é por ela que a equipe da StayCloud consegue entrar na VPS quando você pede ajuda.
• Não apague o aviso de identificação sem saber o motivo: só remova a identificação antiga se você reinstalou a VPS ou trocou de IP.
• Tentativas repetidas podem bloquear o seu IP: se a VPS tem proteção contra força bruta, várias senhas erradas seguidas causam bloqueio temporário.

Documentação oficial

Manual do cliente SSH do OpenSSH: https://man.openbsd.org/ssh

Relacionados

• SSH dá "Connection refused" ou "Connection timed out" na VPS: o que fazer
• SSH dá "Permission denied" na VPS: o que fazer
• Aviso "REMOTE HOST IDENTIFICATION HAS CHANGED" ao acessar a VPS: o que fazer
• Como acessar sua VPS por SSH pelo terminal (Linux, Windows e Mac)
• Como acessar sua VPS pelo Console SSH do painel
• Como redefinir a senha root da VPS pelo painel
• Como acessar a VPS por chave SSH em vez de senha, via SSH
• Portas mais usadas na hospedagem, no e-mail e na VPS e para que servem