Skip to main content
SQLOZ
Features Dokumentation Preise Roadmap Blog Unsere Geschichte Im Mac App Store erhältlich
Chapter 2 Core & Getting Started

Kapitel 2: Verbindungen und Tunnel

Hinweis: Dieses Kapitel behandelt direkte Datenbankverbindungen, SSH-Jump-Host-Tunnel, HTTP-PHP-Tunnel (sqloz-tunnel.php), Umgebungsfarbmarkierungen und die sichere Speicherung von Zugangsdaten im macOS Keychain.

2.1 Direkte Verbindung herstellen

  1. Cmd + N drücken oder Ablage → Neue Verbindung… öffnen.
  2. Im Tab Allgemein folgende Felder ausfüllen:
    • Verbindungsname, Motor (MySQL/PostgreSQL/SQLite), Host, Port, Benutzer, Passwort.
  3. Verbindung testen → Nach Bestätigung Speichern und verbinden.

2.2 SSH-Jump-Host-Tunnel

Für Umgebungen, in denen der Datenbankserver nur über einen Bastion Host erreichbar ist:

[SQLOZ] --(SSH-Tunnel / Port 22)--> [SSH Jump Host] --(Lokales Netz)--> [Datenbankserver]

Im Tab SSH-Tunnel:

  1. SSH-Tunnel aktivieren ankreuzen.
  2. SSH-Host, Port (Standard: 22) und Benutzername eingeben.
  3. Authentifizierungsmethode wählen: Private Key (empfohlen) oder Passwort.
  4. Verbindung testen → Tunnel wird im Hintergrund geöffnet.

2.3 HTTP-PHP-Tunnel (sqloz-tunnel.php)

Für Shared-Hosting-Umgebungen (cPanel/DirectAdmin), bei denen Port 3306 nach außen gesperrt und kein SSH-Zugang vorhanden ist:

[SQLOZ] --(HTTPS POST / Token-verschlüsselt)--> [sqloz-tunnel.php] --(localhost:3306)--> [MySQL-Server]

Einrichtung:

  1. sqloz-tunnel.php in den Web-Ordner des Hosting-Accounts hochladen (z. B. public_html/).
  2. $TOKEN = "geheimesPasswort"; in der Datei durch einen starken geheimen Schlüssel ersetzen.
  3. In SQLOZ-Verbindungseinstellungen → HTTP-Tunnel:
    • Tunnel-URL: https://example.com/sqloz-tunnel.php
    • Gemeinsames Geheimnis: Der in der Datei festgelegte Token.
  4. Verbindung testen.

Wichtig: Datenbankbenutzername und -passwort werden niemals in sqloz-tunnel.php eingetragen - nur der SQTUNNEL_TOKEN.

Konfiguration über Umgebungsvariablen

UmgebungsvariableBeschreibungStandard
SQTUNNEL_HOSTZiel-MySQL-Serveradresse127.0.0.1
SQTUNNEL_PORTZiel-MySQL-Serverport3306
SQTUNNEL_TOKENGeheimer ZugriffsschlüsselMuss geändert werden
SQTUNNEL_MAX_SESSIONSMax. gleichzeitige Sitzungen16

Warnung: Das Standard-Token 'CHANGE_ME_to_a_long_random_string' muss geändert werden - sonst verweigert das Skript den Betrieb und gibt HTTP 500 zurück.

2.4 Umgebungsfarbmarkierungen

Im Tab Allgemein unter Umgebungsfarbe eine Farbe für jede Umgebung zuweisen:

  • Prod (Rot - #E8334A): Produktionsserver.
  • Staging (Orange - #FF9500): Test- und Pre-Production-Umgebungen.
  • Dev (Grün - #34C759): Lokale Entwicklungsumgebung.
  • Test (Blau - #007AFF) und Sandbox (Lila - #AF52DE).

2.5 Sichere Zugangsdatenspeicherung

SQLOZ speichert Datenbank- und SSH-Passwörter niemals in Textdateien oder Logs - alle sensiblen Zugangsdaten werden im hardware-verschlüsselten macOS Keychain gespeichert.

Verwandte Themen