termal.in

← Blog

Die SSH-Flags, die du wirklich brauchst (ein praktischer Spickzettel)

· aktualisiert 12. Nov. 2026 · Termalin Team sshcheat-sheetproductivitytutorial

Kurzantwort: Die Flags, zu denen du am häufigsten greifst: -p <port> (nicht standardmäßiger Port), -i <key> (einen bestimmten Schlüssel erzwingen), -L / -R / -D (lokale, entfernte und dynamische Weiterleitung), -J <bastion> (durch eine Bastion springen), -N -f (einen Tunnel ohne Shell in den Hintergrund schicken), -t (ein TTY für sudo erzwingen), -o Option=value (jede ssh_config-Direktive direkt in der Befehlszeile setzen) und -vvv (eine scheiternde Verbindung debuggen). Alles, was du zweimal übergibst, gehört in ~/.ssh/config, sodass ssh web1 es ganz ohne Flags mitbringt.

ssh --help wirft vierzig Flags in alphabetischer Reihenfolge aus, was die am wenigsten nützliche Art ist, sie zu lernen. Du greifst zu Flags danach, was du vorhast – dich als anderer Nutzer verbinden, einen Port weiterleiten, über eine Bastion hüpfen, eine abgelehnte Verbindung debuggen –, hier also derselbe Satz nach Aufgabe geordnet, mit einem Hinweis, welche du nicht mehr tippen, sondern stattdessen in deine ssh_config (auf Englisch) packen solltest.

Die Regel unter all dem: Flags sind für Einmaliges; die Config ist für Dauerhaftes. Alles, was du zweimal übergibst, gehört in die Datei.

Verbindungsgrundlagen

Die Flags, die „wer, wohin und mit welchem Schlüssel“ beantworten.

  • -p <port> – Verbindung zu einem nicht standardmäßigen Port. ssh -p 2222 user@host. (Kleines -p; großes -P ist das Port-Flag von scp, über das jeder einmal stolpert.)
  • -l <user> – der Login-Nutzer, eine Alternative zum Präfix user@. ssh -l deploy host entspricht ssh deploy@host; -l begegnet dir in Skripten und älterer Doku.
  • -i <identity> – zeigt auf einen bestimmten privaten Schlüssel. ssh -i ~/.ssh/work_ed25519 user@host. Das nützlichste Flag, wenn die Auth scheitert: Es erzwingt den genauen Schlüssel, statt den Agenten raten zu lassen.
  • -F <configfile> – eine andere Konfigurationsdatei verwenden. ssh -F ./project.sshconfig web1, oder -F /dev/null, um deine persönliche Config zu ignorieren und ganz ohne Anpassungen zu testen.
  • -v / -vv / -vvv – Ausführlichkeit, und das Flag, das die meisten Rätsel beendet. Ein -v zeigt die versuchten Auth-Methoden und angebotenen Schlüssel; -vvv zeigt den vollständigen Handshake. Wenn etwas scheitert, lass es noch einmal mit -vvv laufen, bevor du Theorien aufstellst – diesen Trace zu lesen ist eine eigene Kunst.

Die Notluke -o

Das ist das Flag, das man gründlich verstehen sollte, denn es schließt Dutzende andere ein. -o setzt jede ssh_config-Option direkt in der Befehlszeile. Alles, was du in ~/.ssh/config unter einem Host-Block schreiben könntest, kannst du als -o Option=value übergeben – keine kurze Liste gesegneter Optionen, sondern das gesamte Config-Vokabular, verfügbar für eine einzelne Verbindung.

Ein paar, die ständig vorkommen:

ssh -o IdentitiesOnly=yes -i ~/.ssh/right_key user@host   # offer only this key
ssh -o StrictHostKeyChecking=accept-new user@host          # trust new hosts, still catch changes
ssh -o ServerAliveInterval=30 user@host                    # keepalive for a flaky link
ssh -o ProxyJump=bastion.example.com db.internal           # hop through a bastion inline

-o IdentitiesOnly=yes ist die Lösung für Too many authentication failures, wenn dein Agent sechs Schlüssel anbietet und ein strenger Server dich nach fünf abschneidet. -o StrictHostKeyChecking=accept-new ist der vernünftige Mittelweg – einem Host, den du noch nie gesehen hast, automatisch vertrauen, aber trotzdem aufschreien, wenn sich der Schlüssel eines bekannten Hosts ändert.

Der Punkt: Du brauchst nicht für jedes Verhalten ein eigenes Flag. Wenn du die Config-Direktive kennst, kennst du das Flag – es ist -o Directive=value. Sobald du jedes Mal drei oder vier übergibst, verschieb sie endgültig in die Config.

Weiterleitung und Tunnel

