Paddock: sandbox autohospedado para agentes de IA

Para qué sirve Paddock, explicado de forma sencilla

Paddock proporciona a un agente de IA un ordenador Linux separado dentro de un VPS que tú controlas. Cada entorno, llamado box, reúne archivos, herramientas y un escritorio Ubuntu XFCE. El agente puede ejecutar comandos, compilar una aplicación y abrirla para revisar lo que ha construido. Puedes conservar la box para continuar otro día o usarla como sandbox temporal.

La web presenta un proyecto que debes desplegar. La página pública no entrega por sí sola un escritorio alojado. Paddock aporta el entorno de ejecución; el agente y el proveedor del modelo resuelven la tarea.

Del repositorio al resultado visible

Las boxes admiten Docker mediante Sysbox e incluyen Claude Code, Codex, OpenCode, Pi, Prime y Kimi. La autenticación del proveedor elegido sigue siendo necesaria. Puedes enviar instrucciones con paddock prompt, ejecutar comandos con la CLI o gestionar el trabajo desde el panel web. También hay API HTTP y SDK de TypeScript y Python.

Para revisar una interfaz, abre la sesión con paddock desktop, inicia el programa mediante exec --desktop y guarda una captura con paddock screenshot. Es una forma de observar la aplicación real después de generar código, en lugar de limitarse a leer la respuesta del agente.

Cómo preparar el servidor y probar un proyecto

La guía oficial de instalación pide un VPS Ubuntu o Debian, acceso root, arquitectura amd64 o arm64, puertos 80 y 443 abiertos y un nombre de host dirigido al servidor. Tras instalar, utiliza el enlace de configuración de un solo uso para crear la cuenta propietaria. Instala la CLI en tu equipo e inicia sesión.

Este recorrido documentado copia un proyecto Node local y ejecuta sus pruebas:

paddock new --type small --ttl 3600
paddock push current . --to /config/project
paddock exec current -- bash -lc 'cd /config/project && npm test'
paddock stop current

Comprueba la salida de las pruebas antes de dar la tarea por terminada. Las dependencias y el script de pruebas deben estar preparados; si hay que descargar paquetes, la política de red debe permitirlo. El último comando detiene la box y crea un snapshot del sistema de archivos. Recupera con pull los resultados que necesites antes de borrar una box desechable.

Elegir entre una máquina persistente y un sandbox temporal

Puedes detener, reanudar, bifurcar y restaurar entornos. Las unidades con nombre montadas en /mnt conservan datos aunque elimines la box. Esto sirve para cachés o archivos que quieras reutilizar.

Los snapshots tienen límites concretos: guardan archivos, pero no la memoria RAM, los procesos en ejecución, /var/lib/docker ni los datos de las unidades montadas. Una restauración no equivale a recuperar una máquina congelada exactamente en mitad de una ejecución.

Restringir la red y entender la privacidad

Paddock permite allow-all, deny-all y listas de dominios o rangos IPv4 autorizados. El valor inicial es allow-all. Deny-all impide nuevas conexiones salientes, aunque las ya abiertas pueden finalizar. El acceso a metadatos de nube permanece bloqueado.

Una lista restrictiva debe contemplar las API de modelos, repositorios y registros de paquetes necesarios. Autohospedar controla dónde ejecutas el trabajo; los datos enviados a proveedores externos quedan sujetos a sus condiciones. No se debe interpretar esta configuración como una garantía absoluta contra escapes.

Software abierto y gastos que debes prever

Verificado el 29 de octubre de 2026: el código usa la licencia MIT. No se encontró una tabla oficial de suscripciones de alojamiento Paddock. El VPS, almacenamiento y consumo de modelos se pagan por separado cuando corresponda. La capacidad disponible determina cuántas boxes puedes ejecutar a la vez.

Encaja con desarrolladores que quieren controlar entornos de agentes y pueden administrar Linux, actualizaciones y copias de seguridad.

Preguntas frecuentes

¿Paddock es gratuito?

El software MIT está disponible sin suscripción de software en las fuentes revisadas. Eso no incluye gratuitamente el servidor ni las API de IA.

¿Puedo utilizarlo desde Windows o macOS?

Sí, hay instrucciones para instalar la CLI en ambos. El servidor sigue requiriendo la infraestructura Linux documentada.

¿El sandbox bloquea internet de forma predeterminada?

No. Debes seleccionar deny-all o una lista permitida; las nuevas boxes parten de allow-all.

Recursos oficiales

• Repositorio del proyecto: código y documentación técnica.
• Versiones y descargas: binarios disponibles y cambios publicados.