Inicio rápido

Ejecuta el paquete SQLly Embedded en localhost en cinco minutos: inicia el puente y la aplicación de ejemplo, enlaza una licencia, añade un perfil y abre SQLly como usuario.

Esto ejecuta todo el paquete SQLly Embedded en una máquina: el puente, su motor y la aplicación de administración de ejemplo. Todo permanece en localhost, y la prueba gratuita en tu cuenta sqlly.app lo cubre. Necesitas Node.js 20 o más reciente, y una base de datos a la que SQLly pueda conectarse.

Ejecutarlo

  1. Descargar y descomprimir el paquete SQLly Embedded para tu plataforma desde Descargas (Linux x86-64 y arm64, macOS Apple silicon, Windows x86-64 y arm64). En Linux, descomprime con tar -xzf para que los ejecutables mantengan sus permisos.

    Para automatizarlo, cada plataforma tiene un enlace estable que siempre sirve el paquete más reciente creado para ella. Si alguna versión no se creó para tu plataforma, el enlace sirve la más reciente que sí se creó.

    PlataformaÚltimo paquete
    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

    Añadir /version a cualquiera de ellos (por ejemplo /download/embedded/latest/linux-amd64/version) para obtener la versión y el nombre del archivo en JSON sin descargar nada.

  2. Iniciar todo desde la sqlly-embedded carpeta:

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

    El script crea .env de .env.example, verifica Node.js, genera el token de gestión compartido en el primer arranque, inicia el puente, espera a que su API de gestión esté lista y arranca la aplicación de ejemplo en http://127.0.0.1:8090.

  3. Inicia sesión como administrador en http://127.0.0.1:8090/admin con sqlly-admin / GoodLittlePiggy. (La aplicación de ejemplo no acepta escuchar en nada que no sea loopback hasta que cambies esa contraseña.)

  4. Vincular una licencia. Activado Estado, haz clic en Conéctate a sqlly.app, luego Abre sqlly.app para aprobar. Inicia sesión en sqlly.app, comprueba que el código coincida con el de tu página de administración, elige una licencia (tu prueba sirve) y haz clic Aprobar. La página de Estado se percata por sí sola y muestra la cuenta vinculada. Esta instalación ya tiene su propia clave, que el puente conserva entre reinicios.

    ¿Prefieres configuración? Genera una clave en tu página Embedded y establece SQLLY_EMBEDDED_LICENSE_KEY en .env antes de iniciar. Los planes sin conexión establecen SQLLY_EMBEDDED_LICENSE_FILE en el archivo descargado en su lugar.

  5. Crea un perfil. Perfiles → Crear perfil, dale un nombre y añade una conexión: elige el motor, completa el servidor, la base de datos y el inicio de sesión. Haz clic Prueba para comprobar que el puente puede alcanzarlo; el resultado aparece en el formulario antes de guardar. Luego Lanzar abre SQLly con ese perfil en una nueva pestaña.

  6. Añadir un usuario. Usuarios → Crear usuario con un nombre de usuario, una contraseña y el perfil. Abre http://127.0.0.1:8090/ en una ventana privada, inicia sesión como ese usuario y haz clic Abrir SQLly. Esa es la experiencia que obtienen tus propios usuarios.

De vuelta en Estado verás el asiento que ese usuario ocupa ahora. Cierra su pestaña de SQLly y se libera.

Los ajustes en .env

AjustePara qué sirve
SQLLY_EMBEDDED_LICENSE_KEYUna clave de licencia conectada (sqe_…). Déjalo vacío para enlazar desde la página de administración.
SQLLY_EMBEDDED_LICENSE_FILEUn archivo de licencia fuera de línea. No configures ambos.
SQLLY_EMBEDDED_MANAGE_TOKENEl secreto compartido entre el puente y la aplicación de administración. Se genera en la primera ejecución.
SQLLY_EMBEDDED_DOMAINEl dominio desde el que se sirve tu aplicación. Déjalo vacío en localhost. Al configurarlo, se vincula una licencia sin vincular en la primera comprobación.
SQLLY_EMBEDDED_PUBLIC_URLLa wss://…/proxy URL que usan los navegadores cuando ya estás detrás de un proxy inverso.
SQLLY_EMBEDDED_STATE_DIRDónde el puente guarda perfiles, la caché de licencias y una clave vinculada.

Cada flag de bridge tiene su variable de entorno; la lista completa está en Ir a producción.

Qué hay en el paquete

RutaQué es
bin/sqlly-bridgeEl puente SQLly; sqlly-bridge embedded … es el modo que usa este paquete.
bin/sqlly-cliEl motor que el puente inicia en cada sesión. Mantenlo junto al puente.
web/La versión de SQLly para navegador: index.html, boot.js, spill-worker.js, sqlly_browser.js, sqlly_browser_bg.wasm, sqlly2.svg. Independiente de la plataforma.
sample-app/La aplicación de ejemplo de administración y de lanzamiento. server.js es el enrutamiento, lib/bridge.js un cliente completo de API de gestión, lib/credentials.js genera los documentos de credenciales.
start-sample.sh, start-sample.cmdInicia el bridge y la aplicación de ejemplo juntos desde .env.

Siguiente

Haz el tour de la aplicación de ejemplo para ver cada pantalla, o ve directamente a crear tu propia aplicación.