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
-
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 -xzfpara 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-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.gzAñadir
/versiona 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. -
Iniciar todo desde la
macOS / Linuxsqlly-embeddedcarpeta:
Windows./start-sample.shstart-sample.cmdEl script crea
.envde.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 enhttp://127.0.0.1:8090. -
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.) -
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_KEYen.envantes de iniciar. Los planes sin conexión establecenSQLLY_EMBEDDED_LICENSE_FILEen el archivo descargado en su lugar. -
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.
-
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
| Ajuste | Para qué sirve |
|---|---|
SQLLY_EMBEDDED_LICENSE_KEY | Una clave de licencia conectada (sqe_…). Déjalo vacío para enlazar desde la página de administración. |
SQLLY_EMBEDDED_LICENSE_FILE | Un archivo de licencia fuera de línea. No configures ambos. |
SQLLY_EMBEDDED_MANAGE_TOKEN | El secreto compartido entre el puente y la aplicación de administración. Se genera en la primera ejecución. |
SQLLY_EMBEDDED_DOMAIN | El 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_URL | La wss://…/proxy URL que usan los navegadores cuando ya estás detrás de un proxy inverso. |
SQLLY_EMBEDDED_STATE_DIR | Dó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
| Ruta | Qué es |
|---|---|
bin/sqlly-bridge | El puente SQLly; sqlly-bridge embedded … es el modo que usa este paquete. |
bin/sqlly-cli | El 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.cmd | Inicia 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.