Polski
Zacznij

Agent Sandboxes Ruch wychodzący tylko tam, gdzie pozwolisz

Lista dozwolonych dla ruchu wychodzącego w każdym sandboxie

Sandbox dociera do całego publicznego internetu, chyba że postanowisz inaczej. Lista dozwolonych dla ruchu wychodzącego zawęża to do nazw, adresów i portów, które wypiszesz, takich jak twój rejestr pakietów, twoje API i GitHub, a do niczego innego sandbox nie dotrze.

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 samo github.com;
  • IP albo CIDR, 203.0.113.7 albo 203.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.

Przeczytaj dokumentację

Pytania

Na co domyślnie pozwala ruch wychodzący sandboxa?

Na każdy adres publiczny, przez allow: ["*"]. Zakresy prywatne, sam serwer i port 25 są odrzucane nawet wtedy.

Czy mogę zablokować wszystko?

Tak: wyślij pustą listę allow. Sandbox nie dotrze wtedy do niczego na zewnątrz, a jego DNS nie odpowie na żadne pytanie. Polecenia, pliki, SSH i żądania do jego portów dalej działają: przychodzą do środka, nie wychodzą.

Czy działa git przez SSH?

Tak, z github.com:22 na liście. Klonowanie przez HTTPS wymaga github.com.

Czy sandbox może wysyłać UDP?

Nie. Z sandboxa wychodzą tylko TCP i DNS, a DNS tylko przez jego własny resolver.

Czy zmiana wymaga restartu?

Nie. Działa od razu i zamyka otwarte połączenia, na które już nie pozwala.

Powiązane

Daj swojemu agentowi komputer w 0,15 s

Zacznij darmowy okres próbny