Русский
Начать

Agent Sandboxes Исходящий трафик только по списку

Список разрешенных адресов для каждой песочницы

Песочница достает до всего публичного интернета, если вы не скажете иначе. Список разрешенных адресов (allow-list) сужает это до имен, адресов и портов, которые вы перечислите, например вашего реестра пакетов, вашего API и GitHub, и больше песочница никуда не достает.

Как читается список разрешенных адресов

Настройки исходящего трафика песочницы содержат два списка, 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 список есть на каждом тарифе и в пробном периоде и ничего не стоит.

Читать документацию

Вопросы

Что разрешает исходящий трафик песочницы по умолчанию?

Все публичные адреса, через allow: ["*"]. Приватные диапазоны, сам сервер и порт 25 отклоняются даже тогда.

Можно ли закрыть все?

Да: отправьте пустой allow. Тогда песочница никуда наружу не достает, а ее DNS ничего не отвечает. Команды, файлы, SSH и запросы к ее портам по-прежнему работают: они идут внутрь, а не наружу.

Работает ли git по SSH?

Да, если в списке есть github.com:22. Для клонирования по HTTPS нужен github.com.

Может ли песочница отправлять UDP?

Нет. Из песочницы выходят только TCP и DNS, а DNS — только через ее собственный резолвер.

Нужен ли перезапуск после изменения?

Нет. Оно действует сразу и закрывает открытые соединения, которые больше не разрешены.

По теме

Дайте агенту компьютер за 0,15 с

Начать пробный период