Documentation
Dépannage
Erreurs courantes et comment les résoudre — connexion, authentification, surveillance, coffre.
Connexion
Connexion refusée
Le serveur refuse au niveau réseau — pas encore l’authentification. Vérifiez dans l’ordre :
# 1. L'hôte est-il joignable
ping <host>
# 2. Le port SSH est-il réellement ouvert
nc -vz <host> 22
Causes courantes : mauvais port (de nombreux hôtes déplacent le port 22), un pare-feu ou un groupe
de sécurité bloquant votre IP, ou sshd qui n’est pas en cours d’exécution.
La connexion reste bloquée puis expire
Les paquets partent sans rien recevoir en retour — généralement un pare-feu qui abandonne au lieu de rejeter. Si vous êtes sur un VPN, vérifiez-le en premier.
Incompatibilité de clé d’hôte
L’application s’arrête et affiche les deux empreintes. Ne rejetez pas cet avertissement par réflexe.
Une clé d’hôte change pour deux raisons très différentes : le serveur a été réinstallé (normal), ou quelqu’un se trouve au milieu de votre connexion (anormal). Confirmez via un canal séparé — la console du fournisseur, un collègue qui vient de réinstaller la machine — avant de choisir Oublier la clé d’hôte et de reconnecter pour faire confiance à la nouvelle.
Authentification
Mot de passe erroné ou clé rejetée
-
Pour une clé SSH : avez-vous collé la clé privée, pas le fichier
.pub? Si elle a une phrase de passe, l’avez-vous saisie ? -
La clé publique correspondante est-elle réellement présente dans
~/.ssh/authorized_keyspour le bon compte sur le serveur ? -
Vérifiez les permissions de fichiers côté serveur — la cause la plus souvent oubliée :
chmod 700 ~/.ssh chmod 600 ~/.ssh/authorized_keys -
Le serveur permet-il seulement la connexion par mot de passe ? De nombreuses installations ont par défaut
PasswordAuthentication no.
Les journaux côté serveur vous disent exactement pourquoi :
sudo journalctl -u sshd -n 50
Surveillance
Activée mais pas encore de données
- Le coffre est-il verrouillé ? L’interrogation a besoin d’identifiants ; un coffre verrouillé arrête toutes les tâches — vérifiez la barre de statut.
- Ce n’est pas encore son tour. Les tâches démarrent en environ 15 secondes, et le premier échantillon apparaît après le premier sondage réussi. Appuyez sur Sonder maintenant pour sauter l’attente.
- Un identifiant de surveillance est-il réellement sélectionné ? C’est un champ distinct de l’identifiant par défaut de la VM.
Pourcentage CPU ou débit réseau manquant
Les deux sont dérivés entre deux sondages. Le premier sondage n’a rien avec quoi se comparer, donc ces deux champs sont vides jusqu’à ce que le second arrive.
Marquée inaccessible, mais le SSH manuel fonctionne toujours
Un sondage est abandonné s’il ne répond pas dans les 20 secondes. Une machine fortement chargée peut dépasser ce délai alors qu’une session interactive semble toujours normale. Vérifiez la charge, et augmentez l’intervalle de sondage si l’hôte est simplement naturellement lent.
Coffre
Le mot de passe est demandé à chaque ouverture de l’application
Le trousseau de l’OS n’est pas disponible. Sous Linux, cela signifie qu’aucun Secret Service (GNOME Keyring, KWallet) n’est en cours d’exécution et déverrouillé. C’est aussi normal si vous avez appuyé sur Verrouiller le coffre la dernière fois.
Mot de passe maître oublié
Ne peut pas être récupéré, par conception. Voir Coffre de mots de passe → Mot de passe maître oublié.
Changement de mot de passe interrompu
Le changement du mot de passe maître s’exécute dans une transaction. S’il est interrompu, la transaction est annulée et le coffre reste dans son ancien état — déverrouillez avec l’ancien mot de passe et réessayez.
Toujours bloqué ?
Incluez ces éléments lorsque vous écrivez au support — ils déterminent si la réponse prend cinq minutes ou cinq jours :
- version de l’application et OS,
- ce que vous avez fait et ce qui s’est passé,
- le message d’erreur, textuel,
- la distribution Linux du serveur, si le problème vient de ce côté.
N’incluez pas de clés privées, de mots de passe, ni le contenu de
authorized_keys. Aucune partie du support n’en a besoin.