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

Como resolver o erro 'Permission denied (publickey)' ao 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 é bem comum, especialmente para quem está começando com SSH. Vamos resolver isso juntos, passo a passo, com calma e cuidado. Você não está sozinho(a) nessa jornada!

O que significa esse erro?

Esse erro aparece quando o servidor está esperando uma chave pública SSH para autorizar seu acesso, mas ela não foi encontrada ou não está correta. Ou seja: o servidor diz: “Você me enviou uma senha, mas eu esperava uma chave. Desculpe, não posso te deixar entrar.”

Dica da Sensei: O SSH é como uma porta de entrada com senha especial. Se você não tiver a chave certa (ou se ela não estiver configurada direitinho), a porta não abre. Vamos consertar isso!

Passo a passo: Como resolver

1. Verifique se você tem uma chave SSH

   Antes de tudo, confira se você já criou uma chave SSH no seu computador. Se você nunca fez isso, vamos criar uma agora.

   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 para aceitar o local padrão (geralmente ~/.ssh/id_ed25519). Você pode deixar a senha vazia (ou criar uma, se quiser mais segurança).

2. Verifique se a chave pública está no servidor

   Depois de criar a chave, você precisa copiar a chave pública (arquivo id_ed25519.pub) para o servidor. A chave pública é o que o servidor precisa para te reconhecer.

   Abra o arquivo id_ed25519.pub com um editor de texto (como o Bloco de Notas ou VS Code) e copie todo o conteúdo — ele começa com ssh-ed25519 e tem muitos caracteres.

3. Adicione a chave pública no cPanel (via SSH Keys)

   Entre no painel do cliente da GeHost: painel.gehost.com.br

   Depois de logar, acesse o cPanel do seu domínio.

   

   No cPanel, procure pela ferramenta SSH Access (geralmente no grupo “Segurança”).

   

   Clique em Manage SSH Keys (Gerenciar Chaves SSH).

   Na nova tela, clique em Import Key (Importar Chave).

   Na caixa de texto Public Key, cole a chave pública que você copiou antes.

   Nomeie a chave (ex: "Meu Laptop") e clique em Import.

4. Verifique se a chave está ativa

   Depois de importar, você deve ver a chave na lista. Certifique-se de que ela está marcada como Active (ativa).

   Se não estiver, clique no ícone de ativação (geralmente um ícone de chave verde).

5. Conecte-se novamente via SSH

   Volte ao terminal e tente conectar novamente com o comando:

   ssh usuario@seu-servidor.com.br

   Substitua usuario pelo seu nome de usuário no servidor (geralmente o nome da conta no cPanel) e seu-servidor.com.br pelo domínio ou IP do servidor.

   Se tudo estiver certo, você será conectado sem pedir senha!

Erros comuns e como evitar

• Chave pública não copiada corretamente: Verifique se você copiou todo o conteúdo, desde ssh-ed25519 até o final da linha. Não deixe espaços extras.
• Chave não importada no cPanel: Se você criou a chave, mas não a importou no servidor, o erro persistirá.
• Permissões incorretas no servidor: A pasta .ssh no servidor precisa ter permissões corretas. Isso é feito automaticamente pelo cPanel, mas se tiver dúvidas, entre em contato com o suporte.

Atenção da Sensei: Se você não tiver certeza sobre como criar ou usar chaves SSH, não se preocupe. O suporte da GeHost está aqui para te ajudar. Basta entrar em contato no nosso canal de suporte e pedir ajuda com “configuração de SSH com chave pública”.

Resumo em 3 passos

1. Crie uma chave SSH no seu computador (com ssh-keygen).
2. Copie a chave pública e importe no cPanel, na seção SSH Access.
3. Tente conectar novamente — e agora, com sucesso! 🎉

Se ainda tiver dúvidas, lembre-se: você não está sozinho. A GeHost está aqui com você, com um coração de tecnologia e um espírito de ajuda. 💚

Com carinho,
Sensei da GeHost
Grupo: G e Soluções e Eventos LTDA (entexp.com.br)
Dono: Raphael Neves Koga (desde 2015)