Orca: coordine agentes sin perder la identidad del trabajo
Orca headless: distinga listener, display y emparejamiento
Prepare un runtime Linux privado sin confundir la dirección anunciada con una restricción de red.
Qué aprenderás
- Sin ventana todavía hay dependencias
- Enlazar y anunciar son distintos
- Operación reversible
Antes de empezar
- Lectura básica de comandos y configuración
- Entorno de ensayo desechable y autorizado
Identifique host, worktree y evidencia de aceptación sin automatizar merges ni borrar trabajo pendiente.
Conclusiones clave
- Headless aún depende de Electron.
- Pairing address no restringe el listener.
- Runtime listo y pairing disponible son estados distintos.
Sin ventana todavía hay dependencias
La guía indica que orca serve no abre escritorio, pero AppImage necesita bibliotecas de Electron. Sin DISPLAY inicia Xvfb si está instalado. Un DISPLAY bloqueado por un proceso muerto se rechaza en vez de reemplazarse silenciosamente.
Los nombres de paquetes cambian entre Ubuntu y Debian, incluidas variantes t64. Use la lista de su distribución. Un paquete inexistente por copiar nombres de otra versión no es un fallo del modelo.
Enlazar y anunciar son distintos
--pairing-address modifica la dirección anunciada, no la interfaz de escucha. Compruebe boundEndpoint y advertisedEndpoint con --json y aplique firewall o una red privada autorizada.
El runtime puede estar utilizable con pairing.available:false y una razón. --recipe-json es más estricto porque requiere URL de emparejamiento. Mantenga esa URL privada: es material relacionado con acceso.
Operación reversible
Use una cuenta dedicada no root y conserve un artefacto anterior revisado. La guía recomienda instalación propiedad de root, ejecutable pero no reemplazable por el servicio. Pruebe primero en primer plano.
Valide reinicios y ubicación de datos en un entorno desechable antes de actualizar. Detenga con Ctrl+C el ensayo en primer plano. No instalamos paquetes ni verificamos un emparejamiento remoto para esta serie.
Cómo elegir
| Criterio | Opción A | Opción B |
|---|---|---|
| Best when | You need predictable behavior and easy auditing | You need adaptive optimization and have reliable telemetry |
| Main risk | May leave performance on the table | Can become difficult to explain or debug |
Pasos de implementación
- 1
Ajuste dependencias a la distribución.
- 2
Inspeccione direcciones enlazada y anunciada.
- 3
Pruebe con usuario dedicado antes de supervisar.
Ejemplo para copiar
orca serve --port 6768 --json
# Mantenga privada la URL de pairing; termine con Ctrl+C.Preguntas frecuentes
¿--pairing-address hace privado el puerto?
No. Aplique política de red y compruebe boundEndpoint.
¿El registro ready siempre permite pairing?
Puede indicar available:false con una razón.
Fuentes
- Orca / docs/reference/headless-linux-server.mdFuente verificada 2026-09-18