Erro 'Permission denied (publickey)' ao conectar via SSH — como resolver Print

Erro 'Permission denied (publickey)' ao conectar via SSH — Como resolver (Guia para Iniciantes)

Olá, querido(a) cliente da GeHost! 😊

Se você está tentando se conectar ao seu servidor via SSH e está recebendo a mensagem:

Permission denied (publickey)

Calma! Esse erro é mais comum do que parece — e tem uma solução simples, mesmo que você nunca tenha usado SSH antes. Vamos resolver isso juntos, passo a passo, como se fosse um pequeno ritual de conexão com seu servidor. 🌟

O que significa esse erro?

Quando o sistema diz "Permission denied (publickey)", ele está dizendo:

“Você tentou se conectar com uma chave pública, mas ela não é reconhecida pelo servidor.”

Isso geralmente acontece por um dos seguintes motivos:

• Você não gerou as chaves SSH corretamente.
• A chave pública não foi adicionada ao servidor.
• O arquivo de chave está com permissões incorretas.
• Você está tentando usar uma chave que não foi configurada no servidor.

Não se preocupe — vamos consertar isso juntos, com calma e paciência. Você já está no caminho certo!

Passo a passo: Como resolver o erro

1. Verifique se você tem uma chave SSH gerada

   Se você nunca usou SSH antes, provavelmente não tem as chaves. Abra o terminal (no Linux/Mac) ou o Git Bash (no Windows) e digite:

   ssh-keygen -t ed25519 -C "seu_email@exemplo.com"
       

   Pressione Enter em todas as perguntas. Isso criará duas chaves:

   • id_ed25519 — sua chave privada (não compartilhe!)
   • id_ed25519.pub — sua chave pública (você pode compartilhar essa)

2. Copie a chave pública para o servidor

   Use o comando:

   cat ~/.ssh/id_ed25519.pub
       

   Isso mostrará o conteúdo da chave pública. Copie tudo que aparecer (incluindo ssh-ed25519 no início e seu email no final).

3. Adicione a chave pública ao servidor via cPanel

   Entre no cPanel da sua conta na GeHost:

   

   Depois de logado, procure por “SSH Access” (geralmente no grupo “Advanced”):

   

   Na tela de SSH Access, clique em “Manage SSH Keys”.

   Clique em “Import Key” (ou “Adicionar Chave”), cole a chave pública que você copiou (o conteúdo do arquivo .pub) e salve.

4. Verifique as permissões do arquivo de chave

   Se você estiver usando um sistema Linux ou Mac, certifique-se de que as permissões estão corretas. No terminal, execute:

   chmod 600 ~/.ssh/id_ed25519
   chmod 644 ~/.ssh/id_ed25519.pub
       

   Isso garante que apenas você possa ler a chave privada.

5. Tente se conectar novamente

   Use o comando:

   ssh -i ~/.ssh/id_ed25519 seu_usuario@seu_servidor
       

   Substitua seu_usuario e seu_servidor pelos dados corretos da sua conta (geralmente são fornecidos no painel da GeHost).

   Se tudo estiver certo, você será conectado com sucesso! 🎉

Dicas importantes (para não errar)

• Nunca compartilhe sua chave privada (id_ed25519). Ela é como sua senha de acesso.
• Se o erro persistir, verifique se a chave pública foi importada corretamente no cPanel.
• Se estiver usando um cliente como Putty (no Windows), você precisa converter a chave para formato PPK — mas recomendamos usar o terminal nativo ou o Git Bash.
• Se precisar, peça suporte na GeHost — nós estamos aqui para ajudar! 🤝

Conclusão

Erro “Permission denied (publickey)” não é um desastre — é um sinal de que algo está faltando na conexão. Com um pouco de atenção, você consegue resolver em poucos minutos.

Lembre-se: cada chave SSH é como uma chave mágica. Use-a com cuidado, guarde-a bem, e o servidor vai abrir as portas para você. ✨

Se precisar de ajuda, estamos aqui. A GeHost cuida de você, sempre. 💙