Die Flags für die Port-Klempnerei. Das Gedankenmodell – welche Seite den Port öffnet – bekommt seine eigene Lektüre in SSH-Portweiterleitung erklärt; hier die Zusammenfassung der Flags.

  • -L <local>:<host>:<port> – lokale Weiterleitung. Öffnet einen Port auf deiner Maschine, der zu einem vom Server erreichbaren Ziel tunnelt. ssh -L 5432:localhost:5432 db.example.com bringt eine entfernte Datenbank auf dein 127.0.0.1:5432.
  • -R <remote>:<host>:<port> – entfernte Weiterleitung. Öffnet einen Port auf dem Server, der zu deiner Seite zurücktunnelt – der Reverse-Tunnel-Trick, um eine Maschine hinter NAT zu erreichen.
  • -D <port> – dynamische Weiterleitung. Ein SOCKS-Proxy auf deiner Maschine; das Ziel wird pro Verbindung gewählt. ssh -D 1080 jump.example.com, dann richte einen Browser auf 127.0.0.1:1080.
  • -N – keinen entfernten Befehl ausführen. Kombiniere es mit einer beliebigen Weiterleitung, wenn du nur den Tunnel und keine Shell willst.
  • -f – schickt ssh nach dem Verbinden in den Hintergrund. Kombiniere es mit -N für einen Fire-and-forget-Tunnel: ssh -fN -L 5432:localhost:5432 db.example.com.
  • -g – lässt andere Maschinen in deinem LAN eine lokale Weiterleitung (-L/-D) nutzen, nicht nur 127.0.0.1. Eine kleine Preisgabe – du öffnest den Tunnel für dein ganzes Netz, also nutz es bewusst.

Jump-Hosts und der Agent

Den nächsten Sprung erreichen – und das Flag, mit dem du vorsichtig sein solltest.

  • -J <jumphost> – ProxyJump. Tunnelt durch eine Bastion und authentifiziert Ende zu Ende von deinem Laptop zum Ziel. ssh -J bastion.example.com db.internal. Die Bastion befördert nur verschlüsselte Bytes; dein Schlüssel landet nie auf ihr – der richtige Weg durch ein Gateway. Der ganze Fall: ProxyJump: Server hinter einer Bastion erreichen.
  • -A – Agent-Weiterleitung. Legt auf dem entfernten Host einen Socket offen, der Signieranfragen an deinen lokalen Agenten zurückleitet, sodass ein Prozess dort sich als du beim nächsten Server authentifizieren kann. Praktisch und riskanter, als es aussieht: Jeder mit Root-Rechten auf diesem Host kann deine Identität ausleihen, solange die Sitzung offen ist. Nimm -J für „den nächsten Sprung erreichen“ und heb dir -A für Hosts auf, denen du voll vertraust – die Gründe stehen in Agent-Weiterleitung ist praktisch und gefährlich (auf Englisch).

Zwischen beiden: -J bringt deine Shell zu einem Host hinter der Bastion, ohne irgendjemandem deine Schlüssel zu leihen; -A verleiht die laufende Nutzung deiner Schlüssel an die Kiste, mit der du dich verbunden hast. Nicht derselbe Handel.

Sitzungssteuerung

Die kleinen Flags, die bestimmte Ärgernisse beheben.

  • -t – erzwingt ein Pseudo-Terminal. Nötig für einen entfernten Befehl, der ein interaktives TTY erwartet: ssh -t host 'sudo systemctl status nginx' gibt dir ein echtes Terminal für die sudo-Abfrage und farbige Ausgabe. Verdopple es (-tt), um eines zu erzwingen, wenn es kein lokales TTY gibt.
  • -q – stiller Modus. Unterdrückt Warnungen und Banner; nützlich in Skripten, wo du nur die eigene Ausgabe des Befehls willst.
  • -C – fordert Kompression an. Ein echter Gewinn auf langsamen Verbindungen mit hoher Latenz; vernachlässigbar oder leicht negativ in einem schnellen LAN.
  • -o BatchMode=yes – nie nachfragen. Würde die Auth ein Passwort oder eine Passphrase brauchen, scheitert sie sofort, statt zu hängen. Das macht SSH in cron und CI sicher – eine feststeckende Abfrage in einem unbeaufsichtigten Skript hängt ewig.

Welchen Port nutzt SSH?

SSH nutzt standardmäßig TCP-Port 22 – davon gehen ssh, scp, sftp und git-over-SSH alle aus, wenn du nichts anderes sagst. Um einen Server zu erreichen, der woanders lauscht, übergib den Port mit -p:

ssh -p 2222 user@host

Um den Port zu ändern, auf dem der Server lauscht, setz Port in /etc/ssh/sshd_config und starte den sshd neu – öffne dann den neuen Port sowohl in der Firewall des Hosts als auch in der Security Group der Cloud, bevor du dich ausloggst, denn SSH umzuziehen, ohne den neuen Port freizugeben, ist der schnellste Weg, dich selbst auszusperren. (Weg von 22 beruhigt Drive-by-Scanner; echte Sicherheit ist es für sich allein nicht.) Setz es einmal pro Host in deiner ssh_config (auf Englisch) als Port 2222, und du tippst nie wieder -p.

