termal.in

← Blog

Über einen SSH-Tunnel auf eine Datenbank hinter der Firewall zugreifen – ohne den Port freizugeben

· Termalin Team sshport-forwardingdatabasetunnelingsecurity

Du hast irgendwo auf einem Server eine Datenbank und willst sie von deinem Laptop erreichen – eine Abfrage ausführen, eine GUI darauf richten, ein Migrationswerkzeug verbinden lassen. Sie lauscht auf 5432 (Postgres) oder 3306 (MySQL), und im Moment kommt dein Laptop nicht an sie heran, weil die Datenbank in einem privaten Netz sitzt, ohne Route von außen. Also suchst du nach der schnellsten Brücke, und das Internet bietet eine Abkürzung, die sofort funktioniert und dich klammheimlich das kostet, was das private Netz schützen sollte.

Der Fehler: den Datenbank-Port für alle öffnen

Die Abkürzung ist, die Datenbank erreichbar zu machen: Bind sie an 0.0.0.0 statt an 127.0.0.1, reiß ein Loch in die Security-Group für Port 5432, und schon kannst du dich von überall verbinden. Es klappt beim ersten Versuch, und genau das macht es gefährlich.

Ein Datenbank-Port im öffentlichen Internet ist ein dauerhaftes Ziel. Postgres und MySQL sprechen auf wohlbekannten Ports, und das ganze Internet wird fortwährend danach gescannt – ein Listener auf 5432 sammelt schon wenige Minuten nach dem Start Login-Versuche ein. Das Einzige zwischen dem Internet und deinen Daten ist jetzt das Passwort der Datenbank selbst, eine Protokoll-Eigenheit oder ein CVE. Verwaltete Datenbanken lassen das nicht aus Versehen zu: RDS, Cloud SQL und der Rest landen standardmäßig in einem privaten Subnetz ohne öffentliche IP, gerade weil eine Datenbank das Letzte ist, was man dem Internet zuwenden will. Sie trotzdem zu öffnen – eine 0.0.0.0/0-Regel „nur für jetzt“ – verschenkt das ganze Design für ein paar gesparte Minuten. Die Korrektur kostet etwa genauso wenig und gibt nichts auf.

Was ein SSH-Tunnel zu einer Datenbank tatsächlich macht

Mit ziemlicher Sicherheit hast du schon einen Weg in dieses Netz: einen SSH-Login auf einen Server, der die Datenbank sehen kann – den App-Server, einen Bastion-Host, irgendeine Kiste im selben Subnetz. SSH-Portweiterleitung lässt dich diese Reichweite ausleihen, ohne irgendetwas Neues freizugeben.

ssh -L 5432:db.internal:5432 deploy@bastion.example.com

Lies es von links nach rechts: Öffne Port 5432 auf meinem Laptop und leite alles, was dort ankommt, an db.internal:5432 weiter – so wie der Bastion-Host es auflöst. Dann richtest du deinen Client auf localhost:

psql -h 127.0.0.1 -p 5432 -U app appdb

psql verbindet sich mit deiner eigenen Maschine; SSH trägt die Bytes verschlüsselt über die Verbindung, die du ohnehin schon hattest; der Bastion-Host öffnet eine einfache Verbindung zu db.internal von innerhalb des privaten Netzes, wo er das darf. Aus Sicht der Datenbank hat sich nichts geändert – sie nimmt weiterhin nur Verbindungen aus ihrem eigenen Netz an. Und nirgends im Internet wurde ein neuer Port geöffnet. Du hast Erreichbarkeit ohne Exposition bekommen.

Das eine Detail, über das jeder stolpert: db.internal wird auf der anderen Seite aufgelöst, vom Bastion-Host, nicht von deinem Laptop. Es kann ein Name sein, den nur das private Netz kennt, oder eine rohe Adresse, zu der dein Laptop keine Route hat:

# the database only the bastion can see, by private IP
ssh -L 5432:10.0.0.9:5432 deploy@bastion.example.com

Das ist der ganze Trick, ausführlich behandelt – lokal, remote und dynamisch – in SSH-Portweiterleitung erklärt. Hier brauchen wir nur den lokalen Fall (-L).

Der Bastion-Host ist, wo der Tunnel beginnt

Die Kiste, durch die du tunnelst, ist meist dasselbe Gateway, durch das du ohnehin springst, um eine Shell im privaten Netz zu bekommen. Wenn du deine internen Server mit ProxyJump erreichst, hast du das Teil, das ein Datenbank-Tunnel braucht, schon. Die beiden ergänzen sich: ProxyJump bringt deine Shell auf einen Host hinter dem Gateway, und -L holt den Port eines Dienstes von der anderen Seite zurück auf deinen localhost. Wenn du durch zwei Gateways springen musst, verkette sie:

ssh -J bastion.example.com -L 5432:db.internal:5432 deploy@app.internal

Warum Leute den Tunnel trotzdem falsch machen

