Français
Commencer

Agent Sandboxes Trafic sortant autorisé, par nom

Une liste d’autorisation du trafic sortant pour chaque sandbox

Une sandbox atteint tout l’Internet public, sauf si vous en décidez autrement. Une liste d’autorisation du trafic sortant restreint cela aux noms, adresses et ports que vous listez, comme votre registre de paquets, votre API et GitHub, et la sandbox n’atteint rien d’autre.

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 pas github.com lui-même ;
  • une IP ou un CIDR, 203.0.113.7 ou 203.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 liste

Ce à 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.

Lire la documentation

Questions

Qu’autorise par défaut le trafic sortant d’une sandbox ?

Toute adresse publique, via allow: ["*"]. Les plages privées, le serveur lui-même et le port 25 sont refusés même dans ce cas.

Puis-je tout bloquer ?

Oui : envoyez un allow vide. La sandbox n’atteint alors plus rien à l’extérieur, et son DNS ne répond à rien. Les commandes, les fichiers, SSH et les requêtes vers ses ports marchent toujours : ils entrent, ils ne sortent pas.

git par SSH marche-t-il ?

Oui, avec github.com:22 dans la liste. Les clones par HTTPS ont besoin de github.com.

Une sandbox peut-elle envoyer de l’UDP ?

Non. Seuls TCP et DNS sortent d’une sandbox, et le DNS seulement par son propre résolveur.

Un changement exige-t-il un redémarrage ?

Non. Il s’applique aussitôt, et ferme les connexions ouvertes qu’il n’autorise plus.

Voir aussi

Donnez un ordinateur à votre agent en 0,15 s

Démarrer l’essai gratuit