Schnellstart
Führe das SQLly-Embedded-Paket in fünf Minuten auf localhost aus: starte die Bridge und die Beispiel-App, verknüpfe eine Lizenz, füge ein Profil hinzu und öffne SQLly als Benutzer.
Das führt das gesamte SQLly-Embedded-Paket auf einer Maschine aus: die Bridge, ihre Engine und die Beispiel-Admin-App. Alles bleibt auf localhost, und die kostenlose Testversion auf deinem sqlly.app-Konto deckt das ab. Du brauchst Node.js 20 oder neuer sowie eine Datenbank, die SQLly erreichen kann.
Führe es aus
-
Herunterladen und entpacken das SQLly Embedded-Paket für deine Plattform von Downloads (Linux x86-64 und arm64, macOS Apple Silicon, Windows x86-64 und arm64). Unter Linux entpackst du mit
tar -xzfsodass die ausführbaren Dateien ihre Berechtigungen behalten.Zum Skripten hat jede Plattform einen stabilen Link, der immer das neueste Paket für diese Plattform ausliefert. Wenn ein Release für deine Plattform nicht gebaut wurde, liefert der Link das neueste, für das er gebaut wurde.
Plattform Neuestes Paket Linux x86-64 https://sqlly.app/download/embedded/latest/linux-amd64Linux arm64 https://sqlly.app/download/embedded/latest/linux-arm64macOS Apple Silicon https://sqlly.app/download/embedded/latest/macos-arm64Windows x86-64 https://sqlly.app/download/embedded/latest/windows-amd64Windows arm64 https://sqlly.app/download/embedded/latest/windows-arm64curl -fsSL -o sqlly-embedded.tar.gz https://sqlly.app/download/embedded/latest/linux-amd64 tar -xzf sqlly-embedded.tar.gzHinzufügen
/versionzu einem davon (zum Beispiel/download/embedded/latest/linux-amd64/version) um die Version und den Dateinamen als JSON zu erhalten, ohne herunterzuladen. -
Alles starten aus dem
macOS / Linuxsqlly-embeddedOrdner:
Windows./start-sample.shstart-sample.cmdDas Skript erstellt
.envvon.env.example, überprüft Node.js, erzeugt beim ersten Start das gemeinsame Verwaltungstoken, startet die Bridge, wartet auf deren Management-API und startet die Beispiel-App aufhttp://127.0.0.1:8090. -
Melde dich als Administrator an unter http://127.0.0.1:8090/admin mit
sqlly-admin/GoodLittlePiggy. (Die Beispiel-App lauscht auf nichts außer Loopback, bis du dieses Passwort änderst.) -
Eine Lizenz verknüpfen. Ein Status, klicke auf Mit sqlly.app verbinden, dann Zum Genehmigen sqlly.app öffnen. Melde dich bei sqlly.app an, prüfe, ob der Code mit dem auf deiner Admin-Seite übereinstimmt, wähle eine Lizenz (deine Testversion funktioniert) und klicke Genehmigen. Die Statusseite bemerkt dies automatisch und zeigt das verknüpfte Konto an. Diese Installation hat jetzt ihren eigenen Schlüssel, den die Bridge über Neustarts hinweg behält.
Lieber per Konfiguration? Erzeuge einen Schlüssel auf deiner Embedded-Seite und setze
SQLLY_EMBEDDED_LICENSE_KEYin.envbevor du startest. Offline-Pläne setzenSQLLY_EMBEDDED_LICENSE_FILEauf die heruntergeladene Datei. -
Erstelle ein Profil. Profile → Profil erstellen, gib ihm einen Namen und füge eine Verbindung hinzu: Engine wählen, Server, Datenbank und Anmeldung eintragen. Klicke Test um zu prüfen, dass die Bridge darauf zugreifen kann; das Ergebnis erscheint vor dem Speichern im Formular. Dann Starten öffnet SQLly mit diesem Profil in einem neuen Tab.
-
Benutzer hinzufügen. Benutzer → Benutzer erstellen mit einem Benutzernamen, einem Passwort und dem Profil. Öffne http://127.0.0.1:8090/ in einem privaten Fenster, melde dich als dieser Benutzer an und klicke SQLly öffnen. Genau diese Erfahrung machen auch deine eigenen Benutzer.
Zurück zu Status siehst du den Lizenzplatz, den dieser Benutzer jetzt belegt. Schließt du seinen SQLly-Tab, wird er wieder frei.
Die Einstellungen in .env
| Einstellung | Wofür es ist |
|---|---|
SQLLY_EMBEDDED_LICENSE_KEY | Ein verbundener Lizenzschlüssel (sqe_…). Lass es leer, um stattdessen über die Admin-Seite zu verknüpfen. |
SQLLY_EMBEDDED_LICENSE_FILE | Eine Offline-Lizenzdatei. Setze nicht beides. |
SQLLY_EMBEDDED_MANAGE_TOKEN | Das gemeinsame Geheimnis zwischen der Bridge und der Admin-App. Wird beim ersten Start erzeugt. |
SQLLY_EMBEDDED_DOMAIN | Die Domain, unter der deine App ausgeliefert wird. Lass sie bei localhost leer. Setzt du sie, wird beim ersten Check-in eine ungebundene Lizenz gebunden. |
SQLLY_EMBEDDED_PUBLIC_URL | das wss://…/proxy URL, die Browser verwenden, sobald du hinter einem Reverse-Proxy sitzt. |
SQLLY_EMBEDDED_STATE_DIR | Wo die Bridge Profile, den Lizenz-Cache und einen verknüpften Schlüssel speichert. |
Jedes Bridge-Flag hat eine Umgebungsvariable; die vollständige Liste befindet sich auf In Produktion gehen.
Was im Paket enthalten ist
| Pfad | Was es ist |
|---|---|
bin/sqlly-bridge | Die SQLly-Bridge; sqlly-bridge embedded … ist der Modus, den dieses Paket verwendet. |
bin/sqlly-cli | Die Engine, die die Bridge pro Sitzung startet. Lass sie neben der Bridge liegen. |
web/ | Der SQLly-Browser-Build: index.html, boot.js, spill-worker.js, sqlly_browser.js, sqlly_browser_bg.wasm, sqlly2.svg. Plattformunabhängig. |
sample-app/ | Die Beispiel-Admin- und Launcher-App. server.js ist das Routing, lib/bridge.js ein vollständiger Management-API-Client, lib/credentials.js erstellt Credential-Dokumente. |
start-sample.sh, start-sample.cmd | Starte die Bridge und die Beispiel-App zusammen von .env. |
Weiter
Mach die Tour der Beispiel-App um jeden Bildschirm zu sehen, oder geh direkt zu Deine eigene App bauen.