Die SSH-Escape-Sequenz ~. schließt eine eingefrorene Sitzung clientseitig, ohne auf den Server zu warten: Drücke Enter, dann ~, dann einen Punkt. Das funktioniert, weil OpenSSH das Escape-Zeichen am Zeilenanfang lokal verarbeitet, selbst wenn das Netzwerk oder der entfernte Host nicht mehr reagiert.

So funktioniert ~. in SSH: das Escape-Zeichen von OpenSSH

OpenSSH verwendet ~ als Standard-Escape-Zeichen, und der Client erkennt es nur am Anfang einer Zeile, direkt nachdem du Enter gedrückt hast. Tippst du ~. mitten in einem Befehl, geht es direkt an den Server. Tippst du es nach einem Zeilenumbruch, fängt dein lokales ssh es ab, sodass es das Netzwerk nie berührt.

Genau das macht es nützlich. Wenn die TCP-Verbindung hängt, bewirken Strg-C und exit nichts, weil beide den Server erreichen müssen. ~. hängt überhaupt nicht vom Server ab: Es trennt die Verbindung auf deiner Seite und gibt dir deinen lokalen Prompt zurück. Escapes sind nur verfügbar, wenn ein Pseudoterminal angefordert wurde, was bei einer interaktiven Sitzung der Normalfall ist. Die vollständige Liste steht in der Manpage von ssh.

Die SSH-Escape-Sequenzen, die man sich merken sollte: ~., ~?, ~C und ~~

OpenSSH dokumentiert diese Sequenzen, und jede davon muss auf Enter folgen:

  • ~. trennt die Verbindung sofort.
  • ~? gibt die Escape-Sequenzen aus, die deine Version unterstützt.
  • ~C öffnet die ssh-Kommandozeile, um Portweiterleitungen hinzuzufügen oder aufzuheben (-L, -R, -D, -KL, -KR, -KD).
  • ~# listet aktive weitergeleitete Verbindungen auf.
  • ~^Z schickt ssh in den Hintergrund (Strg-Z nach der Tilde).
  • ~B sendet ein BREAK an das entfernte System.
  • ~R fordert ein Rekeying der Verbindung an.
  • ~v und ~V erhöhen bzw. verringern die Ausführlichkeit der Diagnosemeldungen.
  • ~~ sendet eine wörtliche Tilde; so erreichst du verschachtelte Sitzungen.
# Press Enter, then the sequence
~.                           # close this session
~~.                          # close the nested session (ssh inside ssh)
~?                           # list available sequences
~C                           # open the ssh command line
ssh> -L 8080:localhost:80    # add a local forward on the fly
ssh> -KL 8080                # cancel it

Ein typisches Setup: Du springst von deinem Laptop auf einen Bastion-Host und von dort weiter auf einen anderen Server. ~. beendet die erste Verbindung und alles, was durch sie läuft. ~~. sorgt dafür, dass das erste ssh eine Tilde und einen Punkt an das zweite weiterreicht, das dann die Verbindung trennt. Jede zusätzliche Tilde reicht eine Ebene tiefer.

Neuere OpenSSH-Versionen deaktivieren ~C standardmäßig über die Option EnableEscapeCommandline. Wenn ~C nichts bewirkt, füge EnableEscapeCommandline yes zum entsprechenden Host-Block hinzu. Um von diesem Prompt aus lokale Befehle mit !command auszuführen, ist außerdem PermitLocalCommand yes nötig.

Wann eine SSH-Sitzung wirklich tot ist und wann sie nur so aussieht

Drücke Enter und tippe ~?. Erscheint die Hilfe, ist dein lokaler ssh-Client in Ordnung und das Problem liegt im Netzwerk oder auf dem Server. Bedenke, dass dies eine lokale Prüfung ist: Sie sagt nichts darüber aus, ob der Server noch läuft, sondern nur, dass deine Seite reagiert. Bevor du die Verbindung kappst, schließe drei scheinbare Hänger aus:

  1. Ein versehentliches Strg-S. Es pausiert die Terminalausgabe per XOFF-Flusskontrolle, und Strg-Q setzt sie fort.
  2. Ein langsamer Vordergrundbefehl. Versuche Strg-C: Antwortet der Server, lebt die Sitzung.
  3. Ein Vollbildprogramm, das auf Eingabe wartet. Ein Editor oder ein Pager kann eingefroren wirken, und mit Esc oder q kommst du meist heraus.

Wenn nichts davon ein Echo erzeugt, ist die Sitzung praktisch tot. Das ist typisch nach dem Wechsel von WLAN zu mobilen Daten, nach dem Ruhezustand eines Laptops oder nach einem Neustart des Servers. Damit du nicht blind wartest, lässt ServerAliveInterval den Client Kontrollnachrichten durch den verschlüsselten Kanal senden. Bleiben ServerAliveCountMax Nachrichten in Folge unbeantwortet (standardmäßig 3), trennt ssh die Verbindung von selbst. ServerAliveInterval steht standardmäßig auf 0, ist also deaktiviert.

Das SSH-EscapeChar in ~/.ssh/config ändern oder deaktivieren

Die Direktive EscapeChar legt das Escape-Zeichen fest. Sie akzeptiert ein einzelnes Zeichen, ^ gefolgt von einem Buchstaben für eine Strg-Kombination, oder none. Auf der Kommandozeile ist -e das Gegenstück.

