Descripción del control remoto

Ejecuta zqagent en tu ordenador o servidor y encarga tareas en remoto desde el móvil o QQ: la IA se ejecuta en el servidor y el progreso, las solicitudes de aprobación y los resultados vuelven a tu mano en tiempo real. Ideal si no quieres estar delante del ordenador o si quieres delegar trabajo en la IA en cualquier momento.

Usar la nube oficial (recomendado)

Si no quieres montar tu propio broker, usa directamente la nube ya desplegada:

1. Abre el Centro de usuario de ZQAgent, regístrate e inicia sesión.

2. Crea una gestión de nodos y genera un código de conexión de un solo uso (válido 15 minutos).

3. En el dispositivo de destino, ejecuta un comando para conectar (elige una opción; las credenciales se guardan solas, sin copiarlas a mano):

   Nodo existente (conexión en caliente, sin reiniciar)

   zqagent link --hub https://hub.cd-zq.com --code <código>

   Conexión al arrancar (código fuente / hierro)

   HUB_URL=https://hub.cd-zq.com HUB_ENROLL_CODE=<código> pnpm run server

   Docker

   docker run -d -p 8787:8787 -v zqagent-data:/data \
     -e HUB_URL=https://hub.cd-zq.com -e HUB_ENROLL_CODE=<código> \
     ghcr.io/<owner>/zqagent-server

   App de escritorio: en la barra superior de la consola, «Conectar a la nube»; pega la dirección del Hub y el código.

4. Las credenciales se escriben en {DATA_DIR}/fleet.json y las siguientes veces no hace falta el código; cuando el nodo esté en línea podrás ver su estado, proyectos y eventos en el centro de usuario o en la consola del nodo (navegador / móvil), y realizar la sesión completa: enviar tareas, aprobar, interrumpir, etc.

El nodo solo necesita una conexión saliente a la pasarela (wss://, normalmente 443); no requiere entrada pública ni abrir puertos.

• El código de conexión es de un solo uso y de corta duración; un mismo ID de nodo no puede ser adoptado dos veces por gestores distintos (antiocupación).
• Si montas tu propio Hub, la dirección de pasarela que se entrega al nodo la decide HUB_GATEWAY_URL en el Hub.

Máquina solo con CLI: dejarla como nodo residente

Una máquina con solo la CLI (sin código fuente) también puede quedar como nodo gestionable:

zqagent serve                                                      # solo uso local
zqagent serve --hub https://hub.cd-zq.com --enroll-code <código>    # conexión al arrancar

Para residencia en segundo plano (nohup / pm2 / systemd), directorio de datos y verificación en línea, consulta Iniciar el nodo.

Inicio rápido

Inicia el servicio en el directorio del proyecto (vía código fuente, equivalente a zqagent serve con la CLI instalada):

pnpm run server   # puerto 8787 por defecto; en el primer arranque crea el inquilino demo (apiKey aleatoria impresa en el registro)

El registro de arranque muestra la información del inquilino demo:

zqagent server 监听 http://localhost:8787
数据目录: ./data
已创建演示租户: id=demo apiKey=zk_xxxx（随机生成） model=gpt-4o-mini

Para la configuración detallada, consulta Configuración del servidor.

¿Hace falta red pública?

Conclusión: el servidor en sí no necesita IP pública. Todas las «interacciones remotas» usan conexiones salientes a través de un relay de terceros:

Capacidad	Acción del servidor	Relay	¿Entrada pública?
Control remoto	Conectar a la pasarela (wss saliente)	Pasarela Rust pública	No
Bot de QQ	Conectar a la pasarela de Tencent (saliente)	Plataforma abierta QQ de Tencent	No
Notificaciones por correo / Bark / Server酱 / Webhook	POST activo (saliente)	SMTP / servicios de push	No

Solo hay un caso en que se necesita red pública (o penetración de red interna): que quieras que el exterior acceda directamente a la interfaz REST. Consulta Configuración del servidor.

Documentación relacionada

• Iniciar el nodo: instalar la CLI, dejar el nodo como servicio residente, conectar al centro de usuario
• Consola del nodo: gestionar nodos, conversaciones y uso desde el navegador/escritorio
• Configuración del servidor: arranque, variables de entorno, conexión a la nube y opciones de red pública
• Bot de QQ: conexión del bot oficial de QQ + notificaciones por correo
• Acceso remoto: emparejamiento desde el móvil
• Interfaz REST: referencia para integraciones