Wie man einen Befehl über SSH ohne Shell ausführt

Setz den Befehl in Anführungszeichen hinter den Host, und SSH führt ihn aus, gibt die Ausgabe aus und beendet sich – es öffnet sich keine interaktive Shell:

ssh user@host 'df -h /'
ssh user@host 'systemctl is-active nginx'

Das ist das Rückgrat von Skripten und cron: eine Verbindung, ein Befehl, ein Exit-Code, den du prüfen kannst. Setz den Befehl in Anführungszeichen, damit deine lokale Shell ihn nicht zuerst expandiert. Zwei Flags sind hier wichtig:

  • -t erzwingt ein TTY für einen Befehl, der eines braucht – ssh -t user@host 'sudo systemctl restart nginx' gibt sudo eine echte interaktive Abfrage.
  • -o BatchMode=yes (oder -n) hält es davon ab, auf Eingaben zu warten, sodass ein unbeaufsichtigter Job schnell scheitert, statt an einer Abfrage zu hängen.

Wie man eine SSH-Sitzung beendet

Tippe exit oder drücke Ctrl-D, um die Shell zu schließen und die Verbindung zu kappen. Beides sendet ein End-of-File an die entfernte Shell, was dich ausloggt und zu deiner lokalen Eingabeaufforderung zurückbringt:

exit        # or press Ctrl-D

Wenn eine Sitzung eingefroren ist – die Verbindung ist tot und das Terminal ignoriert alles, sogar Ctrl-C –, hilft exit nicht, weil nichts, was du tippst, das andere Ende erreicht. Nutz stattdessen SSHs eigene Escape-Sequenz: drücke Enter, dann tippe ~. (Tilde, dann Punkt). Das weist dein lokales ssh an, die Verbindung sofort abzubrechen, egal wie festgefahren die Gegenseite ist. Das ~-Escape wird nur direkt nach einem Zeilenumbruch gelesen, deshalb drückst du zuerst Enter.

Die kompakte Referenz

FlagTutssh_config-Äquivalent
-p 2222Nicht standardmäßiger PortPort 2222
-l user / user@Login-NutzerUser user
-i ~/.ssh/keyBestimmter SchlüsselIdentityFile ~/.ssh/key
-F fileAlternative Konfigurationsdatei— (das ist die Config)
-v … -vvvAusführlich / DebugLogLevel DEBUG3
-o Opt=valJede Config-Option direkt(die Option selbst)
-L a:host:bLokale WeiterleitungLocalForward a host:b
-R a:host:bEntfernte WeiterleitungRemoteForward a host:b
-D 1080Dynamische (SOCKS-)WeiterleitungDynamicForward 1080
-NKein entfernter BefehlRequestTTY no (+ kein Befehl)
-fHintergrund nach dem Verbinden— (nur einmalig)
-gWeiterleitung für dein LAN öffnenGatewayPorts yes
-J hostDurch eine Bastion springenProxyJump host
-ADen Agenten weiterleitenForwardAgent yes
-tEin TTY erzwingenRequestTTY force
-qStillLogLevel QUIET
-CKompressionCompression yes
-o BatchMode=yesNie nachfragenBatchMode yes

Die rechte Spalte ist der verräterische Hinweis. Fast jedes Flag hat ein Config-Äquivalent, und das ist der Arbeitsablauf: Nutz das Flag einmal, um zu beweisen, dass eine Verbindung funktioniert, und verschieb dann die, die du wiederholst, in ~/.ssh/config, sodass ssh web1 sie alle ganz ohne Flags mitbringt. Die Flags ohne Config-Äquivalent – -f, -F, die Debug-Ausführlichkeit – sind die wirklich einmaligen.

Wo ein Client den Zustand für dich behält

Flags und Config leben beide in deinen Dotfiles, pro Maschine, und das schmerzt im großen Maßstab: Einstellungen von Hand zwischen Laptops kopiert, Tunnel nach jedem Ruhezustand neu gestartet, keine Möglichkeit zu sehen, welcher von vierzig Hosts läuft. Termalin behält dieselben Fakten, die ein Flag tragen würde – Port, Nutzer, Schlüssel, Jump-Host, Keepalives, gespeicherte lokale/remote/dynamische Weiterleitungen – als strukturierte Daten am Host, in Ordner und Tags geordnet, zwischen deinen Maschinen Ende-zu-Ende-verschlüsselt synchronisiert. Es prüft jeden Server beim ersten Verbinden, zeigt den Live-Status pro Host und startet Tunnel mit der Verbindung statt mit einem neu getippten Befehl. Die Flags lehren dich, was passiert; ein Client bewahrt dich davor, sie jeden Morgen neu zu tippen.


Termalin ist ein kostenloser, plattformübergreifender SSH-Client, der Einstellungen, Schlüssel und Tunnel pro Host für dich speichert – lade es herunter oder lies, wie es deine Schlüssel sicher verwahrt.

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