Быстрый старт

Запустите пакет SQLly Embedded на локальном хосте за пять минут: запустите мост и пример приложения, подключите лицензию, добавьте профиль и откройте SQLly как пользователь.

Здесь на одной машине запускается весь пакет SQLly Embedded: мост, его движок и образец админ-приложения. Всё остаётся на localhost, а бесплатный пробный период вашего аккаунта sqlly.app это покрывает. Вам нужен Node.js 20 или новее, плюс база данных, к которой SQLly может подключиться.

Запустите его

  1. Скачайте и распакуйте пакет SQLly Embedded для вашей платформы с Загрузки (Linux x86-64 и arm64, macOS Apple silicon, Windows x86-64 и arm64). На Linux распакуйте с помощью tar -xzf чтобы у исполняемых файлов сохранились права.

    Для автоматизации на каждой платформе есть стабильная ссылка, которая всегда предоставляет новейший пакет, собранный для этой платформы. Если выпуск не был собран для вашей платформы, ссылка предоставит новейший, который был.

    ПлатформаПоследний пакет
    Linux x86-64https://sqlly.app/download/embedded/latest/linux-amd64
    Linux arm64https://sqlly.app/download/embedded/latest/linux-arm64
    macOS Apple Siliconhttps://sqlly.app/download/embedded/latest/macos-arm64
    Windows x86-64https://sqlly.app/download/embedded/latest/windows-amd64
    Windows arm64https://sqlly.app/download/embedded/latest/windows-arm64
    curl -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 без загрузки.

  2. Запустить всё из sqlly-embedded папка:

    macOS / Linux
    ./start-sample.sh
    Windows
    start-sample.cmd

    Скрипт создаёт .env из .env.example, проверяет Node.js, генерирует общий токен управления при первом запуске, запускает мост, ждёт его API управления и запускает пример приложения на http://127.0.0.1:8090.

  3. Войдите как администратор на http://127.0.0.1:8090/admin с sqlly-admin / GoodLittlePiggy. (Пока вы не смените этот пароль, пример приложения слушает только loopback.)

  4. Привяжите лицензию. Включено Статус, щёлкните Подключитесь к sqlly.app, затем Откройте sqlly.app, чтобы подтвердить. Войдите на sqlly.app, проверьте, что код совпадает с кодом на вашей странице администратора, выберите лицензию (подойдёт и пробная) и нажмите Одобрить. Страница «Статус» замечает это сама и показывает привязанную учётную запись. У этой установки теперь свой ключ, который мост сохраняет между перезапусками.

    Предпочитаете конфигурацию? Создайте ключ на вашей странице Embedded и установите SQLLY_EMBEDDED_LICENSE_KEY в .env перед запуском. Офлайн-планы задают SQLLY_EMBEDDED_LICENSE_FILE на загруженный файл вместо этого.

  5. Создайте профиль. Профили → Создать профиль, дайте ему имя и добавьте подключение: выберите движок, укажите сервер, базу данных и данные для входа. Нажмите Тест чтобы убедиться, что мост до него достучится; результат появится на форме ещё до сохранения. Затем Запустить открывает SQLly с этим профилем в новой вкладке.

  6. Добавьте пользователя. Пользователи → Создать пользователя с именем пользователя, паролем и профилем. Откройте 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.

Далее

Пройдите обзор демонстрационного приложения чтобы увидеть каждый экран, или перейдите прямо к создание собственного приложения.