Host *
    ServerAliveInterval 15
    ServerAliveCountMax 3

Host bastion
    HostName bastion.example.com
    EscapeChar ^]

# One connection with no escapes (fully transparent session)
ssh -e none user@server

Mit none sind keine Escapes verfügbar und die Verbindung ist vollständig transparent. Das ist wichtig, wenn Binärdaten durch den Kanal fließen, die nach einem Zeilenumbruch eine Tilde enthalten könnten. Ein anderes Zeichen ist bei verschachtelten Sitzungen sinnvoll, damit jeder Hop sein eigenes bekommt, oder wenn dein Tastaturlayout ~ zu einer Tottaste macht. Alle Direktiven sind in der Manpage von ssh_config beschrieben.

SSH-Escape-Sequenzen im Vergleich zu Mosh: Vergleichstabelle

Mosh verwendet eine andere Sequenz: Strg-^ gefolgt von einem Punkt beendet die Sitzung. Das sind die Unterschiede, die zählen, wenn eine Verbindung hängt:

VergleichskriteriumSSH (OpenSSH)Mosh
Sequenz zum BeendenEnter, dann ~ und ein PunktStrg-^ gefolgt von einem Punkt
TransportTCP, standardmäßig Port 22UDP, standardmäßig Ports 60000-61000
Wechsel von WLAN zu mobilen DatenDie TCP-Verbindung hängt meistDie Sitzung bleibt bestehen
Portweiterleitung-L, -R und -D, auch über ~CKeine Portweiterleitung und kein X11-Forwarding
StartDirekte Verbindung zum SSH-ServerStartet mosh-server über eine initiale SSH-Verbindung

Mosh hat kein Gegenstück zu ~C, weil es keine Ports weiterleitet; wenn du einen Tunnel brauchst, öffne ihn also über eine separate ssh-Verbindung. Die Details stehen in der offiziellen Mosh-Dokumentation.

Eingefrorene SSH-Sitzungen vom Smartphone aus mit termi1 schließen

Auf den Touch-Tastaturen von iOS und Android liegt die Tilde meist auf einer sekundären Symbolseite, und die Sequenz braucht außerdem zuerst ein Enter. termi1 ergänzt eine eigene Tastenzeile mit Esc, Strg, Tab und Pfeiltasten, wodurch sich Strg-C, Strg-Q und Kombinationen wie Moshs Strg-^ leichter tippen lassen.

Auf dem Smartphone ist ein Netzwerkwechsel die häufigste Ursache für eine eingefrorene Sitzung. termi1 hält die Sitzung mit Mosh am Leben, wenn du von WLAN zu mobilen Daten wechselst, und nutzt tmux, sodass alles, was du hast laufen lassen, noch da ist, wenn du zurückkommst. Falls eine reine SSH-Verbindung doch hängt, schließe sie, verbinde dich neu und mach mit tmux attach dort weiter, wo du aufgehört hast. Das termi1-Terminal für iOS und Android ist kostenlos und funktioniert ohne Konto.

Häufig gestellte Fragen

Warum schließt ~. meine SSH-Sitzung nicht?

Die Sequenz ~. schließt eine SSH-Sitzung nur, wenn sie am Anfang einer neuen Zeile steht, also drücke vor der Tilde Enter. Sie funktioniert außerdem nicht, wenn EscapeChar auf none gesetzt ist, wenn das Escape-Zeichen geändert wurde oder wenn deine Tastatur ~ als Tottaste behandelt und es nie sendet.

Was ist der Unterschied zwischen ~. und exit in SSH?

Der Unterschied zwischen ~. und exit in SSH liegt darin, wo sie jeweils verarbeitet werden. exit läuft in der entfernten Shell und braucht einen reagierenden Server. ~. wird von deinem lokalen ssh-Client abgefangen und trennt die Verbindung, selbst wenn Netzwerk oder Server weg sind. In einer intakten Sitzung ist exit der saubere Weg hinaus.

Wie schließe ich eine verschachtelte SSH-Sitzung, ohne die äußere zu schließen?

Eine verschachtelte SSH-Sitzung schließt du mit ~~. nach einem Enter: Der erste Client reicht eine wörtliche Tilde durch, und der zweite Client liest ~. als Trennbefehl. Jede weitere Tilde reicht eine Ebene tiefer. Alternativ gibst du jedem Hop in ~/.ssh/config ein eigenes EscapeChar.

Werden entfernte Prozesse beendet, wenn ich SSH mit ~. schließe?

Entfernte Prozesse, die im Vordergrund laufen, enden meist, wenn ~. die SSH-Sitzung kappt, weil die Shell ihr Terminal verliert. Damit sie weiterlaufen, starte sie innerhalb von tmux und hänge dich nach dem erneuten Verbinden mit dem Server per tmux attach wieder an.

Was ist die Escape-Sequenz von Mosh?

Die Escape-Sequenz von Mosh ist Strg-^ gefolgt von einem Punkt, und sie beendet die Sitzung auch dann, wenn der Server nicht mehr reagiert. Mosh hat keine ~C-Kommandozeile, weil es weder Portweiterleitung noch X11-Forwarding unterstützt. Für Tunnel öffnest du eine separate SSH-Verbindung mit -L, -R oder -D.