Neu: Jede Funktion mit Schritt-für-Schritt-Anleitung und Screenshots.
Verbindungen

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.

SSH-Tunnel-Konfiguration

FeldHinweis
SSH-HostPflicht.
SSH-PortStandard 22.
SSH-BenutzerPflicht.
AuthentifizierungSSH-Key oder Passwort.
Absoluter Pfad zur Key-DateiNur bei SSH-Key, Pflicht, zum Beispiel /Users/name/.ssh/id_ed25519.
Passphrase (optional)Bei SSH-Key, falls der Key verschlüsselt ist.
SSH-PasswortBei Passwort-Authentifizierung, Pflicht.

SSH-Config verwenden

Du kannst einen SSH-Host aus deiner ~/.ssh/config übernehmen:

SSH-Config-Datei auswählen

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:

SSH-Agent als Authentifizierungsmethode

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

SSH-Sprung-Host konfigurieren

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.1 und 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

MeldungUrsache
„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.