termal.in

← Blog

Die Datei ~/.ssh/config: nie wieder dieselben SSH-Flags tippen

· aktualisiert 12. Nov. 2026 · Termalin Team sshssh-configproductivitytutorial

Kurzantwort: Lege ~/.ssh/config an (und setze chmod 600), dann gib jedem Server einen Host-Block mit HostName, User, Port und IdentityFile – jetzt expandiert ssh web1 zum ganzen Befehl, und scp, sftp, rsync und git lesen denselben Alias. Der erste Treffer gewinnt, liste also spezifische Hosts zuerst und breite Vorgaben mit Host * zuletzt. ProxyJump erreicht einen Host hinter einer Bastion; ServerAliveInterval 30 verhindert, dass untätige Sitzungen abbrechen; IdentitiesOnly yes fixiert einen Schlüssel, damit ein strenger Server dich nicht abweist.

Wenn du jemals ssh -i ~/.ssh/work_ed25519 -p 2222 -o ServerAliveInterval=30 deploy@203.0.113.10 mehr als zweimal getippt hast, hast du die zehn Minuten, die es kostet, ssh_config zu lernen, schon wieder drin. Es ist die Datei mit dem größten Hebel in deinem SSH-Setup: Sie macht aus dieser ganzen Zeile ssh web1, und sie wird automatisch von ssh, den Dateiübertragungs-Tools scp/sftp/rsync (auf Englisch), git und allem anderen gelesen, das SSH aufruft.

Hier die praktische Tour – die Direktiven, die sich ihren Platz wirklich verdienen, und die Fallstricke, die man kennen sollte.

Wo sie liegt und wie sie gelesen wird

Deine persönliche Konfiguration ist ~/.ssh/config (lege sie an, falls es sie nicht gibt; chmod 600). Es gibt außerdem eine systemweite /etc/ssh/ssh_config. Die Regeln, über die man stolpert:

  • Der erste Treffer gewinnt, nicht der spezifischste. SSH liest von oben nach unten, und der erste Wert, den es für jede Option sieht, ist der, den es nutzt. Setze deine spezifischen Hosts nach oben und breite Vorgaben mit Host * nach unten.
  • Jede Einstellung steht unter einem Host-Block (einem Muster), per Konvention eingerückt (die Einrückung ist nicht Pflicht, aber dein künftiges Ich dankt dir für eine lesbare Datei).

Der Baustein: ein Host-Alias

Host web1
    HostName 203.0.113.10
    User deploy
    Port 2222
    IdentityFile ~/.ssh/work_ed25519

Jetzt expandiert ssh web1 zum vollständigen Befehl. Genauso scp file.tar web1:/srv/, sftp web1 und rsync -a ./dist/ web1:/var/www/. Der Alias ist der ganze Sinn: Benenne den Server einmal, nutze den Namen überall.

Direktiven, die sich ihren Platz verdienen

ProxyJump – Server durch eine Bastion erreichen. Der moderne Ersatz für die alte Beschwörungsformel ProxyCommand ... netcat:

Host db1
    HostName 10.0.0.5          # private address, only reachable from the bastion
    User deploy
    ProxyJump bastion

Host bastion
    HostName bastion.example.com
    User jump

ssh db1 springt jetzt transparent über bastion, um einen Host ohne öffentliche Adresse zu erreichen. Verkette sie mit Kommas (ProxyJump a,b,c) für tiefere Netzwerke.

Keepalives – untätige Sitzungen am Leben halten. Die Lösung für client_loop: send disconnect: Broken pipe, wenn du wegschaust:

Host *
    ServerAliveInterval 30
    ServerAliveCountMax 4

Ein Paket alle 30 Sekunden hält NAT-Router und Firewalls davon ab, deine Verbindung zu vergessen; vier ausbleibende Antworten (zwei Minuten), bevor es aufgibt.

IdentitiesOnly – nur den richtigen Schlüssel anbieten. Wenn du mehrere Schlüssel dabei hast, bietet SSH sie alle an, und ein strenger Server antwortet mit Too many authentication failures. Fixiere einen Schlüssel pro Host und beende das Raten:

Host github.com
    IdentityFile ~/.ssh/personal_ed25519
    IdentitiesOnly yes

AddKeysToAgent – einen passphrasegeschützten Schlüssel einmal entsperren:

Host *
    AddKeysToAgent yes

Muster und Wildcards – eine ganze Flotte in einem Block konfigurieren:

Host *.staging.example.com
    User deploy
    IdentityFile ~/.ssh/staging_ed25519

Host 10.0.*
    ProxyJump bastion

Eine realistische Config, von oben nach unten

# Specific hosts first (first match wins)
Host web1
    HostName 203.0.113.10
    User deploy
    Port 2222
    IdentityFile ~/.ssh/work_ed25519

Host db1
    HostName 10.0.0.5
    User deploy
    ProxyJump bastion

Host bastion
    HostName bastion.example.com
    User jump
    IdentityFile ~/.ssh/work_ed25519

Host github.com
    IdentityFile ~/.ssh/personal_ed25519
    IdentitiesOnly yes

# Broad defaults last
Host *
    ServerAliveInterval 30
    ServerAliveCountMax 4
    AddKeysToAgent yes

Teile sie auf, wenn sie wächst: Include ~/.ssh/config.d/* oben in der Datei lässt dich eine Datei pro Projekt oder Kunde halten.

Zwei Fallstricke

  • „Der erste Treffer gewinnt“ beißt dich, wenn weiter oben ein Block mit Host * einen Wert setzt, den du weiter unten überschreiben wolltest – er überschreibt nicht, weil der frühere Wert schon gewonnen hat. Vorgaben gehören ganz nach unten.
  • Kommentare sind # am Zeilenanfang. Nachgestellte Kommentare hinter einem Wert können bei manchen Optionen als Teil des Werts gelesen werden – halte Kommentare in eigenen Zeilen.

Wenn die Config-Datei nicht mehr reicht

ssh_config ist hervorragend, und jeder sollte eine haben. Ihre Grenzen zeigen sich, wenn das Setup größer wird als eine Textdatei: Du synchronisierst sie von Hand zwischen Maschinen, teilst bereinigte Versionen mit Teamkollegen, merkst dir, welche Passphrase zu welchem Schlüssel gehört, oder versuchst auf einen Blick zu sehen, welcher von vierzig Hosts überhaupt online ist.

Genau diese Naht füllt Termalin. Es behält dieselben Einstellungen pro Host – Hostname, Nutzer, Port, Schlüssel, Jump-Host, Keepalives –, aber am Host als strukturierte Daten, die du in Ordnern und Tags organisierst, entsperrt deine Schlüssel einmalig über einen integrierten Agenten, überprüft jeden Server beim ersten Verbinden und zeigt den Live-Status für jeden Host in der Liste. Es importiert deine vorhandenen PuTTY-Sitzungen, und seine Host-Liste synchronisiert sich Ende-zu-Ende-verschlüsselt zwischen deinen Maschinen. Die Datei skaliert bis zu einem Punkt; ein Client, der den Zustand für dich behält, skaliert darüber hinaus.

So oder so gilt das Prinzip: Benenne einen Server einmal und tippe seine Befehlszeilen-Flags nie wieder ab.


Termalin ist ein kostenloser, plattformübergreifender SSH-Client, der Einstellungen pro Host, Schlüssel und Jump-Hosts für dich verwaltet – lade es herunter oder lies, wie es sicher mit Schlüsseln umgeht.

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