Tutoriais de VPS
Identificação SSH mudou: verifique o fingerprint antes de reconectar
Se o SSH avisa que a chave do host mudou, confira instância, IP e fingerprint no console do provedor antes de remover entradas antigas de known_hosts e reconectar.

O SSH mostra de repente WARNING: REMOTE HOST IDENTIFICATION HAS CHANGED! e termina com Host key verification failed. O servidor está apresentando uma chave de host diferente da salva pelo cliente. Reinstalar o VPS, mudar o IP ou restaurar um snapshot pode explicar isso, mas DNS incorreto ou uma conexão interceptada também gera o mesmo aviso. Verifique a identidade do servidor antes de atualizar o registro local. Não desative a verificação de chaves.
| Situação confirmada | Ação adequada |
|---|---|
| Você reinstalou o VPS e consegue verificar o novo fingerprint no console do provedor | Faça backup de known_hosts, remova apenas as entradas desse host e confira o fingerprint ao reconectar |
| Domínio ou IP mudou e pode apontar para outra máquina | Compare DNS, IP da instância e configuração SSH antes de alterar registros |
| Não houve mudança prevista ou os fingerprints não coincidem | Interrompa a conexão, preserve aviso e registros e investigue DNS, jump hosts e mudanças do provedor |
A chave de host não é sua chave privada de login SSH. Ela identifica o servidor para o cliente. Apagar uma entrada de known_hosts não altera suas chaves de login nem comprova que o novo servidor é confiável. O OpenSSH avisa para impedir falsificação de servidores e ataques de intermediário; veja o manual de ssh.
Se você usa um alias como ssh dev-vps, execute no computador local:
ssh -G dev-vps | grep -Ei '^(hostname|port|user|userknownhostsfile|hostkeyalias|proxyjump) '
Confira hostname, port, hostkeyalias e proxyjump. HostName pode ser domínio ou IP. Porta personalizada, jump host e UserKnownHostsFile separado afetam qual registro consultar. Compare com o IP da instância no console. Se usa domínio, confira o DNS atual; manter o mesmo nome não comprova que a máquina seja a mesma.
Use ssh-keygen -F para localizar registros, inclusive entradas de known_hosts com hash:
ssh-keygen -F example.com
ssh-keygen -F 203.0.113.10
Troque domínio e IP de exemplo pelos seus. Para uma porta como 2222, use a forma [主机]:端口 na busca e na remoção:
ssh-keygen -F '[example.com]:2222'
Offending ... key in ...known_hosts:17 no aviso indica uma possível entrada conflitante. Apagar manualmente a linha 17 pode remover outra entrada e não resolve duplicatas ou hashes. Prefira -F e -R do OpenSSH; o manual de ssh-keygen documenta hosts e portas personalizadas.
Abra o console web, VNC ou serial do provedor e confirme a instância. Esse acesso não depende da conexão SSH que falhou. No console do servidor, execute:
ssh-keygen -l -E sha256 -f /etc/ssh/ssh_host_ed25519_key.pub
SHA256:... é o fingerprint da chave pública de host ED25519 atual. Compare caractere por caractere com o fingerprint ED25519 do aviso ou da nova conexão. Se o cliente mostra ECDSA ou RSA, compare o mesmo tipo com /etc/ssh/ssh_host_ecdsa_key.pub ou /etc/ssh/ssh_host_rsa_key.pub. Algoritmos diferentes não têm fingerprints comparáveis. O manual de sshd informa os arquivos de chaves do servidor.
Um fingerprint fornecido pelo provedor também serve se corresponde à instância e ao tipo de chave atuais. Se você não consegue uma confirmação independente, escanear a rede não fornece essa prova.
Por exemplo, este comando coleta a chave apresentada na porta, mas não autentica o servidor:
ssh-keyscan -T 5 -p 22 -t ed25519 example.com 2>/dev/null | ssh-keygen -l -E sha256 -f -
Compare o resultado com o console ou outra fonte confiável antes de usá-lo. O manual de ssh-keyscan alerta que confiar em chaves coletadas sem verificação expõe a ataques de intermediário.
Execute no computador local, começando pelo backup:
cp -p ~/.ssh/known_hosts ~/.ssh/known_hosts.backup.$(date +%Y%m%d%H%M%S)
Se o arquivo não existe, a conta pode não usar o known_hosts padrão. Confira userknownhostsfile na saída de ssh -G e o arquivo indicado no aviso. Criar um arquivo vazio não resolve um conflito em outro local.
Para domínio na porta padrão 22:
ssh-keygen -R example.com
Se você também acessou diretamente pelo IP, remova sua entrada separadamente apenas depois de confirmar que é a mesma instância:
ssh-keygen -R 203.0.113.10
Para a porta 2222:
ssh-keygen -R '[example.com]:2222'
Se ssh -G ou o aviso apontam para arquivo personalizado, selecione-o com -f:
ssh-keygen -R example.com -f ~/.ssh/project_known_hosts
ssh-keygen -R remove entradas correspondentes ao host, inclusive com hash. É mais específico do que apagar todo o ~/.ssh/known_hosts. A condição continua sendo verificar independentemente o novo fingerprint e entender a mudança do host.
Para a porta padrão:
ssh -o StrictHostKeyChecking=ask [email protected]
Compare o aviso com o fingerprint obtido no console para o mesmo tipo de chave. Digite yes somente se forem idênticos. Depois do login, consulte o novo registro com ssh-keygen -F example.com. Para alias, porta especial ou jump host, mantenha o comando habitual verificado; não contorne o aviso usando um endereço ainda não conferido.
StrictHostKeyChecking=accept-new aceita automaticamente chaves de hosts novos, não chaves alteradas. StrictHostKeyChecking=no flexibiliza a verificação de mudanças e não é a correção adequada. Consulte o manual de ssh_config.
O sistema novo normalmente gera outras chaves, mas o cliente ainda guarda as anteriores. Lembrar da reinstalação explica uma possibilidade; não substitui a verificação. Confirme instância e fingerprint no console antes de remover registros.
Compare DNS e IP do provedor, depois confira HostName, ProxyJump e HostKeyAlias. Um domínio apontando para outro VPS apresenta outra chave, mas essa máquina também precisa de confirmação independente.
Essas ferramentas geralmente usam um cliente SSH. Reproduza no terminal local, confira o fingerprint e remova as entradas específicas antes de tentar novamente. Veja o guia do VS Code Remote SSH. Se o erro mudar para Permission denied (publickey), consulte configuração de login com chaves SSH.
Não digite yes nem desative a verificação. Preserve o aviso e confira instância, IP, DNS, jump host e configuração. Se necessário, pergunte ao provedor sobre migração ou troca de chaves. Continue apenas quando destino e fingerprint tiverem uma explicação verificável.
- Anote host, porta, tipo de chave e fingerprint do aviso.
- Confirme o destino com
ssh -G, console e DNS. - Obtenha no console o fingerprint atual do mesmo tipo de chave.
- Depois de confirmar fingerprint e motivo, faça backup de
known_hostse remova o host comssh-keygen -R. - Compare novamente ao reconectar e só então faça login.
A ordem é verificar a identidade, remover registros antigos e reconectar. Ela resolve mudanças esperadas após reinstalar o VPS e mantém a proteção de identidade do SSH.