Ein lokaler SSH-Tunnel, der mit ssh -L 5432:localhost:5432 user@server erstellt wird, öffnet Port 5432 auf Ihrem Rechner und leitet jede Verbindung verschlüsselt innerhalb von SSH an das PostgreSQL des Servers weiter. Die Datenbank lauscht weiterhin nur auf dem entfernten localhost, ohne einen ins Internet geöffneten Port, und Ihr Client verbindet sich mit 127.0.0.1, als wäre sie lokal.

So funktioniert ssh -L 5432:localhost:5432 Schritt für Schritt

Die Syntax von -L lautet [bind_address:]local_port:dest_host:dest_port, und der Zielhost wird vom SSH-Server aus aufgelöst, nicht von Ihrem Rechner. Deshalb bedeutet das localhost in der Mitte „die entfernte Maschine“. Die vollständige Referenz finden Sie in der offiziellen Manpage von ssh.

# Foreground tunnel, no remote shell
ssh -N -L 5432:localhost:5432 [email protected]

# In another terminal, connect as if PostgreSQL were local
psql -h 127.0.0.1 -p 5432 -U app db_name
  • -L 5432:localhost:5432: lauscht lokal auf 5432 und stellt den Verkehr an Port 5432 auf dem Server zu.
  • -N: führt keinen entfernten Befehl aus; die Verbindung existiert nur, um den Tunnel zu tragen.
  • -f (optional): schickt ssh nach der Authentifizierung in den Hintergrund.

Läuft die Datenbank auf einem anderen Host im internen Netz, ändern Sie das Ziel: ssh -N -L 5432:db.internal:5432 admin@bastion. Der Abschnitt zwischen dem Bastion-Host und db.internal wird nicht mehr von SSH verschlüsselt, tun Sie das also nur in einem vertrauenswürdigen Netz. Standardmäßig bindet ssh den lokalen Port an die Loopback-Schnittstelle; legen Sie ihn nicht auf 0.0.0.0 offen und aktivieren Sie GatewayPorts nicht, es sei denn, Sie wissen, wer Ihren Rechner sonst noch erreichen kann.

Belegt bereits ein lokales PostgreSQL den Port 5432, meldet ssh bind: Address already in use. Wählen Sie einen anderen lokalen Port, etwa -L 15432:localhost:5432, und verbinden Sie sich mit -p 15432.

LocalForward in ~/.ssh/config: der SSH-Tunnel, ohne sich Flags merken zu müssen

LocalForward ist die ssh_config-Direktive, die -L entspricht: zuerst der lokale Port, dann das Ziel host:port, getrennt durch ein Leerzeichen.

Host db-prod
    HostName server.example.com
    User admin
    IdentityFile ~/.ssh/id_ed25519
    LocalForward 15432 localhost:5432
    ExitOnForwardFailure yes
    ServerAliveInterval 30

Mit diesem Block tippen Sie nur noch ssh -N db-prod. Drei Entscheidungen im Beispiel:

  1. Lokaler Port 15432: vermeidet einen Konflikt mit einem PostgreSQL, das bereits auf Port 5432 Ihres Rechners lauscht.
  2. ExitOnForwardFailure yes: Ist der lokale Port belegt, beendet sich ssh, statt eine Sitzung zu öffnen, die in Ordnung aussieht, aber keinen Tunnel hat.
  3. ServerAliveInterval 30: sendet alle 30 Sekunden ein Keepalive, damit eine tote Verbindung früher erkannt wird.

OpenSSH ist bei Berechtigungen streng: ~/.ssh auf 700 und der private Schlüssel auf 600. Alle Direktiven sind in der offiziellen ssh_config-Dokumentation aufgeführt.

Prüfen, ob der lokale SSH-Tunnel lauscht und verbindet

Das klassische Symptom eines defekten Tunnels ist Connection refused im Datenbankclient; bevor Sie PostgreSQL anfassen, testen Sie jedes Ende einzeln.

# On your machine: is anything listening on the local port?
ss -ltn | grep 15432              # Linux
lsof -iTCP:15432 -sTCP:LISTEN     # macOS

# On the server: is PostgreSQL listening on loopback?
ss -ltn | grep 5432

# Debug ssh itself
ssh -v -N db-prod

Mit -v sehen Sie, ob der Server die Weiterleitung mit der Meldung administratively prohibited ablehnt. In sshd_config deaktiviert AllowTcpForwarding no Tunnel; prüfen Sie außerdem, ob Match-Blöcke sie für bestimmte Benutzer einschränken.

Lokaler SSH-Tunnel vom Smartphone: was sich gegenüber dem Desktop ändert

Mosh macht kein Port-Forwarding: Es überträgt die Sitzung per UDP, standardmäßig auf den Ports 60000-61000, und nutzt SSH nur, um mosh-server zu starten. Ein -L-Tunnel braucht eine klassische SSH-Verbindung, die so lange offen bleibt, wie Sie ihn nutzen, und iOS und Android können Apps anhalten, die in den Hintergrund wechseln.

