Español
Empezar

Agent Sandboxes La salida que permites, por nombre

Una lista de destinos permitidos para cada sandbox

Un sandbox llega a todo internet público salvo que digas lo contrario. Una lista de destinos permitidos lo reduce a los nombres, direcciones y puertos que indiques, como tu registro de paquetes, tu API y GitHub, y el sandbox no llega a nada más.

Cómo se lee la lista de destinos permitidos

Los ajustes de salida de un sandbox tienen dos listas, allow y deny. Cada entrada es una de estas:

  • *: cualquier lugar público;
  • un dominio, pypi.org: ese nombre;
  • sus subdominios, *.github.com: los nombres a cualquier profundidad por debajo, no el propio github.com;
  • una IP o un CIDR, 203.0.113.7 o 203.0.113.0/24: esas direcciones, marcadas por dirección.

Cualquier entrada admite un puerto: github.com:22. Un dominio en allow sin puerto significa los puertos 80 y 443; una IP, un CIDR o * sin puerto significa todos los puertos. deny guarda excepciones a allow, escritas igual, y gana. Las dos listas suman hasta 100 entradas. Un allow vacío no deja salir nada, y el valor por defecto es allow: ["*"].

Un cambio se aplica al momento, sin reinicio, y cierra las conexiones abiertas que ya no permite.

Cómo se aplica

De un sandbox solo salen TCP y DNS: nada de UDP, así que ni QUIC ni HTTP/3, y nada de ping. Cada conexión TCP pasa por el proxy de salida de su servidor, y cada consulta DNS por el propio resolvedor del sandbox.

  • El DNS solo responde nombres permitidos. El resolvedor solo consulta hacia arriba un nombre que una entrada de dominio (o *) permite, y responde REFUSED a cualquier otro sin preguntar más, así que no salen datos en las consultas DNS.
  • Conecta el proxy, no el sandbox. Lee el nombre que envía un cliente TLS o el Host de una petición HTTP, lo juzga según la lista, resuelve él mismo el nombre y se conecta a esa dirección, nunca a la que eligió el sandbox.
  • El HTTP sin cifrar se juzga petición por petición. Una petición a otro host distinto del que se juzgó para su conexión recibe un 421, y el cliente abre una conexión nueva, juzgada por ese host.
  • Los demás protocolos necesitan un puerto. SSH, y cualquier otra cosa que no sea TLS ni HTTP, solo pasa hacia una entrada de dominio que nombre el puerto, como hace github.com:22.
  • Un rechazo dice por qué. Un cliente HTTP o TLS recibe un 403 que nombra el host y lo que lo rechazó; cualquier otra cosa se corta.

Siempre se rechazan, diga lo que diga la lista: los rangos privados, link-local y CGNAT, el propio servidor, el puerto 25 y HTTP/2 sin TLS.

from pethost.sandboxes import Egress, SandboxSettings, Sandboxes

sandboxes = Sandboxes()  # lee PETHOST_TOKEN
allow = ["pypi.org", "files.pythonhosted.org", "github.com", "*.github.com"]
sandbox = sandboxes.create_sandbox(settings=SandboxSettings(egress=Egress(allow=allow)))

print(sandboxes.run_command(sandbox.sandbox_id, command="curl -sI https://pypi.org/simple/ | head -1").stdout)
# HTTP/2 200
print(sandboxes.run_command(sandbox.sandbox_id, command="curl -sS https://example.com").stderr)
# curl: (6) Could not resolve host: example.com

# también git por SSH, al momento, en el sandbox en ejecución
sandboxes.update_sandbox(sandbox.sandbox_id, settings=SandboxSettings(egress=Egress(allow=allow + ["github.com:22"])))
pethost sandbox new --name builder --allow pypi.org --allow files.pythonhosted.org --allow github.com --allow '*.github.com'
pethost sandbox set builder --allow pypi.org --allow github.com --allow github.com:22   # reemplaza la lista

En qué confía una entrada de dominio

TLS se juzga por el nombre que envía el cliente, y después pasa sin leerse. Así que una entrada de dominio confía en lo que se sirva en las direcciones de ese nombre: otros sitios de una CDN, o un cliente que oculta el nombre que pide. Una barrera que deba aguantar ahí nombra IP, o vincula un secreto al host, cuyo TLS el servidor termina entonces para juzgar cada petición.

Límites y registros

Cada sandbox abre 200 conexiones nuevas por segundo tras una ráfaga de 1000, mantiene 1024 abiertas a través del proxy y hace 200 consultas DNS por segundo. Cada host al que llegó o lo intentó, permitido o no, está en sus eventos, minuto a minuto, con sus conexiones y los bytes en cada sentido, así que puedes escribir una lista a partir de lo que un sandbox usó de verdad. La guía de secretos y salida tiene cada regla.

Cómo se compara

El 21 de noviembre de 2026, boat.dev no tenía control de salida: “boat no tiene ningún ajuste en la API para reglas de red.” E2B permitía y denegaba IP, CIDR y dominios. Daytona restringía el acceso a la red en sus dos primeros niveles, sin forma de cambiarlo ahí, y dejaba configurarlo a partir del nivel 3, que se desbloquea con una recarga de 500 US$. El control por CIDR y dominio de Modal estaba en beta, para TLS en el puerto 443. En Pethost la lista está en todos los planes y en la prueba gratis, y no cuesta nada.

Leer la documentación

Preguntas

¿Qué permite por defecto la salida de un sandbox?

Todas las direcciones públicas, con allow: ["*"]. Los rangos privados, el propio servidor y el puerto 25 se rechazan incluso entonces.

¿Puedo bloquearlo todo?

Sí: envía un allow vacío. El sandbox no llega entonces a nada de fuera, y su DNS no responde nada. Los comandos, los archivos, SSH y las peticiones a sus puertos siguen funcionando: entran, no salen.

¿Funciona git por SSH?

Sí, con github.com:22 en la lista. Los clonados por HTTPS necesitan github.com.

¿Puede un sandbox enviar UDP?

No. De un sandbox solo salen TCP y DNS, y DNS solo a través de su propio resolvedor.

¿Un cambio necesita un reinicio?

No. Se aplica al momento, y cierra las conexiones abiertas que ya no permite.

Relacionado

Dale a tu agente una VM en 0,15 s

Empezar la prueba gratis