Integraciones » Ejecutar un agente local

Ejecutar un agente local

¿Qué es el agente local?

El agente local de nuzur es un pequeño daemon que ejecutas en tu propia máquina. Crea un túnel seguro entre tu base de datos local y el Gestor de Datos de nuzur, para que puedas explorar, consultar y gestionar datos en nuzur sin exponer tu base de datos a internet ni almacenar credenciales fuera de tu máquina.

Tu DSN nunca sale de tu computadora. Solo los resultados de las consultas se reenvían a través del túnel cifrado.

Requisitos

CLI de nuzur instalada (descargar)
Una cuenta de nuzur (el plan Starter gratuito incluye 1 conexión de base de datos; los planes Pro y Team tienen conexiones ilimitadas)
Una base de datos local MySQL o PostgreSQL

Paso 1 — Instala la CLI

Descarga e instala la CLI de nuzur desde nuzur.com/cli y verifica la instalación:

nuzur-cli --version

Paso 2 — Agrega una conexión de base de datos

nuzur-cli agent connection add

La primera vez que lo ejecutas, la CLI inicia tu sesión (abriendo el navegador) y vincula esta máquina automáticamente — no hay un paso aparte de login ni de agent pair. Luego te pedirá:

Name — un nombre para esta conexión (p. ej. local-mysql)
Driver — mysql o postgres
Host / Port / User / Password — las credenciales de tu base de datos local
Database (solo Postgres) — el nombre de la base de datos de destino
Default schema (solo Postgres) — normalmente public

Los metadatos de la conexión (nombre, driver, esquema) se publican en nuzur. Tu DSN permanece en disco, nunca en la nube.

Límite del plan: el plan Starter gratuito permite una sola conexión de base de datos. Los planes Pro y Team tienen conexiones ilimitadas.

Para ver todas las conexiones registradas:

nuzur-cli agent connection list

Para eliminar una conexión:

nuzur-cli agent connection remove <nombre-o-uuid>

Paso 3 — Inicia el agente

nuzur-cli agent start

El agente se ejecuta en primer plano y espera solicitudes de consulta entrantes desde nuzur. Deja este terminal abierto mientras uses el Gestor de Datos.

Detente en cualquier momento con Ctrl+C.

Opciones

Flag	Descripción
`--driver`	Driver de base de datos (`mysql` o `postgres`)
`--dsn`	Cadena DSN completa (omite el prompt interactivo)
`--reset-db`	Descarta el DSN/driver guardado y vuelve a preguntar
`--max-concurrent-queries`	Límite de consultas simultáneas (por defecto: 32)

También se aceptan las variables de entorno NUZUR_AGENT_DRIVER y NUZUR_AGENT_DSN.

Paso 4 — Inicio automático al iniciar sesión (opcional)

Para que el agente arranque automáticamente al iniciar sesión, instálalo como servicio del sistema operativo:

nuzur-cli agent install

Compatible con macOS (launchd) y Linux (systemd user service). En Windows, ejecuta nuzur-cli agent start manualmente por ahora — el inicio automático gestionado aún no está disponible.

Para detener y eliminar el servicio:

nuzur-cli agent uninstall

Verificar el estado

nuzur-cli agent status

Muestra el estado de vinculación, el DSN/driver guardado y si el servicio de inicio automático está instalado.

Verificar la conexión

Con el agente ejecutándose en un terminal, ejecuta el autotest en otro terminal:

nuzur-cli agent self-test

Esto envía un SELECT 1 a través del ciclo completo nube → agente → base de datos e imprime OK si todo funciona.

Gestionar máquinas vinculadas

La vinculación ocurre automáticamente la primera vez que agregas una conexión, así que rara vez necesitas hacerlo a mano. Si quieres vincular una máquina por adelantado (por ejemplo, para aprovisionarla antes de agregar conexiones), ejecuta:

nuzur-cli agent pair

Para listar todas las máquinas vinculadas a tu cuenta:

nuzur-cli agent list

Desvincular una máquina

Para revocar el agente de esta máquina en la nube y eliminar las credenciales locales:

nuzur-cli agent unpair

Si la entrada en la nube ya fue eliminada desde otro lugar, usa --keep-remote para borrar solo los archivos locales:

nuzur-cli agent unpair --keep-remote