← Back to Documentation
Gestor de Datos » 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 con plan Pro o Enterprise
  • 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 — Inicia sesión

nuzur-cli login

Esto abre el navegador para autenticarte. Una vez completado, tus credenciales se guardan localmente y se reutilizan automáticamente.

Paso 3 — Vincula esta máquina

Registrar tu máquina crea una entrada de agente local en tu cuenta de nuzur:

nuzur-cli agent pair

Si todo va bien, verás el UUID del agente y la ruta donde se guardaron las credenciales:

Paired local agent.
  uuid: xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
  machine: mi-laptop (darwin)
  credentials stored at: ~/.config/nuzur/agent/

Para ver todos los agentes vinculados a tu cuenta:

nuzur-cli agent list

Paso 4 — Registra una conexión de base de datos

nuzur-cli agent connection add

La CLI 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.

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 5 — 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 6 — 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).

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.

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

Próximos pasos