Як читається список дозволених адрес
Налаштування вихідного трафіку пісочниці містять два списки, allow і deny. Кожен запис — одне з такого:
*: будь-яка публічна адреса;- домен,
pypi.org: саме це ім’я; - його піддомени,
*.github.com: імена будь-якої глибини в цьому домені, але не самgithub.com; - IP або CIDR,
203.0.113.7чи203.0.113.0/24: ці адреси, коли з’єднання йде за адресою.
Будь-який запис може мати порт: github.com:22. Домен в allow без порту означає порти 80 і 443; IP, CIDR або * без порту — усі порти. deny містить винятки з allow, записані так само, і має перевагу. Обидва списки разом уміщують до 100 записів. Порожній allow нічого не випускає, а типово стоїть allow: ["*"].
Зміна діє одразу, без перезапуску, і закриває відкриті з’єднання, які вона більше не дозволяє.
Як це забезпечується
З пісочниці виходять лише TCP і DNS: ні UDP, тож ні QUIC чи HTTP/3, ні ping. Кожне TCP-з’єднання йде через проксі вихідного трафіку її сервера, а кожен DNS-запит — до власного резолвера пісочниці.
- DNS відповідає лише на дозволені імена. Резолвер питає вище за ланцюжком лише про ім’я, яке дозволяє доменний запис (або
*), а на будь-яке інше відповідає REFUSED, нікого не питаючи, тож жодні дані не виходять у DNS-запитах. - З’єднується проксі, а не пісочниця. Він читає ім’я, яке надсилає TLS-клієнт, або Host HTTP-запиту, перевіряє його за списком, сам резолвить ім’я й з’єднується з цією адресою, а не з тією, яку обрала пісочниця.
- Звичайний HTTP перевіряється запит за запитом. На запит до іншого хоста, ніж той, за яким перевірено з’єднання, приходить відповідь 421, і клієнт відкриває нове з’єднання, яке перевіряється за цим хостом.
- Іншим протоколам потрібен порт. SSH і все інше, що не є ні TLS, ні HTTP, проходить лише до доменного запису з указаним портом, як-от
github.com:22. - Відмова пояснює причину. HTTP- чи TLS-клієнт отримує 403 із назвою хоста й того, що його відхилило; усе інше скидається.
Завжди відхиляються, хоч би що казав список: приватні, link-local і CGNAT-діапазони, сам сервер, порт 25 і HTTP/2 без TLS.
from pethost.sandboxes import Egress, SandboxSettings, Sandboxes
sandboxes = Sandboxes() # читає 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 по SSH, одразу, у пісочниці, що працює
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 # замінює списокЧому довіряє доменний запис
TLS перевіряється за ім’ям, яке надсилає клієнт, а далі проходить непрочитаним. Тож доменний запис довіряє всьому, що віддається за адресами цього імені: іншим сайтам CDN або клієнту, що приховує ім’я, яке запитує. Огорожа, яка має там витримати, називає IP або прив’язує до хоста секрет, і тоді сервер сам завершує TLS цього хоста, щоб перевіряти кожен запит.
Межі й записи
Кожна пісочниця відкриває 200 нових з’єднань на секунду після сплеску в 1 000, тримає 1 024 відкритих через проксі й ставить 200 DNS-запитів на секунду. Кожен хост, до якого вона дісталася чи намагалася дістатися, дозволений чи ні, є в її подіях щохвилини, з її з’єднаннями й байтами в кожен бік, тож список можна скласти з того, що пісочниця справді використовувала. Посібник із секретів і вихідного трафіку описує кожне правило.
Порівняння з іншими
21 листопада 2026 року boat.dev не мав керування вихідним трафіком: «у boat немає налаштування мережевих правил в API». E2B дозволяв і забороняв IP, CIDR і домени. Daytona обмежувала доступ до мережі на перших двох рівнях без можливості це змінити й дозволяла налаштовувати його з рівня 3, який відкриває поповнення на 500 $. Керування в Modal за CIDR і доменом було в беті, для TLS на порту 443. У Pethost список є в кожному тарифі й у пробному періоді та нічого не коштує.