Comment se lit la liste d’autorisation
Les paramètres de trafic sortant d’une sandbox contiennent deux listes, allow et deny. Chaque entrée est l’une de celles-ci :
*: n’importe où sur l’Internet public ;- un domaine,
pypi.org: ce nom-là ; - ses sous-domaines,
*.github.com: les noms en dessous, à toute profondeur, mais pasgithub.comlui-même ; - une IP ou un CIDR,
203.0.113.7ou203.0.113.0/24: ces adresses, jointes par adresse.
Toute entrée accepte un port : github.com:22. Un domaine dans allow sans port veut dire les ports 80 et 443 ; une IP, un CIDR ou * sans port veut dire tous les ports. deny contient les exceptions à allow, écrites de la même façon, et l’emporte. Les deux listes contiennent jusqu’à 100 entrées à elles deux. Un allow vide ne laisse rien sortir, et la valeur par défaut est allow: ["*"].
Un changement s’applique aussitôt, sans redémarrage, et ferme les connexions ouvertes qu’il n’autorise plus.
Comment elle est appliquée
Seuls TCP et DNS sortent d’une sandbox : pas d’UDP, donc ni QUIC ni HTTP/3, et pas de ping. Chaque connexion TCP passe par le proxy de sortie de son serveur, et chaque question DNS par le résolveur propre à la sandbox.
- Le DNS ne répond qu’aux noms autorisés. Le résolveur n’interroge en amont que pour un nom qu’une entrée de domaine (ou
*) autorise, et répond REFUSED pour tout autre sans aller plus loin : aucune donnée ne sort dans les questions DNS. - C’est le proxy qui se connecte, pas la sandbox. Il lit le nom qu’envoie un client TLS ou l’en-tête Host d’une requête HTTP, le juge selon la liste, résout le nom lui-même et se connecte à cette adresse, jamais à celle choisie par la sandbox.
- Le HTTP en clair est jugé requête par requête. Une requête vers un autre hôte que celui sur lequel sa connexion a été jugée reçoit 421, et le client ouvre une nouvelle connexion, jugée sur cet hôte.
- Les autres protocoles exigent un port. SSH, et tout ce qui n’est ni TLS ni HTTP, ne passe que vers une entrée de domaine qui nomme le port, comme
github.com:22. - Un refus dit pourquoi. Un client HTTP ou TLS reçoit un 403 qui nomme l’hôte et ce qui l’a refusé ; tout le reste est réinitialisé.
Toujours refusés, quoi que dise la liste : les plages privées, link-local et CGNAT, le serveur lui-même, le port 25, et HTTP/2 sans TLS.
from pethost.sandboxes import Egress, SandboxSettings, Sandboxes
sandboxes = Sandboxes() # lit 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
# git par SSH en plus, tout de suite, dans la sandbox qui tourne
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 # remplace la listeCe à quoi une entrée de domaine fait confiance
TLS est jugé sur le nom qu’envoie le client, puis passe sans être lu. Une entrée de domaine fait donc confiance à tout ce qui est servi aux adresses de ce nom : les autres sites d’un CDN, ou un client qui masque le nom qu’il demande. Une barrière qui doit tenir là nomme des IP, ou lie un secret à l’hôte, dont le serveur termine alors le TLS pour juger chaque requête.
Plafonds et traces
Chaque sandbox ouvre 200 nouvelles connexions par seconde après une rafale de 1 000, en garde 1 024 ouvertes via le proxy, et pose 200 questions DNS par seconde. Chaque hôte qu’elle a atteint ou tenté d’atteindre, autorisé ou non, figure dans ses événements minute par minute, avec ses connexions et ses octets dans chaque sens : vous pouvez écrire une liste à partir de ce qu’une sandbox a vraiment utilisé. Le guide des secrets et du trafic sortant détaille chaque règle.
Face aux autres
Le 21 novembre 2026, boat.dev n’avait aucun contrôle du trafic sortant : « boat n’a aucun réglage d’API pour les règles réseau. » E2B autorisait et refusait des IP, des CIDR et des domaines. Daytona restreignait l’accès réseau sur ses deux premiers niveaux, sans moyen de le changer, et vous laissait le régler à partir du niveau 3, qu’un rechargement de 500 $ débloque. Le contrôle par CIDR et par domaine de Modal était en bêta, pour TLS sur le port 443. Chez Pethost, la liste est dans chaque offre et dans l’essai gratuit, et ne coûte rien.