Como corrigir o erro 'Permission denied (publickey)' ao tentar conectar via SSH

Como corrigir o erro 'Permission denied (publickey)' ao tentar conectar via SSH

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

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

Permission denied (publickey)

Não se preocupe — isso é um erro comum, mas muito fácil de resolver! Vamos juntos, passo a passo, como corrigir isso com calma, paciência e um toque de "Sensei" (sim, eu sou seu guia nesta jornada digital! 🌟).

---

🔍 O que significa esse erro?

Esse erro acontece quando o servidor não aceita sua chave de autenticação (chave pública). Ou seja: o servidor está esperando uma chave que você não enviou ou que está incorreta.

Isso pode acontecer por vários motivos, mas os mais comuns são:

• Chave pública não cadastrada no servidor;
• Chave privada incorreta ou com permissões erradas;
• Usuário ou porta incorretos na conexão;
• Problema no arquivo de configuração do SSH.

---

🛠️ Passo a passo para resolver

Vamos corrigir isso com calma. Siga cada etapa com atenção — cada detalhe importa!

1. Verifique se você tem a chave pública cadastrada no servidor

Na GeHost, o acesso via SSH é feito com chave pública. Você precisa ter adicionado sua chave pública no painel do cPanel.

2. Entre no painel do cliente

Visite: painel.gehost.com.br

3. Abra o cPanel

No painel, clique em cPanel (geralmente no menu principal).

4. Encontre a ferramenta "SSH Access"

No cPanel, procure por SSH Access na seção "Segurança".



5. Adicione sua chave pública

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

Se você já tiver uma chave, clique em Import Key. Se não tiver, crie uma (veja abaixo).

6. Copie sua chave pública

Se você não tem certeza de qual é sua chave pública, abra o arquivo id_rsa.pub (ou id_ed25519.pub) no seu computador. Ele está geralmente em:

• Linux/Mac: ~/.ssh/id_rsa.pub
• Windows (com Git Bash ou WSL): C:\Users\SeuNome\.ssh\id_rsa.pub

Copie todo o conteúdo do arquivo, incluindo ssh-rsa ou ssh-ed25519 no início e o endereço no final.

7. Coloque a chave no cPanel

Na tela de Manage SSH Keys, clique em Import Key, cole sua chave pública no campo Key e dê um nome (ex: "minha_chave").

8. Verifique as permissões da chave privada

Seu arquivo de chave privada (ex: id_rsa) precisa ter permissões restritas. No terminal (Linux/Mac), execute:

chmod 600 ~/.ssh/id_rsa

No Windows (via Git Bash), use:

chmod 600 C:\Users\SeuNome\.ssh\id_rsa

9. Conecte-se novamente via SSH

Abra seu terminal ou cliente SSH (como PuTTY ou VS Code) e tente conectar novamente com o comando:

ssh -i ~/.ssh/id_rsa usuario@servidor

Substitua usuario pelo seu usuário do cPanel (geralmente o nome da conta) e servidor pelo endereço fornecido no painel (ex: ssh.gehost.com.br).

10. Se ainda não funcionar, verifique o nome do usuário e o servidor

Confira no painel do cliente (em Informações da Conta) o nome do usuário SSH e o endereço do servidor. Pode haver um erro de digitação!

11. Se tudo falhar, peça ajuda ao suporte

Se você seguiu todos os passos e ainda não consegue conectar, entre em contato com o Suporte da GeHost. Informe:

• O nome da conta;
• Se a chave pública foi cadastrada;
• O erro exato que está aparecendo.

O suporte está disponível por 30 dias após a entrega — aproveite esse tempo! 🌟

---

💡 Dicas importantes (para não errar)

• Nunca use a senha do cPanel no SSH — ele só aceita chaves públicas, não senhas.
• Evite usar nomes genéricos como "chave1" — use algo como "meu_site_producao" para facilitar a identificação.
• Se criar uma nova chave, não a perca! Ela é essencial para acessar o servidor.
• Se você está usando Windows, use o Git Bash ou WSL para gerar as chaves — o PowerShell não é muito confiável nesse caso.

---

🔐 Quer gerar uma chave nova?

Se você não tem uma chave SSH, execute no terminal:

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

Depois, siga os passos acima para importar a chave pública no cPanel.

---

📞 Precisa de ajuda?

Estamos aqui para você! 💬

Entre em contato com o Suporte da GeHost pelo painel do cliente. Lembre-se: o suporte está disponível por 30 dias após a entrega — aproveite esse tempo!

Se precisar de um passo a passo com imagens, pedimos desculpas, mas no momento não temos um print específico para esse fluxo. Mas não se preocupe — você está com o Sensei da GeHost! 🙏

Com carinho,
Seu amigo da GeHost
— Raphael Neves Koga (donor) & equipe
G e Soluções e Eventos LTDA (CNPJ: 46.647.904/0001-04)