Der Mechanismus ist sauber. Beim alltäglichen Betrieb von Tunneln per Hand franst es aus:

  • Der Befehl vergammelt in deinem Shell-Verlauf. Nächste Woche rekonstruierst du, welcher lokale Port auf welche Datenbank zeigte, auf welchem Bastion-Host, in welcher Umgebung. Staging und Produktion wollen beide 5432; auf deinem Laptop bekommst du eins nach dem anderen.
  • Der lokale Port ist für jeden Prozess auf deiner Maschine offen. -L 5432 lauscht auf 127.0.0.1:5432 – jedes Programm auf deinem Laptop kann jetzt durch ihn die Produktionsdatenbank erreichen, ohne SSH-Authentifizierung, solange der Tunnel steht. (Und -L 0.0.0.0:5432:... setzt sie klammheimlich deinem ganzen LAN aus.)
  • Der Tunnel stirbt mitten in der Sitzung und nimmt die Abfrage mit. Ein Ruhezustand des Laptops, ein WLAN-Wechsel, ein Idle-Timeout, und die Weiterleitung bricht stillschweigend weg – üblicherweise gelöst mit -N, -f und ServerAliveInterval 30, von denen dir beim ersten Mal keines eingefallen ist.
  • Ein ssh -L pro Datenbank. Ein Primary, eine Read-Replica, eine MySQL-Kiste, ein Redis – das sind vier Tunnel-Befehle auf vier lokalen Ports, jeder nach jedem Abbruch neu gestartet, und keiner sagt dir auf einen Blick, ob er noch steht.

Ein gespeicherter ssh_config-Block – LocalForward, ein ProxyJump, Keepalives – glättet das meiste davon. Aber du startest ihn immer noch von Hand, beobachtest ihn immer noch, richtest deinen Client immer noch selbst auf den richtigen Loopback-Port.

Wie Termalins Data-Client es macht

Termalin ist ein plattformübergreifender SSH-Client, der kürzlich einen Data-Client bekommen hat – einen Datenbank-Client in der Desktop-App und im Web-Kabinett unter termal.in/account. Du fügst eine Datenbank so hinzu, wie du einen Server hinzufügen würdest: Wähl die Engine, gib ihr einen Host, einen Port und Zugangsdaten, optional eine Standarddatenbank. Er spricht eine breite Palette von Engines – PostgreSQL, MySQL, SQL Server, ClickHouse, MongoDB, Redis, Elasticsearch, Neo4j und mehr. Der Teil, um den es in diesem Artikel geht, ist, was passiert, wenn diese Datenbank hinter einer Firewall liegt – du öffnest keinen Port und führst ssh -L nicht von Hand aus:

  • Eine Datenbank in einem Netz, zu dem du schon eine Route hast, erreichst du direkt. Termalin wählt den Host und Port, den du angegeben hast.
  • Eine Datenbank hinter einer Firewall erreichst du durch einen Tunnel. Auf dem Desktop hängst du einen gespeicherten SSH-Host – deinen Bastion-Host, Jump-Host und alles – an die Verbindung; Termalin öffnet eine lokale Weiterleitung auf dieser Sitzung und richtet den Treiber für dich auf das entstehende 127.0.0.1:<port>, sodass eine Datenbank, die nur auf localhost lauscht oder hinter einem VPN sitzt, durchkommt, als wäre sie lokal. Im Web-Kabinett erledigt dieselbe Aufgabe ein Connector: Termalin öffnet die SSH-Sitzung des Connectors, leitet einen Loopback-Port durch ihn weiter und führt die Abfrage darüber aus. So oder so trägt die verschlüsselte SSH-Sitzung den Verkehr zu einer Kiste, die die Datenbank sehen kann, und die Datenbank selbst zeigt nie zum Internet.

So behältst du, wofür das private Subnetz da war – eine Datenbank, die nur aus ihrem eigenen Netz erreichbar ist –, und bekommst zugleich einen funktionierenden Abfrage-Editor auf deinem Laptop. Der Tunnel kommt mit der Verbindung hoch und geht runter, wenn du sie schließt, samt dem Loopback-Port, den er geöffnet hat. Es gibt keinen Befehl zu merken, keine Weiterleitung zu babysitten und keine 0.0.0.0/0-Regel, die in einer Security-Group zurückbleibt.

Ein Tunnel ist Erreichbarkeit, keine Autorisierung

Lohnt sich klar zu sagen, weil es das Eine ist, was ein Tunnel nicht tut: Die Verbindung zur Datenbank zu bekommen, ist nicht dasselbe wie zu entscheiden, was sie dort tun darf. Ein Tunnel ist ein Draht, und ein Draht ist neutral – wer am anderen Ende sitzt, verbindet sich trotzdem als der Datenbankbenutzer, den du herausgegeben hast. Richte die Verbindung auf eine Rolle mit minimalen Rechten, und wenn ein Agent am anderen Ende sitzen soll, halte das als separate Entscheidung – das Thema von einem KI-Agenten nur lesenden Datenbankzugriff geben (auf Englisch), nicht dieses hier.

Wo Termalin hineinpasst

Jeder Entwickler sollte ssh -L im Schlaf beherrschen – es ist der ehrliche Weg, eine Datenbank zu erreichen, ohne sie der Welt zu öffnen, und das Denkmodell (öffne einen Port auf meiner Seite, leite ihn an etwas weiter, das die andere Seite sehen kann) ist das ganze Spiel. Die Reibung war nie das Konzept; es war die Buchführung: die Befehle in deinem Verlauf, die Ports, die du jonglierst, die Tunnel, die abbrechen, die eine Weiterleitung pro Datenbank.

Termalin hält den Tunnel und die Datenbankverbindung als eine gespeicherte Sache zusammen. Häng einen Jump-Host oder einen Connector an, und eine Datenbank in einem privaten Subnetz zu erreichen ist ein Klick – die Weiterleitung öffnet sich mit der Verbindung, der Treiber zeigt für dich auf den Loopback-Port, und die Datenbank bleibt genau da, wo sie hingehört: hinter der Firewall, nur auf ihr eigenes Netz hörend.


Termalin ist ein kostenloser, plattformübergreifender SSH- und Datenbank-Client mit eingebauten Tunneln, Jump-Hosts und einem Data-Client – lade es herunter oder sieh, wie es deine Schlüssel und Zugangsdaten 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