Как читается список разрешенных адресов
Настройки исходящего трафика песочницы содержат два списка, 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 $. Управление по CIDR и домену у Modal было в бете, для TLS на порту 443. В Pethost список есть на каждом тарифе и в пробном периоде и ничего не стоит.