SQLly en una página: modo proxy de relé
funcionalEjecuta la compilación del navegador contra tus propias bases de datos a través de un relay que controlas tú: este guarda las credenciales, así que la página nunca ve una contraseña.
La versión para navegador de SQLly normalmente se ejecuta contra datos de muestra en tu pestaña, porque una página web no puede abrir un socket de base de datos. Modo proxy de retransmisión le da servidores reales: un sqlly-relay lo que ejecutas recibe un
archivo de credenciales, y la versión para navegador, abierta con la dirección de ese relay, consulta luego cada servidor y base de datos del archivo, con el explorador de objetos, IntelliSense, planes de ejecución y edición de filas incluidos, mientras las contraseñas nunca salen del host del relay.
Cómo encaja todo
browser (SQLly on a page) --wss--> sqlly-relay proxy --local--> SQLly engine --TDS / PG / MySQL / ...--> your databases
holds the credential file one per browser session
- El relé entrega un archivo de credenciales. Todo lo que hay dentro —cada conexión, servidor, base de datos, inicio de sesión y contraseña, inicios de sesión compartidos, túneles SSH y proxies, y las etiquetas de cliente, proyecto y entorno— es lo que el navegador puede alcanzar. Nada más.
- Un motor por sesión. Cada sesión del navegador obtiene su propio motor SQLly en el host del relay, iniciado en un modo restringido que solo abre conexiones desde el archivo. Se rechaza una solicitud que nombre su propio servidor o lleve su propia contraseña.
- El navegador recibe nombres, no secretos. Recibe la lista de conexiones sin contraseñas, ajustes de túnel ni tokens, y nunca la almacena: el relay la envía de nuevo en cada carga de página.
- La otra función del relé sigue intacta. El proxy es un agente de escucha aparte y opcional. Un relé que no lo activa reenvía el tráfico Via Relay exactamente igual que antes.
Configurar el relé
En un host que pueda alcanzar las bases de datos y tenga sqlly-cli instalado junto a
sqlly-relay, escribe un archivo de credenciales (exporta uno desde la app de escritorio con
Archivo → Exportar conexión con credenciales…, o escríbelo a mano) e inicia el relay con las opciones del proxy añadidas a su configuración habitual:
sqlly-relay \ --tls-cert /certs/relay.crt --tls-key /certs/relay.key \ --proxy-credentials /etc/sqlly/browser-connections.json \ --proxy-token 'a-long-random-secret' \ --proxy-bind 0.0.0.0:8444 \ --proxy-allowed-origins https://sqlly.app
| Indicador | Lo que hace |
|---|---|
--proxy-credentials | El archivo de credenciales. Configurarlo es lo que activa el proxy. El archivo se vuelve a leer en cada nueva sesión del navegador, así que los cambios surten efecto sin reiniciar. |
--proxy-token | Un secreto compartido que el navegador debe presentar. Obligatorio: sin él, el relé se niega a arrancar a menos que pases --proxy-insecure-no-token, que expone todas las bases de datos listadas a cualquiera que pueda llegar al puerto. |
--proxy-bind | Dónde escucha el proxy; el valor predeterminado es el puerto 8444. Utiliza el certificado TLS del relay para wss://; --proxy-plain sirve ws:// para pruebas locales o detrás de un proxy inverso que termina TLS. |
--proxy-allowed-origins | Orígenes web, separados por comas, que pueden abrir una sesión, de modo que solo las páginas que alojes puedan usar el proxy. Omítelo para permitir cualquier origen (el token sigue aplicándose). |
--proxy-max-sessions | Cuántas sesiones de navegador pueden estar abiertas a la vez (cada una es un proceso del motor); el valor predeterminado es 32. Un proxy lleno pide a las nuevas sesiones que lo intenten más tarde. |
--proxy-engine-binary | Dónde sqlly-cli es, si no está al lado sqlly-relay o en el PATH. |
Cada flag tiene su equivalente como variable de entorno (RELAY_PROXY_CREDENTIALS,
RELAY_PROXY_TOKEN, y así sucesivamente) para despliegues en contenedores. La imagen de contenedor del relay incluye el motor cuando se compila con --build-arg WITH_PROXY_ENGINE=1.
Dos reglas difieren de una importación de escritorio: los inicios de sesión compartidos y los perfiles de túnel deben definirse en el mismo archivo (el relay no tiene conexiones guardadas a las que recurrir), y una
via-relay ruta en una conexión se ignora, porque el host del relé se conecta a cada servidor por sí mismo.
Abre la versión de navegador contra él
Añade la dirección del proxy y el token a la URL de la compilación del navegador:
https://sqlly.app/app/?proxy=wss://relay.example.com:8444/proxy&token=a-long-random-secret
Una página que incrusta la compilación puede establecer SQLLY_PROXY_URL y
SQLLY_PROXY_TOKEN como globales antes de que arranque la aplicación, en lugar de ponerlos en la barra de direcciones. Al cargar, la aplicación se conecta, la línea de estado muestra el relay y cuántas conexiones atiende, y esas conexiones aparecen en el explorador listas para usar. Las bases de datos de ejemplo no se descargan en absoluto en este modo.
Qué cambia en la aplicación
- Las conexiones son solo de lectura. La lista es la del relay. Añadir servidor, Duplicar, Eliminar e Importar conexiones están deshabilitados; los botones de añadir, eliminar y duplicar del administrador de conexiones y sus editores de cliente, proyecto y entorno están bloqueados; y al abrir una conexión se muestra como Ver conexión con Guardar deshabilitado y una nota de que el relay guarda sus credenciales. Cambia el archivo de credenciales en el relay para cambiar lo que ven los usuarios.
- Probar conexión sigue funcionando - pasa por el proxy como cualquier consulta, y lo mismo ocurre con todas las funciones de consulta, el explorador de objetos, la sincronización del catálogo de IntelliSense, los planes de ejecución, los scripts y la edición de filas.
- Las etiquetas vienen incluidas. Los nombres de cliente, proyecto y entorno, los colores y los interruptores de seguridad del archivo organizan el explorador igual que en el escritorio; se omiten los iconos para que la página sea ligera.
- Si el relay desaparece - la línea de estado lo indica y las consultas sobre conexiones con proxy fallan con un mensaje claro hasta que se recargue la página.