# Worker node

> Ejecuta contenedores de agent en un servidor dedicado y reforzado, separado del host principal de PentAGI.

En producción, mantén la ejecución de [tool](https://pentagi.com/es/docs/glossary/#tool) no confiable fuera de la máquina que ejecuta PentAGI. Un [worker node](https://pentagi.com/es/docs/glossary/#worker-node) aloja los contenedores de los [agents](https://pentagi.com/es/docs/glossary/#agent) detrás de endpoints de Docker protegidos por TLS, de modo que los comandos que ejecuta un agent nunca afectan al host principal.

```mermaid
graph TB
  accTitle: Main node running PentAGI and a separate worker node running the tool containers
  subgraph Main node
    PA[PentAGI]
  end
  subgraph Worker node
    HD[Host Docker :2376 TLS]
    DIND[Docker-in-Docker :3376 TLS<br/>authorization policy + seccomp]
    W[Worker containers]
    N[Nested containers]
  end
  PA -->|TLS, creates workers| HD
  HD --> W
  W -->|TLS| DIND
  DIND --> N
```

## [Por qué un worker node](https://pentagi.com/es/docs/deployment/worker-node/#why-a-worker-node)

* **Aislamiento.** Los contenedores de tool se ejecutan en hardware dedicado con su propio límite de red.
* **Acceso a Docker controlado.** Los agents que necesitan Docker se comunican con un daemon Docker-in-Docker endurecido mediante una política de autorización en lugar del daemon del host.
* **Pruebas out-of-band.** Un rango de puertos dedicado en el worker node admite callbacks OOB.

## [Modos de conexión](https://pentagi.com/es/docs/deployment/worker-node/#connection-modes)

* **Estándar (recomendado)** — PentAGI se conecta al Docker del host del worker node mediante TLS para crear contenedores worker; los workers acceden a Docker-in-Docker a través de su endpoint TLS. Configura `DOCKER_INSIDE=true` junto con `DOCKER_INSIDE_HOST`, `DOCKER_INSIDE_TLS_VERIFY` y `DOCKER_INSIDE_CERT_PATH`, y deja `DOCKER_SOCKET` vacío: el `/var/run/docker.sock` de la plantilla `.env` también montaría el socket de Docker del host del worker node en cada [sandbox](https://pentagi.com/es/docs/glossary/#sandbox). Sin `DOCKER_INSIDE_HOST`, los agents no obtienen acceso a Docker.
* **Directo** — PentAGI se comunica directamente con Docker-in-Docker; los bind-mounts del host son denegados por política, por lo que el acceso a Docker para los agents debe estar deshabilitado.

## [Configuración](https://pentagi.com/es/docs/deployment/worker-node/#set-it-up)

El procedimiento completo — certificados TLS para ambos daemons, la configuración endurecida de Docker-in-Docker, actualizaciones de políticas y verificación — está en la [guía del worker node](https://github.com/vxcontrol/pentagi/blob/main/examples/guides/worker_node.md) en el repositorio.