termal.in

← Blog

Die Ausgabe von ssh -vvv lesen: die Debug-Zeilen, auf die es wirklich ankommt

· aktualisiert 29. Sept. 2026 · Termalin Team sshtroubleshootingdebuggingtutorial

Wenn SSH scheitert, ist der Fehler in der letzten Zeile meist eine Zusammenfassung, keine Diagnose – Permission denied (publickey) nennt dir das Ergebnis einer Aushandlung, nicht, wo sie schiefging. Die eigentliche Geschichte steht in ssh -vvv, weshalb Leute am Ende rohe Fragmente wie debug3: receive packet: type 51 in eine Suchmaschine kippen. Du musst das Protokoll nicht auswendig können, um diesen Trace zu lesen. Du musst die Handvoll Zeilen kennen, die echte Fragen beantworten – und welche davon Rauschen sind.

Das hier ist eine Leseanleitung: was jede Stufe von -v hinzufügt, die Phasen, die du der Reihe nach siehst, und ein Decoder für die Zeilen, bei denen es sich lohnt innezuhalten. (Für die Fehler selbst – refused, timed out, Hostschlüssel-Warnungen – stehen die Lösungen im Decoder-Ring.)

Was -v, -vv und -vvv tatsächlich hinzufügen

  • -v gibt die debug1-Zeilen aus: die Erzählung aus der Vogelperspektive. Welche Konfigurationsdateien gelesen wurden, wohin verbunden wird, was der Server angeboten hat, welche Schlüssel versucht wurden, welche Auth-Methode gewann. Für die meisten Probleme reicht das.
  • -vv fügt debug2 hinzu: die Details der Aushandlung – vollständige Algorithmenlisten von beiden Seiten, Entscheidungen pro Schlüssel.
  • -vvv fügt debug3 hinzu: den Trace auf Paketebene, samt der Zeilen send packet: type N / receive packet: type N. Das ist die Stufe, die Protokoll-Nachrichtennummern benennt, und daher stammen die rätselhaften, suchbaren Zeilen.

Fang mit -v an. Greif zu -vvv, wenn die -v-Geschichte abrupt endet und du das genaue Paket sehen musst, an dem sie starb.

Die Phasen, in der Reihenfolge, in der du sie siehst

Jede erfolgreiche Verbindung geht denselben Weg, und die Debug-Ausgabe folgt ihm. Die Phasen zu kennen heißt, dass du sagen kannst, wo ein Fehler auftrat, bevor du verstehst, was fehlschlug.

1. Config. Die ersten Zeilen sind Reading configuration data /home/you/.ssh/config und .../etc/ssh/ssh_config, gefolgt von Applying options for <pattern> für jeden Host-Block, der passte. Wenn SSH einen Port, Nutzer oder Schlüssel benutzt, den du nicht erwartet hast, wird der Übeltäter genau hier benannt – irgendein Block, den du vergessen hast, greift. (Was in diese Datei gehört und wie das Matching funktioniert: die Anleitung zu ~/.ssh/config (auf Englisch).)

2. TCP-Verbindung. Connecting to host [1.2.3.4] port 22. dann Connection established. Siehst du stattdessen connect to address ... Connection refused oder Connection timed out, hör auf zu lesen – nichts nach diesem Punkt zählt, weil es kein „Danach“ gibt. Siehe unten.

3. Versionsaustausch. Local version string SSH-2.0-OpenSSH_... und Remote protocol version 2.0, remote software version ... – die beiden Enden stellen sich im Klartext vor. Nützlich vor allem, um uralte Server zu erkennen und zu bestätigen, dass du überhaupt einen sshd erreicht hast.

4. Schlüsselaustausch und Hostschlüssel. SSH2_MSG_KEXINIT sent / received, dann die gewählten Algorithmen (kex: algorithm: ..., kex: host key algorithm: ...), dann wird der Hostschlüssel des Servers gegen deine known_hosts geprüft: Host 'x' is known and matches the ED25519 host key / Found key in ~/.ssh/known_hosts:12. Eine Abweichung bricht hier mit dem großen Warnbanner ab.

5. Authentifizierung. Authentications that can continue: publickey,password ist die Auflistung des Servers, was er akzeptiert. Dann arbeitet sich der Client durch Methoden und Schlüssel, ein Versuch nach dem anderen, bis etwas gelingt – oder nichts. In dieser Phase liest man am meisten, deshalb bekommt sie ihren eigenen Decoder.

