SSH-Tunnel
Datenbanken über einen SSH-Server erreichen, mit Key oder Passwort und Host-Key-Prüfung.
Ein SSH-Tunnel leitet die Datenbankverbindung über einen SSH-Server. Verfügbar für alle Engines außer SQLite, libSQL und DuckDB.
Einrichten
Im Verbindungsdialog Erweitert aufklappen und SSH-Tunnel einschalten.

| Feld | Hinweis |
|---|---|
| SSH-Host | Pflicht. |
| SSH-Port | Standard 22. |
| SSH-Benutzer | Pflicht. |
| Authentifizierung | SSH-Key oder Passwort. |
| Absoluter Pfad zur Key-Datei | Nur bei SSH-Key, Pflicht, zum Beispiel /Users/name/.ssh/id_ed25519. |
| Passphrase (optional) | Bei SSH-Key, falls der Key verschlüsselt ist. |
| SSH-Passwort | Bei Passwort-Authentifizierung, Pflicht. |
SSH-Config verwenden
Du kannst einen SSH-Host aus deiner ~/.ssh/config übernehmen:

Klicke auf Aus ~/.ssh/config übernehmen und wähle einen Host aus der Liste. l8db übernimmt Host, User, Port und Identity-Datei.
SSH-Agent verwenden
Statt den Pfad zur Key-Datei zu speichern, kann l8db einen SSH-Agent nutzen:

Host und Port im oberen Teil des Dialogs sind die Adresse der Datenbank aus Sicht des
SSH-Servers, zum Beispiel localhost oder eine interne IP. Fehlt der Port, nimmt l8db den
Standardport des Produkts.
Passwort und Passphrase liegen im Schlüsselbund.
SSH-Sprung-Hosts (ProxyJump)
Wenn die Datenbank nur über mehrere SSH-Hops erreichbar ist, füge Sprung-Hosts hinzu. l8db leitet die Verbindung durch alle Hops weiter:
l8db → Sprung 1 → Sprung 2 → SSH-Host → Datenbank
Ablauf
- Testen und Schemas scannen öffnen einen temporären Tunnel und schließen ihn danach.
- Beim Verbinden öffnet l8db einen Tunnel auf einem freien lokalen Port an
127.0.0.1und verbindet die Datenbank über diesen Port. - Beim Trennen oder beim Wechsel auf eine andere Verbindung wird der Tunnel geschlossen.
- Scheitert der Tunnel, scheitert die Verbindung. l8db verbindet nie ersatzweise direkt.
- Der Aufbau der SSH-Verbindung bricht nach 15 Sekunden ab. Ohne Aktivität trennt der Tunnel nach 5 Minuten.
- Bei PostgreSQL bleibt der ursprüngliche Hostname in der Verbindung erhalten, nur die Adresse zeigt auf den Tunnel. Die TLS-Prüfung des Hostnamens funktioniert deshalb auch durch den Tunnel.
Die Karte zeigt bei SSH-Verbindungen das Badge SSH.
Host-Key-Prüfung
l8db prüft den Host-Key des SSH-Servers gegen ~/.ssh/known_hosts.
- Bekannter und passender Key: Verbindung wird aufgebaut.
- Unbekannter Key: Die Verbindung wird abgelehnt, die Meldung nennt den Fingerabdruck (SHA-256).
- Mit Neue SSH-Host-Keys akzeptieren unter Einstellungen → Sicherheit & SSH speichert
l8db unbekannte Keys beim ersten Verbinden in
known_hosts(Trust on First Use). Standard: aus.
SSH-Zertifikate als Host-Keys werden nicht unterstützt.
Häufige Fehler
| Meldung | Ursache |
|---|---|
| „SSH-Host und SSH-Benutzer sind erforderlich.“ | Pflichtfeld leer. |
| „Wähle eine SSH-Key-Datei.“ | Authentifizierung SSH-Key ohne Pfad. |
| „Das SSH-Passwort fehlt.“ | Authentifizierung Passwort ohne Passwort. |
| „SSH-Key-Datei fehlt – bitte Verbindung bearbeiten.“ | Beim Verbinden fehlt der Key-Pfad. |
| „SSH-Passwort fehlt – bitte Verbindung bearbeiten und erneut speichern.“ | Beim Verbinden ist kein SSH-Passwort gespeichert. |
| „SSH-Authentifizierung abgelehnt (Benutzer, Passwort oder Key prüfen).“ | Der Server lehnt die Anmeldung ab. |
| „Unbekannter SSH-Host-Key für host:port …“ | Host-Key nicht in known_hosts, siehe oben. |
| „SSH-Verbindung hat länger als 15 Sekunden gedauert.“ | Host nicht erreichbar oder Firewall. |