ZugriffsmethodeLeitet Ports weiter?VoraussetzungenAm besten geeignet für
ssh -L auf dem DesktopJa, TCP innerhalb von SSHErreichbarer Port 22 und aktiviertes AllowTcpForwardingGrafische Datenbankclients, Migrationen von Ihrem Rechner aus
Mosh auf iOS/AndroidNeinUDP 60000-61000 und mosh-server auf dem HostEine Shell, die den Wechsel von WLAN zu mobilen Daten übersteht
psql auf dem Server, in tmuxNicht nötigSSH- oder Mosh-Sitzung und installiertes psqlSchnelle Abfragen vom Smartphone
Mesh-Netz (Prialo, Tailscale)Nein; direkter Zugriff über private IPEin Agent auf jedem GerätRegelmäßiger Zugriff ohne offene Ports oder Tunnel

Vom Smartphone aus ist der praktische Weg meist, sich per Mosh zu verbinden, sich an tmux anzuhängen und psql direkt auf dem Server auszuführen. Mit einem mobilen SSH- und Mosh-Terminal wie termi1 übersteht die Sitzung Netzwechsel, tmux hält die lange Abfrage am Laufen, die Sie gestartet haben, und die integrierte Tastatur bietet Ctrl, Tab und Pfeiltasten, um durch den psql-Verlauf zu blättern oder mit Ctrl+D zu beenden. Die KI macht aus „verbinde dich mit der App-Datenbank“ den passenden Befehl und tippt ihn in den Prompt, ohne Enter zu drücken; bei Verbindungen, die als Produktion markiert sind, hält Production Guard alles zurück, was Daten löscht oder ändert. Mit dem integrierten SFTP laden Sie eine pg_dump-Datei herunter, ohne die Sitzung zu verlassen.

Wann Sie keinen lokalen SSH-Tunnel (-L) verwenden sollten

Ein -L-Tunnel ist eine punktuelle Lösung für eine Person und eine Sitzung; außerhalb dieses Falls gibt es meist eine bessere Option.

  • Dauerhafter oder gemeinsamer Zugriff: Wenn mehrere Personen die Datenbank täglich brauchen, ist ein privates Netz ohne offene Ports wie Prialo oder Tailscale besser, als einzelne Tunnel zu pflegen.
  • Mosh-Sitzungen: Mosh leitet keine Ports weiter; wenn Sie den Tunnel brauchen, öffnen Sie eine separate SSH-Verbindung.
  • Binden an 0.0.0.0 oder Nutzung von GatewayPorts: Damit wird Ihr Laptop für das gesamte lokale Netz zum Gateway zur Datenbank.
  • Server mit AllowTcpForwarding no: Das ist eine Richtlinie des Admins, kein Fehler, den man umgehen sollte.
  • Einmalige Abfragen vom Smartphone: psql auf dem Server auszuführen ist einfacher, als einen Tunnel am Leben zu halten.

Häufig gestellte Fragen

Was bedeutet localhost in ssh -L 5432:localhost:5432?

In ssh -L 5432:localhost:5432 wird localhost vom SSH-Server aufgelöst, nicht von Ihrem Rechner. Es verweist daher auf das PostgreSQL, das auf der Loopback-Schnittstelle des entfernten Hosts lauscht. Um eine andere Maschine im internen Netz zu erreichen, ersetzen Sie es durch den Namen oder die private IP dieses Hosts.

Wie lasse ich einen lokalen SSH-Tunnel im Hintergrund laufen?

Ein lokaler SSH-Tunnel läuft mit ssh -f -N -L 15432:localhost:5432 admin@server im Hintergrund: -f schickt ssh nach der Authentifizierung in den Hintergrund und -N verzichtet auf die entfernte Shell. Zum Schließen finden Sie den Prozess mit pgrep -f 15432 und beenden ihn mit kill.

Kann Mosh Ports wie ein SSH-Tunnel weiterleiten?

Mosh kann keine Ports weiterleiten: Es unterstützt weder Port-Forwarding noch X11-Forwarding und überträgt die Sitzung per UDP, standardmäßig auf den Ports 60000-61000. Um einen Port weiterzuleiten, ist eine normale SSH-Verbindung nötig, die gleichzeitig neben der Mosh-Sitzung laufen kann.

Ist ein lokaler SSH-Tunnel zu einer Produktionsdatenbank sicher?

Ein lokaler SSH-Tunnel zur Produktion verschlüsselt den Verkehr und vermeidet, dass der Datenbankport im Internet offenliegt, aber jeder Prozess auf Ihrem Rechner kann den weitergeleiteten Port nutzen, solange er offen ist. Binden Sie ihn nur an 127.0.0.1, schließen Sie ihn nach getaner Arbeit und nutzen Sie einen Datenbankbenutzer mit minimalen Rechten.