Ein kommentierter Trace, von Anfang bis Ende

Hier ein echter (gekürzter) -vvv-Lauf des meistgesuchten Fehlers – Permission denied (publickey) – mit markierten Zeilen, auf die es ankommt. Jede Phase von oben ist der Reihe nach sichtbar:

$ 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   # ← a Host block matched; suspect it if the user/key/port is wrong
debug1: Connecting to 203.0.113.10 [203.0.113.10] port 22.
debug1: Connection established.                                            # ← TCP is up: refused / timed out is ruled out here
debug1: Local version string SSH-2.0-OpenSSH_9.6
debug1: Remote protocol version 2.0, remote software version OpenSSH_8.9p1 # ← you reached a real 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.     # ← host-key phase passed; not a known_hosts problem
debug1: Authentications that can continue: publickey                       # ← keys only; no password will ever be offered
debug1: Offering public key: /home/you/.ssh/id_ed25519 ED25519 SHA256:def456...  # ← the key the client actually tried
debug3: receive packet: type 51                                            # ← SSH_MSG_USERAUTH_FAILURE: the server rejected that key
debug1: Trying private key: /home/you/.ssh/id_rsa                          # ← agent keys exhausted; now falling back to key files
debug1: No more authentication methods to try.
deploy@203.0.113.10: Permission denied (publickey).

Lies ihn von unten nach oben. Der Fehler ist Permission denied (publickey); der letzte echte Versuch darüber ist das id_ed25519-Angebot, das ein type 51 einbrachte. Der Server hat diesen Schlüssel also gesehen und abgelehnt – ein serverseitiges Problem (falscher Login-Nutzer, der Schlüssel steht nicht in authorized_keys, oder die Rechte von ~/.ssh), kein fehlender Schlüssel. Wäre id_ed25519 überhaupt nie in einer Offering public key-Zeile aufgetaucht, würde die Diagnose auf clientseitig kippen: Der Schlüssel wurde nie gesendet.

Der Decoder: Zeilen, die echte Fragen beantworten

Will attempt key: / Offering public key: ... – die Antwort auf „welche Schlüssel probiert es, und in welcher Reihenfolge?“. Bei -v siehst du jeden Kandidaten: Dateipfad oder Agenten-Eintrag, Schlüsseltyp, Fingerprint. Wenn der Schlüssel, den du gemeint hast, nicht in dieser Liste steht, hat der Server ihn nie gesehen – kein noch so großes serverseitiges Herumbasteln hilft. Zeig mit -i ausdrücklich darauf und prüf die Config-Phase auf eine IdentityFile-Zeile, die dich überschreibt.

debug3: receive packet: type 51 – das ist SSH_MSG_USERAUTH_FAILURE: Der Server hat diesen Authentifizierungsversuch abgelehnt. Für sich allein ist das nicht fatal – der Client zuckt mit den Schultern und geht zum nächsten Schlüssel oder zur nächsten Methode über, du siehst also bei einem gesunden Login oft mehrere type 51. Zur Diagnose wird es erst, wenn es auf den Schlüssel folgt, von dem du erwartet hast, dass er funktioniert: Dann hat der Server diesen Schlüssel angesehen und Nein gesagt – falscher Nutzer, Schlüssel fehlt in authorized_keys, oder schlechte serverseitige Rechte. Diese Einordnung liefert die Anleitung zu Permission denied. (Zur Orientierung: type 50 ist die hinausgehende Anfrage, type 52 ist Erfolg.)

Server accepts key: und trotzdem danach ein Fehlschlag – der interessante Fall. Der Server hat bestätigt, dass dieser öffentliche Schlüssel in authorized_keys steht, und den Client aufgefordert, den Besitz nachzuweisen; wenn die Authentifizierung nach dieser Zeile trotzdem scheitert, liegt das Problem auf deiner Seite des Nachweises: Der Agent konnte nicht signieren (falscher Agenten-Socket, der Agent hält diesen privaten Schlüssel gar nicht), eine Passphrase-Abfrage schlug fehl, oder der private Schlüssel auf der Platte passt nicht zum angebotenen öffentlichen Schlüssel. Sieh dir die sign_and_send_pubkey:-Zeile – oder ihr Fehlen – direkt danach an.

