Deutsch
Loslegen

Agent Sandboxes Egress nur zu erlaubten Namen

Eine Egress-Allowlist für jede Sandbox

Eine Sandbox erreicht das ganze öffentliche Internet, außer du legst etwas anderes fest. Eine Egress-Allowlist beschränkt das auf die Namen, Adressen und Ports, die du aufführst, etwa deine Paket-Registry, deine API und GitHub, und die Sandbox erreicht nichts anderes.

Wie die Egress-Allowlist gelesen wird

Die Egress-Einstellungen einer Sandbox enthalten zwei Listen, allow und deny. Jeder Eintrag ist eines davon:

  • *: überallhin, wo es öffentlich ist;
  • eine Domain, pypi.org: genau dieser Name;
  • ihre Subdomains, *.github.com: Namen in jeder Tiefe darunter, nicht github.com selbst;
  • eine IP oder ein CIDR, 203.0.113.7 oder 203.0.113.0/24: diese Adressen, direkt angewählt.

Jeder Eintrag nimmt einen Port: github.com:22. Eine Domain in allow ohne Port bedeutet die Ports 80 und 443; eine IP, ein CIDR oder * ohne Port bedeutet jeden Port. deny enthält Ausnahmen von allow, genauso geschrieben, und gewinnt. Die beiden Listen fassen zusammen bis zu 100 Einträge. Ein leeres allow lässt nichts hinaus, und der Standard ist allow: ["*"].

Eine Änderung gilt sofort, ohne Neustart, und schließt die offenen Verbindungen, die sie nicht mehr erlaubt.

Wie sie durchgesetzt wird

Nur TCP und DNS verlassen eine Sandbox: kein UDP, also kein QUIC und kein HTTP/3, und kein Ping. Jede TCP-Verbindung geht über den Egress-Proxy ihres Servers und jede DNS-Frage an den eigenen Resolver der Sandbox.

  • DNS beantwortet nur erlaubte Namen. Der Resolver fragt nur für einen Namen weiter, den ein Domain-Eintrag (oder *) erlaubt, und antwortet für jeden anderen mit REFUSED, ohne weiterzufragen, also verlassen keine Daten die Sandbox in DNS-Fragen.
  • Der Proxy wählt an, nicht die Sandbox. Er liest den Namen, den ein TLS-Client schickt, oder den Host eines HTTP-Requests, prüft ihn gegen die Liste, löst den Namen selbst auf und wählt diese Adresse an, nie die, die die Sandbox gewählt hat.
  • Einfaches HTTP wird Request für Request geprüft. Ein Request an einen anderen Host als den, für den seine Verbindung geprüft wurde, bekommt 421, und der Client öffnet eine neue Verbindung, die für diesen Host geprüft wird.
  • Andere Protokolle brauchen einen Port. SSH und alles andere, was weder TLS noch HTTP ist, kommt nur zu einem Domain-Eintrag durch, der den Port nennt, wie github.com:22.
  • Eine Ablehnung sagt, warum. Ein HTTP- oder TLS-Client bekommt ein 403, das den Host nennt und was ihn abgelehnt hat; alles andere wird zurückgesetzt.

Immer abgelehnt, egal was die Liste sagt: private, Link-Local- und CGNAT-Bereiche, der Server selbst, Port 25 und HTTP/2 ohne TLS.

from pethost.sandboxes import Egress, SandboxSettings, Sandboxes

sandboxes = Sandboxes()  # liest 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

# auch git über SSH, sofort, in der laufenden Sandbox
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   # ersetzt die Liste

Wem ein Domain-Eintrag vertraut

TLS wird nach dem Namen geprüft, den der Client schickt, und geht dann ungelesen durch. Ein Domain-Eintrag vertraut also allem, was unter den Adressen dieses Namens ausgeliefert wird: anderen Sites eines CDN oder einem Client, der den Namen versteckt, nach dem er fragt. Ein Zaun, der dort halten muss, nennt IPs oder bindet ein Secret an den Host, dessen TLS der Server dann terminiert, um jeden Request zu prüfen.

Grenzen und Aufzeichnungen

Jede Sandbox öffnet 200 neue Verbindungen pro Sekunde nach einem Burst von 1.000, hält 1.024 offen über den Proxy und stellt 200 DNS-Fragen pro Sekunde. Jeder Host, den sie erreicht oder versucht hat, erlaubt oder nicht, steht minutenweise in ihren Events, mit seinen Verbindungen und Bytes in jede Richtung, sodass du eine Liste aus dem schreiben kannst, was eine Sandbox wirklich genutzt hat. Die Anleitung zu Secrets und Egress hat jede Regel.

Im Vergleich

Am 21. November 2026 hatte boat.dev keine Egress-Kontrolle: „boat hat keine API-Einstellung für Netzwerkregeln.“ E2B erlaubte und sperrte IPs, CIDRs und Domains. Daytona beschränkte den Netzwerkzugang in seinen ersten beiden Tiers, ohne Möglichkeit, das dort zu ändern, und ließ es ab Tier 3 einstellen, das eine Aufladung von 500 $ freischaltet. Die Kontrolle von Modal per CIDR und Domain war in Beta, für TLS auf Port 443. Bei Pethost ist die Liste in jedem Tarif und in der Testphase dabei und kostet nichts.

Doku lesen

Fragen

Was erlaubt der Egress einer Sandbox standardmäßig?

Jede öffentliche Adresse, über allow: ["*"]. Private Bereiche, der Server selbst und Port 25 werden auch dann abgelehnt.

Kann ich alles sperren?

Ja: Schick ein leeres allow. Die Sandbox erreicht dann nichts draußen, und ihr DNS beantwortet nichts. Befehle, Dateien, SSH und Requests an ihre Ports funktionieren weiter: Sie kommen herein, nicht hinaus.

Funktioniert git über SSH?

Ja, mit github.com:22 in der Liste. Klonen über HTTPS braucht github.com.

Kann eine Sandbox UDP senden?

Nein. Nur TCP und DNS verlassen eine Sandbox, und DNS nur über ihren eigenen Resolver.

Braucht eine Änderung einen Neustart?

Nein. Sie gilt sofort und schließt die offenen Verbindungen, die sie nicht mehr erlaubt.

Verwandte Funktionen

Gib deinem Agenten einen Computer in 0,15 s

Kostenlose Testphase starten