Como solucionar erros de acesso ao SSH

O SSH (Secure Shell) é um protocolo essencial para acessar servidores de forma remota e segura. Ele é amplamente utilizado por administradores de sistemas, desenvolvedores e até usuários que precisam gerenciar suas aplicações diretamente no servidor.

Apesar de ser confiável, erros de conexão SSH são comuns e podem acontecer tanto por problemas simples, como credenciais incorretas, quanto por configurações avançadas, como firewall ou permissões de arquivos.

Neste guia, você aprenderá a identificar e corrigir os principais erros de acesso ao SSH:

• Conexão Recusada (Connection Refused)
• Permissão Negada (Permission Denied)
• Conexão Expirada (Connection Timed Out)
• Conexão Encerrada (Connection Closed)
• Processos Finalizados (Killed Processes)

Conexão Recusada (Connection Refused)  

Esse erro acontece quando o servidor não está aceitando conexões na porta SSH especificada, com a mensagem: "ssh: connect to host [servidor] port [porta] Connection refused"

Confira como corrigir: 

1Verifique se o SSH está habilitado na hospedagem/servidor - Confira como habilitar o acesso SSH

2Confirme a porta correta:

• Planos compartilhados (Start, P, M, Turbo, Business, Plus ou Revendas): Use 2222
• Servidores VPS Linux, VPS n8n e Dedicado Linux: Use 22 ou 22022

3Confira se a porta está liberada no firewall, para isso, digite o comando:

sudo firewall-cmd --list-ports 
sudo firewall-cmd --add-port=22022/tcp --permanent 
sudo firewall-cmd --reload

4Certifique-se de estar usando o IP do servidor corretos - Confira como localizar o IP

Permissão Negada (Permission Denied)

Esse erro indica que as credenciais (usuário/senha ou chave SSH) estão incorretas ou não têm permissão de acesso, com as mensagens: “Permission denied, please try again" ou "Permission denied (publickey"

Confira como resolver:

1Revise as credenciais de acesso de acordo a seu plano/servidor:

• Usuário:
  • Servidores VPS Linux, VPS n8n e Dedicado Linux: root
  • Planos compartilhados (Start, P, M, Turbo, Business, Plus ou Revendas):  use o usuário cPanel - Se necessário, confira quais são os dados
• Senha:
  • Planos compartilhados (Start, P, M, Turbo, Business, Plus ou Revendas): insira a senha do cPanel
  • Servidores VPS e Dedicado: insira a senha root 

2Redefina a senha SSH:

• Planos compartilhados (Start, P, M, Turbo, Business, Plus ou Revendas): confira como alterar a senha
• Servidores VPS e Dedicado: confira como alterar a senha

Se necessário, confira como gerar chaves de acesso SSH no cPanel

Conexão Expirada (Connection Timed Out)

Esse erro ocorre quando a tentativa de conexão não chega dentro do tempo limite especificad, com a mensagem: "ssh: connect to host [servidor] port [porta]: Connection timed out"

Confira como resolver:

• Problemas de rede local - Reinicie o roteador e confirme se há conexão com a internet.
• Ajustar o tempo limite: aumente o tempo limite da conexão SSH, usando dentro do terminal o comando “– o”:

ssh -o ConnectTimeout=60 usuario@ipservidor

Substituía usuario@ipservidor pelas credenciais reais  

• Conflitos em firewall ou antivírus locais - No seu computador desative o firewall temporariamente para testar.
  • Windows: Desabilitar Windows Defender Firewall temporariamente
  • Mac: Procure por “System Preferences” depois clique em Security & Privacy e em seguida, Firewall
• Servidor fora do ar ou em manutenção - Confira o status de nossos serviços

Conexão Encerrada (Connection Closed)

Ocorre quando o servidor fecha a conexão após a tentativa de autenticação, o problema geralmente está na configuração do acesso, com a mensagem: "Connection closed by [servidor]" ou terminal fecha imediatamente

Confira como resolver:

1Confirme que o SSH está habilitado no painel de hospedagem/servidor - Se necessário, confira como habilitar o acesso SSH

2Verifique que este usando as credenciais de acesso corretas: 

• IP do servidor: Confirmar se está correto – Confira como localizar o IP
• Usuário:
  • Servidores VPS Linux, VPS n8n e Dedicado Linux: root
  • Planos compartilhados (Start, P, M, Turbo, Business, Plus ou Revendas):  use o usuário cPanel - Se necessário, confira quais são os dados
• Senha:
  • Planos compartilhados (Start, P, M, Turbo, Business, Plus ou Revendas): insira a senha do cPanel - Se necessário, redefina no painel do cPanel, confira como fazer
  • Servidores VPS e Dedicado: insira a senha root - Se necessário, redefina ela, confira como fazer
• Porta:
  • Planos compartilhados (Start, P, M, Turbo, Business, Plus ou Revendas): Use 2222
  • Servidores VPS Linux, VPS n8n e Dedicado Linux: Use 22 ou 22022

Processos Finalizados (Killed Processes)  

Em hospedagens compartilhadas, cada comando SSH consome recursos do plano. 
Se não houver recursos suficientes, o processo será encerrado.

Confira como resolver:

• Verifique o histórico de uso no painel.
• Considere atualizar seu plano ou migrar para um VPS, que permite maior autonomia.