Українська
Почати

Agent Sandboxes Вихід лише туди, куди дозволено

Список дозволених адрес для кожної пісочниці

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

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

Запитання

Що типово дозволяє вихідний трафік пісочниці?

Кожну публічну адресу, через allow: ["*"]. Приватні діапазони, сам сервер і порт 25 відхиляються навіть тоді.

Чи можна заблокувати все?

Так: надішліть порожній allow. Тоді пісочниця нікуди назовні не дістається, а її DNS нічого не відповідає. Команди, файли, SSH і запити до її портів далі працюють: вони йдуть усередину, а не назовні.

Чи працює git по SSH?

Так, із github.com:22 у списку. Для клонування через HTTPS потрібен github.com.

Чи може пісочниця надсилати UDP?

Ні. З пісочниці виходять лише TCP і DNS, а DNS — лише через її власний резолвер.

Чи потрібен перезапуск після зміни?

Ні. Зміна діє одразу й закриває відкриті з’єднання, які вона більше не дозволяє.

Дивіться також

Дайте агентові комп’ютер за 0,15 с

Почати пробний період