No more authentication methods to try. – der Endzustand. Jede vom Server erlaubte Methode ist erschöpft, und die nächste Zeile ist Permission denied. Lies diese Zeile nicht als den Fehler; lies von ihr aus nach oben, um den letzten echten Versuch zu finden und warum er scheiterte.

Ein Hängen bei expecting SSH2_MSG_KEX_ECDH_REPLY – überhaupt kein Auth-Problem. Die Schlüsselaustausch-Antwort des Servers ist das erste große Paket der Verbindung, und wenn sie nie ankommt, während alles davor funktioniert hat, ist die klassische Ursache ein MTU-Problem oder eine störrische Middlebox – VPNs und manche Firmen-Firewalls fragmentieren oder verwerfen große Pakete. Teste von einem anderen Netz oder ohne VPN; verbindet es sich dann, justier die MTU, statt auf Schlüssel zu starren.

Unspecified GSS failure – Kerberos-Rauschen. Der Client hat GSSAPI-Auth versucht, du bist in keinem Kerberos-Realm, es scheiterte, und er fiel auf die nächste Methode zurück. Wenn die Verbindung letztlich an Schlüsseln gelingt oder scheitert, hat diese Zeile dabei keine Rolle gespielt – ignorier sie, es sei denn, du nutzt tatsächlich Kerberos-SSO.

connect to address ... port 22: Connection refused / Connection timed out – die Verbindung kam nie zustande, also ist jede Auth-Frage hinfällig. Refused heißt, der Host hat geantwortet und nichts lauscht; timed out heißt Stille auf dem Pfad. Zwei verschiedene Untersuchungen, keine davon mit Schlüsseln – die Zwei-Minuten-Diagnose deckt beide Zweige ab.

Der Arbeitsablauf, der es schnell findet

Drei Gewohnheiten machen aus einer Wand von Debug-Text eine Zwei-Minuten-Lektüre:

  1. Reproduziere es ohne Rauschen. ssh -vvv -o IdentitiesOnly=yes -i ~/.ssh/the_key user@host bietet genau einen Schlüssel an, der Trace enthält also einen Versuch statt sechs, und ein type 51 kann nur eines bedeuten.
  2. Lies von unten nach oben. Finde den Fehlschlag am Ende und geh dann nach oben bis zur letzten Entscheidung davor – das letzte Offering public key, die Phasengrenze, die nie überschritten wurde. Die ersten dreißig Zeilen eines Traces sind fast immer gesund.
  3. Prüf, wer was gesetzt hat. Wenn das Verhalten nicht deiner Absicht entspricht, benennen die Zeilen Reading configuration data und Applying options for ganz oben die verantwortliche Datei und den verantwortlichen Block. Die Hälfte von „SSH ignoriert meine Flags“ ist ein Config-Block, der leise gewinnt.

Weniger Traces, die überhaupt zu lesen sind

Der Trace ist das richtige Werkzeug, wenn etwas kaputtgeht – aber ein guter Teil dessen, was er offenbart, ist Zustand, den du nicht wieder herausfinden können müsstest: welchen Schlüssel dieser Host will, welchen Nutzer, welchen Port. Termalin hält das beim gespeicherten Host, sodass der richtige Schlüssel gezielt angeboten wird statt als vierter in der Reihe eines Agenten, und prüft die Identität jedes Servers beim ersten Verbinden mit einer lauten Warnung, falls sich der Fingerprint je ändert – die Hostschlüssel-Phase, bewusst gehandhabt. Der Live-Host-Status beantwortet „ist die Kiste überhaupt erreichbar?“, bevor du dich verbindest, womit der Refused-/Timed-out-Zweig des Traces komplett zuvorgekommen ist. Der Free-Tarif hat kein Host-Limit – lade es herunter und heb dir -vvv für die wirklich schrägen Tage auf.


Termalin ist ein kostenloser, plattformübergreifender SSH-Client, der Ports, Nutzer, Schlüssel und Keepalives pro Host beim Host behält und die Server-Identität bei jedem Verbinden prüft – lade es herunter oder durchstöbere die vollständige Funktionsliste.

Probier es auf einem Host aus.

Termalin ist ein schneller SSH-Client für dich – und deine Agenten.

Free-Tarif · 14-tägige Pro-Testphase · Preise

Termalin bei Google als bevorzugte Quelle hinzufügen