Jak czytać listę dozwolonych
Ustawienia ruchu wychodzącego sandboxa mają dwie listy, allow i deny. Każdy wpis to jedno z poniższych:
*: dowolny adres publiczny;- domena,
pypi.org: ta nazwa; - jej subdomeny,
*.github.com: nazwy na dowolnej głębokości pod nią, ale nie samogithub.com; - IP albo CIDR,
203.0.113.7albo203.0.113.0/24: te adresy, wybierane po adresie.
Każdy wpis może mieć port: github.com:22. Domena w allow bez portu oznacza porty 80 i 443; IP, CIDR albo * bez portu oznacza każdy port. deny zawiera wyjątki od allow, zapisane tak samo, i ma pierwszeństwo. Obie listy mieszczą razem do 100 wpisów. Pusta lista allow nie wypuszcza niczego, a domyślnie jest allow: ["*"].
Zmiana działa od razu, bez restartu, i zamyka otwarte połączenia, na które już nie pozwala.
Jak to jest egzekwowane
Z sandboxa wychodzą tylko TCP i DNS: bez UDP, więc bez QUIC i HTTP/3, i bez pinga. Każde połączenie TCP idzie przez proxy ruchu wychodzącego jego serwera, a każde pytanie DNS do własnego resolvera sandboxa.
- DNS odpowiada tylko na pytania o dozwolone nazwy. Resolver pyta dalej tylko o nazwę, na którą pozwala wpis z domeną (albo
*), a na każdą inną odpowiada REFUSED, nie pytając dalej, więc żadne dane nie wychodzą w pytaniach DNS. - Łączy się proxy, nie sandbox. Czyta nazwę, którą wysyła klient TLS, albo nagłówek Host żądania HTTP, ocenia ją według listy, sam rozwiązuje nazwę i łączy się z tym adresem, nigdy z tym, który wybrał sandbox.
- Zwykłe HTTP jest oceniane żądanie po żądaniu. Żądanie do innego hosta niż ten, według którego oceniono połączenie, dostaje 421, a klient otwiera nowe połączenie, oceniane według tego hosta.
- Inne protokoły potrzebują portu. SSH i wszystko inne, co nie jest ani TLS, ani HTTP, przechodzi tylko do wpisu z domeną, który podaje port, tak jak
github.com:22. - Odmowa mówi dlaczego. Klient HTTP albo TLS dostaje 403 z nazwą hosta i tym, co go odrzuciło; wszystko inne jest resetowane.
Zawsze odrzucane, niezależnie od listy: zakresy prywatne, link-local i CGNAT, sam serwer, port 25 i HTTP/2 bez TLS.
from pethost.sandboxes import Egress, SandboxSettings, Sandboxes
sandboxes = Sandboxes() # czyta 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
# do tego git przez SSH, od razu, w działającym sandboxie
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 # zastępuje listęCzemu ufa wpis z domeną
TLS jest oceniane po nazwie, którą wysyła klient, a potem przechodzi nieczytane. Wpis z domeną ufa więc wszystkiemu, co jest serwowane pod adresami tej nazwy: innym stronom tego samego CDN albo klientowi, który ukrywa nazwę, o którą pyta. Ogrodzenie, które musi tam wytrzymać, podaje adresy IP albo wiąże z hostem sekret, a wtedy serwer kończy TLS tego hosta i ocenia każde żądanie.
Limity i zapisy
Każdy sandbox otwiera 200 nowych połączeń na sekundę po serii 1000, trzyma 1024 otwarte przez proxy i zadaje 200 pytań DNS na sekundę. Każdy host, do którego dotarł albo próbował dotrzeć, dozwolony czy nie, jest w jego zdarzeniach, minuta po minucie, z liczbą połączeń i bajtów w każdą stronę, więc listę możesz napisać na podstawie tego, czego sandbox naprawdę używał. Przewodnik po sekretach i ruchu wychodzącym ma każdą regułę.
Jak to wypada na tle innych
21 listopada 2026 boat.dev nie miało kontroli ruchu wychodzącego: „boat nie ma w API ustawienia reguł sieciowych”. E2B pozwalało dopuszczać i blokować IP, CIDR i domeny. Daytona ograniczała dostęp do sieci na pierwszych dwóch poziomach, bez możliwości zmiany, a ustawienia dawała od poziomu 3, który odblokowuje doładowanie za 500 $. Kontrola po CIDR i domenie w Modalu była w becie, dla TLS na porcie 443. W Pethost lista jest w każdym planie i w okresie próbnym, i nic nie kosztuje.