Quand SSH échoue, l’erreur de la dernière ligne est en général un résumé, pas un diagnostic — Permission denied (publickey) vous donne l’issue d’une négociation, pas l’endroit où elle a dérapé. La véritable histoire est dans ssh -vvv, et c’est pourquoi on finit par coller des fragments bruts comme debug3: receive packet: type 51 dans un moteur de recherche. Pas besoin de connaître le protocole par cœur pour lire cette trace. Il faut connaître la poignée de lignes qui répondent à de vraies questions, et savoir lesquelles sont du bruit.
Ceci est un guide de lecture : ce qu’ajoute chaque niveau de -v, les phases que vous verrez dans l’ordre, et un décodeur pour les lignes sur lesquelles il vaut la peine de s’arrêter. (Pour les erreurs elles-mêmes — refusée, expirée, avertissements de clé d’hôte — les correctifs sont dans la grille de décodage.)
Ce qu’ajoutent réellement -v, -vv et -vvv
-vaffiche les lignesdebug1: le récit de haut niveau. Quels fichiers de configuration ont été lus, où ça se connecte, ce que le serveur a proposé, quelles clés ont été essayées, quelle méthode d’authentification l’a emporté. Pour la plupart des problèmes, cela suffit.-vvajoutedebug2: les détails de la négociation — listes complètes d’algorithmes des deux côtés, décisions clé par clé.-vvvajoutedebug3: la trace au niveau des paquets, y compris les lignessend packet: type N/receive packet: type N. C’est le niveau qui nomme les numéros de message du protocole, et d’où proviennent les mystérieuses lignes que l’on cherche en ligne.
Commencez par -v. Passez à -vvv quand le récit de -v s’arrête brusquement et que vous avez besoin de voir le paquet exact où tout s’est éteint.
Les phases, dans l’ordre où vous les verrez
Toute connexion réussie suit le même chemin, et la sortie de débogage le suit aussi. Connaître les phases permet de dire où un échec s’est produit avant même de comprendre ce qui a échoué.
1. Configuration. Les premières lignes sont Reading configuration data /home/you/.ssh/config et .../etc/ssh/ssh_config, suivies de Applying options for <pattern> pour chaque bloc Host qui a correspondu. Si SSH utilise un port, un utilisateur ou une clé auxquels vous ne vous attendiez pas, le coupable est nommé ici même — un bloc que vous aviez oublié s’applique. (Ce qui a sa place dans ce fichier, et comment fonctionne la correspondance : le guide de ~/.ssh/config (en anglais).)
2. Connexion TCP. Connecting to host [1.2.3.4] port 22. puis Connection established. Si vous voyez à la place connect to address ... Connection refused ou Connection timed out, arrêtez de lire — rien après ce point n’a d’importance, car il n’y a pas d’« après ». Voir plus bas.
3. Échange de versions. Local version string SSH-2.0-OpenSSH_... et Remote protocol version 2.0, remote software version ... — les deux extrémités se présentent en clair. Surtout utile pour repérer des serveurs antédiluviens et confirmer que vous avez bien atteint un sshd.
4. Échange de clés et clé d’hôte. SSH2_MSG_KEXINIT sent / received, puis les algorithmes retenus (kex: algorithm: ..., kex: host key algorithm: ...), puis la clé d’hôte du serveur est vérifiée par rapport à votre known_hosts : Host 'x' is known and matches the ED25519 host key / Found key in ~/.ssh/known_hosts:12. Une non-concordance s’interrompt ici avec la grande bannière d’avertissement.
5. Authentification. Authentications that can continue: publickey,password est le serveur qui énumère ce qu’il acceptera. Ensuite, le client parcourt les méthodes et les clés, une tentative à la fois, jusqu’à ce que quelque chose réussisse — ou que rien ne réussisse. C’est dans cette phase que se fait l’essentiel de la lecture, elle a donc droit à son propre décodeur.
Une trace annotée, du début à la fin
Voici une exécution -vvv réelle (abrégée) de l’échec le plus recherché — Permission denied (publickey) — avec les lignes qui comptent signalées. Chaque phase ci-dessus apparaît dans l’ordre :
$ ssh -vvv deploy@203.0.113.10
OpenSSH_9.6p1, OpenSSL 3.0.13
debug1: Reading configuration data /home/you/.ssh/config
debug1: /home/you/.ssh/config line 12: Applying options for 203.0.113.10 # ← un bloc Host a correspondu ; suspectez-le si l’utilisateur/la clé/le port est erroné
debug1: Connecting to 203.0.113.10 [203.0.113.10] port 22.
debug1: Connection established. # ← le TCP est établi : refusée / expirée est écarté ici
debug1: Local version string SSH-2.0-OpenSSH_9.6
debug1: Remote protocol version 2.0, remote software version OpenSSH_8.9p1 # ← vous avez atteint un vrai sshd
debug1: SSH2_MSG_KEXINIT sent
debug1: SSH2_MSG_KEXINIT received
debug1: kex: algorithm: curve25519-sha256
debug1: Server host key: ssh-ed25519 SHA256:abc123...
debug1: Host '203.0.113.10' is known and matches the ED25519 host key. # ← phase de clé d’hôte franchie ; pas un problème de known_hosts
debug1: Authentications that can continue: publickey # ← clés uniquement ; aucun mot de passe ne sera jamais proposé
debug1: Offering public key: /home/you/.ssh/id_ed25519 ED25519 SHA256:def456... # ← la clé que le client a réellement essayée
debug3: receive packet: type 51 # ← SSH_MSG_USERAUTH_FAILURE : le serveur a rejeté cette clé
debug1: Trying private key: /home/you/.ssh/id_rsa # ← clés de l’agent épuisées ; on se rabat sur les fichiers de clés
debug1: No more authentication methods to try.
deploy@203.0.113.10: Permission denied (publickey).
Lisez-la de bas en haut. L’échec est Permission denied (publickey) ; la dernière vraie tentative au-dessus est l’offre de id_ed25519 qui a entraîné un type 51. Le serveur a donc vu cette clé et l’a refusée — un problème côté serveur (mauvais utilisateur de connexion, clé absente d’authorized_keys, ou permissions de ~/.ssh), pas une clé manquante. Si id_ed25519 n’était jamais apparue dans une ligne Offering public key, le diagnostic basculerait côté client : la clé n’a jamais été envoyée.
Le décodeur : des lignes qui répondent à de vraies questions
Will attempt key: / Offering public key: ... — la réponse à « quelles clés essaie-t-il, et dans quel ordre ? » Avec -v, vous verrez chaque candidate : chemin de fichier ou entrée d’agent, type de clé, empreinte. Si la clé que vous vouliez n’est pas dans cette liste, le serveur ne l’a jamais vue — aucune correction côté serveur n’y changera rien. Désignez-la explicitement avec -i et vérifiez, dans la phase de configuration, une ligne IdentityFile qui vous passe devant.
debug3: receive packet: type 51 — c’est SSH_MSG_USERAUTH_FAILURE : le serveur a rejeté cette tentative d’authentification. Ce n’est pas fatal en soi — le client hausse les épaules et passe à la clé ou à la méthode suivante, si bien que vous verrez souvent plusieurs type 51 dans une connexion saine. Cela devient le diagnostic seulement quand cela suit la clé censée fonctionner : le serveur a alors examiné cette clé et a dit non — mauvais utilisateur, clé absente d’authorized_keys, ou mauvaises permissions côté serveur. Ce tri, c’est le guide Permission denied. (Pour se repérer : le type 50 est la requête qui part, le type 52 est la réussite.)
Server accepts key: suivi malgré tout d’un échec — la ligne intéressante. Le serveur a confirmé que cette clé publique figure dans authorized_keys et a invité le client à prouver qu’il la possède ; si l’authentification échoue quand même après cette ligne, le problème est de votre côté de la preuve : l’agent n’a pas pu signer (mauvais socket d’agent, l’agent ne détient pas réellement cette clé privée), une invite de phrase secrète a échoué, ou la clé privée sur le disque ne correspond pas à la clé publique proposée. Regardez la ligne sign_and_send_pubkey: — ou son absence — juste après.
No more authentication methods to try. — l’état final. Toutes les méthodes autorisées par le serveur ont été épuisées, et la ligne juste après est Permission denied. Ne lisez pas cette ligne comme l’erreur ; remontez vers le haut à partir d’elle pour trouver la dernière vraie tentative et la raison de son échec.
Un blocage sur expecting SSH2_MSG_KEX_ECDH_REPLY — pas du tout un problème d’authentification. La réponse d’échange de clés du serveur est le premier gros paquet de la connexion, et si elle n’arrive jamais alors que tout ce qui précède a fonctionné, la cause classique est un problème de MTU ou un équipement réseau récalcitrant — les VPN et certains pare-feu d’entreprise fragmentent ou abandonnent les gros paquets. Testez depuis un autre réseau ou sans le VPN ; si ça se connecte, ajustez le MTU plutôt que de fixer les clés.
Unspecified GSS failure — du bruit Kerberos. Le client a tenté l’authentification GSSAPI, vous n’êtes pas dans un domaine Kerberos, cela a échoué, et il s’est rabattu sur la méthode suivante. Si la connexion finit par réussir ou échouer sur les clés, cette ligne n’y est pour rien — ignorez-la, sauf si vous utilisez réellement le SSO Kerberos.
connect to address ... port 22: Connection refused / Connection timed out — la connexion n’a jamais eu lieu, donc toute question d’authentification est sans objet. « Refused » signifie que l’hôte a répondu et que rien n’écoute ; « timed out » signifie le silence sur le chemin. Deux enquêtes différentes, aucune n’impliquant les clés — le diagnostic en deux minutes couvre les deux branches.
La méthode qui trouve vite
Trois habitudes transforment un mur de texte de débogage en une lecture de deux minutes :
- Reproduisez en retirant le bruit.
ssh -vvv -o IdentitiesOnly=yes -i ~/.ssh/the_key user@hostne propose qu’une seule clé, donc la trace ne contient qu’une tentative au lieu de six, et un type 51 ne peut vouloir dire qu’une chose. - Lisez de bas en haut. Trouvez l’échec à la fin, puis remontez jusqu’à la dernière décision qui le précède — le dernier
Offering public key, la frontière de phase qu’elle n’a jamais franchie. Les trente premières lignes d’une trace sont presque toujours saines. - Vérifiez qui a défini quoi. Quand le comportement ne correspond pas à votre intention, les lignes
Reading configuration dataetApplying options foren haut nomment le fichier et le bloc responsables. La moitié des « SSH ignore mes options » est un bloc de configuration qui l’emporte en silence.
Moins de traces à lire, pour commencer
La trace est le bon outil quand quelque chose casse — mais une partie de ce qu’elle révèle est un état que vous ne devriez pas avoir à redécouvrir : quelle clé cet hôte veut, quel utilisateur, quel port. Termalin garde ces éléments avec l’hôte enregistré, si bien que la bonne clé est proposée à dessein plutôt qu’en quatrième position dans la file d’un agent, et il vérifie l’identité de chaque serveur à la première connexion, avec un avertissement bien visible si l’empreinte venait à changer — la phase de clé d’hôte, traitée délibérément. Le statut en direct des hôtes répond à « la machine est-elle seulement joignable ? » avant que vous vous connectiez, ce qui court-circuite entièrement la branche refusée/expirée de la trace. Le forfait Free est sans limite d’hôtes — téléchargez-le et gardez -vvv pour les jours vraiment étranges.
Termalin est un client SSH gratuit et multiplateforme qui garde avec l’hôte les ports, utilisateurs, clés et keepalives propres à chaque hôte et vérifie l’identité du serveur à chaque connexion — téléchargez-le, ou parcourez la liste complète des fonctionnalités.