Быстрый старт
Запустите пакет SQLly Embedded на локальном хосте за пять минут: запустите мост и пример приложения, подключите лицензию, добавьте профиль и откройте SQLly как пользователь.
Здесь на одной машине запускается весь пакет SQLly Embedded: мост, его движок и образец админ-приложения. Всё остаётся на localhost, а бесплатный пробный период вашего аккаунта sqlly.app это покрывает. Вам нужен Node.js 20 или новее, плюс база данных, к которой SQLly может подключиться.
Запустите его
-
Скачайте и распакуйте пакет SQLly Embedded для вашей платформы с Загрузки (Linux x86-64 и arm64, macOS Apple silicon, Windows x86-64 и arm64). На Linux распакуйте с помощью
tar -xzfчтобы у исполняемых файлов сохранились права.Для автоматизации на каждой платформе есть стабильная ссылка, которая всегда предоставляет новейший пакет, собранный для этой платформы. Если выпуск не был собран для вашей платформы, ссылка предоставит новейший, который был.
Платформа Последний пакет 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.gzДобавить
/versionк любому из них (например/download/embedded/latest/linux-amd64/version) чтобы получить версию и имя файла в формате JSON без загрузки. -
Запустить всё из
macOS / Linuxsqlly-embeddedпапка:
Windows./start-sample.shstart-sample.cmdСкрипт создаёт
.envиз.env.example, проверяет Node.js, генерирует общий токен управления при первом запуске, запускает мост, ждёт его API управления и запускает пример приложения наhttp://127.0.0.1:8090. -
Войдите как администратор на http://127.0.0.1:8090/admin с
sqlly-admin/GoodLittlePiggy. (Пока вы не смените этот пароль, пример приложения слушает только loopback.) -
Привяжите лицензию. Включено Статус, щёлкните Подключитесь к sqlly.app, затем Откройте sqlly.app, чтобы подтвердить. Войдите на sqlly.app, проверьте, что код совпадает с кодом на вашей странице администратора, выберите лицензию (подойдёт и пробная) и нажмите Одобрить. Страница «Статус» замечает это сама и показывает привязанную учётную запись. У этой установки теперь свой ключ, который мост сохраняет между перезапусками.
Предпочитаете конфигурацию? Создайте ключ на вашей странице Embedded и установите
SQLLY_EMBEDDED_LICENSE_KEYв.envперед запуском. Офлайн-планы задаютSQLLY_EMBEDDED_LICENSE_FILEна загруженный файл вместо этого. -
Создайте профиль. Профили → Создать профиль, дайте ему имя и добавьте подключение: выберите движок, укажите сервер, базу данных и данные для входа. Нажмите Тест чтобы убедиться, что мост до него достучится; результат появится на форме ещё до сохранения. Затем Запустить открывает SQLly с этим профилем в новой вкладке.
-
Добавьте пользователя. Пользователи → Создать пользователя с именем пользователя, паролем и профилем. Откройте http://127.0.0.1:8090/ в приватном окне, войдите как этот пользователь и нажмите Открыть SQLly. Именно такой опыт получают ваши пользователи.
Вернувшись на Статус вы увидите место, которое сейчас занимает этот пользователь. Закройте его вкладку SQLly — и место освободится.
Настройки в .env
| Настройка | Для чего это нужно |
|---|---|
SQLLY_EMBEDDED_LICENSE_KEY | Подключенный лицензионный ключ (sqe_…). Оставьте пустым, чтобы вместо этого привязать лицензию через страницу администратора. |
SQLLY_EMBEDDED_LICENSE_FILE | Офлайн-лицензионный файл. Не указывайте оба одновременно. |
SQLLY_EMBEDDED_MANAGE_TOKEN | Общий секрет между мостом и административным приложением. Генерируется при первом запуске. |
SQLLY_EMBEDDED_DOMAIN | Домен, с которого обслуживается ваше приложение. На localhost оставьте пустым. Если задать его, при первой проверке связи к нему привяжется ещё не привязанная лицензия. |
SQLLY_EMBEDDED_PUBLIC_URL | Этот wss://…/proxy URL, который используют браузеры, когда вы уже за обратным прокси. |
SQLLY_EMBEDDED_STATE_DIR | Где мост хранит профили, кэш лицензий и связанный ключ. |
У каждого флага моста есть переменная окружения; полный список находится на Выход в продакшн.
Состав пакета
| Путь | Что это такое |
|---|---|
bin/sqlly-bridge | Мост SQLly; sqlly-bridge embedded … это режим, который использует этот пакет. |
bin/sqlly-cli | Движок, который мост запускает для каждой сессии. Держите его рядом с мостом. |
web/ | Браузерная сборка SQLly: index.html, boot.js, spill-worker.js, sqlly_browser.js, sqlly_browser_bg.wasm, sqlly2.svg. Работает на любой платформе. |
sample-app/ | Пример административного приложения и лаунчера. server.js — маршрутизация, lib/bridge.js полноценный клиент API для управления, lib/credentials.js создает документы учетных данных. |
start-sample.sh, start-sample.cmd | Запустите мост и пример приложения вместе из .env. |
Далее
Пройдите обзор демонстрационного приложения чтобы увидеть каждый экран, или перейдите прямо к создание собственного приложения.