SQLly auf einen Blick: Relay-Proxy-Modus
funktionalFühre den Browser-Build über ein eigenes Relay gegen deine eigenen Datenbanken aus - das Relay hält die Zugangsdaten, die Seite sieht also nie ein Passwort.
das Browser-Build von SQLly läuft normalerweise gegen Beispieldaten in deinem Tab, da eine Webseite keinen Datenbank-Socket öffnen kann. Relay-Proxy-Modus gibt ihm echte Server: ein sqlly-relay du ausführst, bekommt ein
Zugangsdaten-Datei, und der Browser-Build fragt, mit der Adresse dieses Relays geöffnet, jeden Server und jede Datenbank in der Datei ab - Objekt-Explorer, IntelliSense, Ausführungspläne und Zeilenbearbeitung inklusive -, während die Passwörter nie den Relay-Host verlassen.
Wie es zusammenpasst
browser (SQLly on a page) --wss--> sqlly-relay proxy --local--> SQLly engine --TDS / PG / MySQL / ...--> your databases
holds the credential file one per browser session
- Das Relay stellt eine Zugangsdaten-Datei bereit. Jede darin enthaltene Verbindung – Server, Datenbank, Login und Passwort, gemeinsam genutzte Logins, SSH-Tunnel und Proxys sowie die Client-, Projekt- und Umgebungsbezeichnungen – ist für den Browser erreichbar. Nichts anderes.
- Eine Engine pro Sitzung. Jede Browsersitzung bekommt ihre eigene SQLly-Engine auf dem Relay-Host, gestartet in einem stark eingeschränkten Modus, der nur Verbindungen aus der Datei öffnet. Eine Anfrage, die ihren eigenen Server angibt oder ein eigenes Passwort mitbringt, wird abgelehnt.
- Der Browser bekommt Namen, keine Secrets. Er erhält die Verbindungsliste mit entfernten Passwörtern, Tunnel-Einstellungen und Tokens und speichert die Liste niemals; das Relay sendet sie bei jedem Seitenaufruf frisch.
- Die andere Aufgabe des Relays bleibt unberührt. Der Proxy ist ein separater Listener, den man extra einschalten muss. Ein Relay, das ihn nicht aktiviert, leitet Via-Relay-Datenverkehr genau wie bisher weiter.
Richten Sie das Relay ein
Auf einem Host, der die Datenbanken erreichen kann und sqlly-cli neben installiert
sqlly-relay, erstelle eine Anmeldedatei (exportiere eine aus der Desktop-App mit
Datei → Verbindungen mit Zugangsdaten exportieren…, oder schreib es von Hand) und starte das Relay mit den Proxy-Flags, die zu seiner üblichen Konfiguration dazukommen:
sqlly-relay \ --tls-cert /certs/relay.crt --tls-key /certs/relay.key \ --proxy-credentials /etc/sqlly/browser-connections.json \ --proxy-token 'a-long-random-secret' \ --proxy-bind 0.0.0.0:8444 \ --proxy-allowed-origins https://sqlly.app
| Flag | Was es bewirkt |
|---|---|
--proxy-credentials | Die Zugangsdaten-Datei. Ihr Setzen schaltet den Proxy ein. Die Datei wird bei jeder neuen Browsersitzung neu gelesen, sodass Änderungen ohne Neustart greifen. |
--proxy-token | Ein gemeinsam genutztes Geheimnis, das der Browser vorlegen muss. Erforderlich: Ohne es wird der Start verweigert, außer du übergibst --proxy-insecure-no-token, der jede gelistete Datenbank jedem bereitstellt, der den Port erreichen kann. |
--proxy-bind | Wo der Proxy lauscht; standardmäßig Port 8444. Er verwendet das TLS-Zertifikat des Relays für wss://; --proxy-plain bereitstellt ws:// für lokale Tests oder hinter einem TLS-terminierenden Reverse-Proxy. |
--proxy-allowed-origins | Kommagetrennte Web-Ursprünge, die eine Sitzung öffnen dürfen, sodass nur Seiten, die du hostest, den Proxy nutzen können. Weglassen, um jeden Ursprung zu erlauben (das Token gilt weiterhin). |
--proxy-max-sessions | Wie viele Browsersitzungen gleichzeitig geöffnet sein dürfen (jede ist ein Engine-Prozess); der Standardwert ist 32. Ein voller Proxy fordert neue Sitzungen auf, es später erneut zu versuchen. |
--proxy-engine-binary | Wo sqlly-cli ist, wenn es nicht neben sqlly-relay oder auf dem PATH. |
Jedes Flag hat eine Form als Umgebungsvariable (RELAY_PROXY_CREDENTIALS,
RELAY_PROXY_TOKENusw.) für Container-Bereitstellungen. Das Relay-Container-Image enthält die Engine, wenn es mit --build-arg WITH_PROXY_ENGINE=1.
Zwei Regeln unterscheiden sich von einem Desktop-Import: gemeinsame Logins und Tunnel-Profile müssen in derselben Datei definiert werden (das Relay hat keine gespeicherten Verbindungen, auf die zurückgegriffen werden kann), und eine
via-relay Route auf einer Verbindung wird ignoriert, weil der Relay-Host die Verbindung zu jedem Server selbst aufbaut.
Den Browser-Build damit öffnen
Füge die Proxy-Adresse und das Token zur URL des Browser-Builds hinzu:
https://sqlly.app/app/?proxy=wss://relay.example.com:8444/proxy&token=a-long-random-secret
Eine Seite, die den Build einbettet, kann festlegen SQLLY_PROXY_URL und
SQLLY_PROXY_TOKEN als globale Variablen, bevor die App startet, anstatt sie in die Adressleiste zu setzen. Beim Laden verbindet sich die App, die Statuszeile nennt das Relay und wie viele Verbindungen es bedient, und diese Verbindungen erscheinen gebrauchsfertig im Explorer. Die Beispieldatenbanken werden in diesem Modus gar nicht heruntergeladen.
Was sich in der App ändert
- Verbindungen sind schreibgeschützt. Die Liste gehört zum Relay. Server hinzufügen, Duplizieren, Löschen und Verbindungen importieren sind deaktiviert; die Schaltflächen des Verbindungsmanagers zum Hinzufügen, Entfernen und Duplizieren und seine Client-, Projekt- und Umgebungs-Editoren sind gesperrt; und das Öffnen einer Verbindung zeigt sie als Verbindung anzeigen mit deaktiviertem Speichern und einem Hinweis, dass das Relay die Zugangsdaten vorhält. Ändere die Anmeldedatei auf dem Relay, um zu ändern, was die Benutzer sehen.
- „Verbindung testen“ funktioniert weiterhin - sie läuft durch den Proxy wie jede Abfrage, ebenso wie alle Abfragefunktionen, der Objektexplorer, die IntelliSense-Katalogsynchronisierung, Ausführungspläne, Skripterstellung und Zeilenbearbeitung.
- Beschriftungen werden mit übernommen. Kunden-, Projekt- und Umgebungsnamen, Farben und Sicherheitsschalter aus der Datei gruppieren den Explorer genauso wie auf dem Desktop; auf Symbole wird verzichtet, um die Seite schlank zu halten.
- Wenn das Relay weg ist - sagt die Statuszeile, und Abfragen über Proxy-Verbindungen scheitern mit einer klaren Meldung, bis die Seite neu geladen wird.