Documentação
Solução de Problemas
Erros comuns e como corrigi-los — conexão, autenticação, monitoramento, cofre.
Conexão
Conexão Recusada
O servidor está recusando no nível de rede — ainda nem chegou na autenticação. Verifique nesta ordem:
# 1. O host está acessível
ping <host>
# 2. A porta SSH está realmente aberta
nc -vz <host> 22
Causas comuns: porta errada (muitos hosts mudam da 22 para outra), um firewall ou
security group bloqueando seu IP, ou o sshd não estar rodando.
Conexão Trava e Depois Dá Timeout
Pacotes saem e nada volta — geralmente um firewall que descarta (drop) em vez de rejeitar. Se você está numa VPN, verifique ela primeiro.
Chave do Host Não Confere
O app interrompe a conexão e mostra as duas impressões digitais. Não ignore por reflexo.
Uma chave de host muda por dois motivos bem diferentes: o servidor foi reinstalado (normal), ou alguém está no meio da sua conexão (anormal). Confirme por outro canal — o console do provedor, um colega que acabou de reinstalar a máquina — antes de escolher Forget host key e reconectar para confiar na nova chave.
Autenticação
Senha Errada ou Chave Rejeitada
-
Para uma chave SSH: você colou a chave privada, não o arquivo
.pub? Se ela tem passphrase, você digitou? -
A chave pública correspondente está mesmo em
~/.ssh/authorized_keysda conta certa no servidor? -
Verifique as permissões dos arquivos no servidor — a causa mais esquecida:
chmod 700 ~/.ssh chmod 600 ~/.ssh/authorized_keys -
O servidor sequer permite login por senha? Muitas instalações vêm com
PasswordAuthentication nopor padrão.
Os logs do lado do servidor dizem exatamente o motivo:
sudo journalctl -u sshd -n 50
Monitoramento
Ativado, Mas Ainda Sem Dados
- O cofre está bloqueado? O polling precisa de credenciais; um cofre bloqueado interrompe todas as tarefas — confira a barra de status.
- Ainda não chegou a vez. As tarefas começam em cerca de 15 segundos, e a primeira amostra aparece depois do primeiro poll bem-sucedido. Clique em Poll now para pular a espera.
- Uma credencial de monitoramento foi realmente selecionada? É um campo separado da credencial padrão da VM.
Faltando o Percentual de CPU ou a Taxa de Rede
Os dois são derivados entre dois polls. O primeiro poll não tem nada para comparar, então esses dois campos ficam vazios até o segundo chegar.
Marcada Como Inacessível, Mas o SSH Manual Funciona
Um poll é descartado se não responder em 20 segundos. Uma máquina muito carregada pode ultrapassar isso enquanto uma sessão interativa ainda parece normal. Verifique a carga, e aumente o intervalo de poll se o host for naturalmente lento.
Cofre
Pede a Senha Toda Vez Que o App Abre
O chaveiro do SO não está disponível. No Linux, isso significa que nenhum Secret Service (GNOME Keyring, KWallet) está rodando e desbloqueado. Também é esperado se você clicou em Lock vault da última vez.
Esqueci a Senha Mestra
Não pode ser recuperada, por design. Veja Cofre de Senhas → Esqueci a Senha Mestra.
Troca de Senha Interrompida
A troca da senha mestra roda dentro de uma transação. Se for interrompida, a transação é revertida e o cofre permanece no estado anterior — desbloqueie com a senha antiga e tente de novo.
Ainda com Problemas?
Inclua isto ao mandar um e-mail para o suporte — é o que decide se a resposta leva cinco minutos ou cinco dias:
- versão do app e do SO,
- o que você fez e o que aconteceu,
- a mensagem de erro, literal,
- a distribuição Linux do servidor, se o problema for desse lado.
Não inclua chaves privadas, senhas ou o conteúdo de
authorized_keys. Nenhuma parte do suporte precisa disso.