Адрес
У каждого порта песочницы свой HTTPS-адрес, https://<port>-<sandbox id>.<server>: например https://3000-k3x9q2m7v1c8p4ra.sbx1.sandboxes.pethost.network. У каждого сервера одна wildcard-запись DNS и сертификат на все имена под ней, поэтому новой песочнице не нужна своя запись, и ее адреса работают сразу после запуска.
Сервер передает каждый запрос тому, кто слушает этот порт внутри песочницы, в том числе на localhost, поэтому dev-серверу не нужен --host 0.0.0.0. Работают и HTTP/1.1, и HTTP/2, включая WebSockets, а порты песочницы обслуживают до 896 запросов одновременно. Dev-серверу, который проверяет заголовок Host, как у Vite, нужно добавить хост превью в разрешенные.
from pethost.sandboxes import Ingress, PublicPort, Sandboxes, SandboxSettings
sandboxes = Sandboxes() # читает PETHOST_TOKEN
box = sandboxes.create_sandbox(settings=SandboxSettings(
ingress=Ingress(public_ports=[PublicPort(port=3000)])))
sandboxes.run_command(box.sandbox_id, command="python3 -m http.server 3000",
wait_for_port=3000)
print(sandboxes.get_sandbox(box.sandbox_id).settings.ingress.public_ports[0].url)
# https://3000-k3x9q2m7v1c8p4ra.sbx1.sandboxes.pethost.network
private = sandboxes.create_link(box.sandbox_id, port=8080) # приватный порт
print(private.url, private.token) # запрос отправляет Pethost-Token: <token>pethost sandbox new --name web --public-port 3000
pethost sandbox run web --wait-for-port 3000 -d -- python3 -m http.server 3000
pethost sandbox url web 3000
pethost sandbox url web 8080 --token # приватный порт и его токенПубличный или приватный
Порт, указанный в настройках ingress песочницы, публичный: его открывает любой, у кого есть адрес. Песочница может указать до 20 таких портов, при создании или позже; по умолчанию — ни одного.
Все остальные порты приватные. Такой порт отвечает только на запрос с заголовком Pethost-Token: <token> и токеном, который create_link создает для этого порта, по умолчанию на час, максимум на сутки. Сервер проверяет его до того, как что-нибудь проснется, и убирает заголовок, так что ваша программа его не видит; запрос без него получает 401. Страница с любого источника может обращаться к порту с его токеном, потому что сервер отвечает на CORS для него, так что фронтенд вашего продукта может общаться с песочницей пользователя, не делая порт публичным.
Вкладка браузера, WebSocket или картинка такой заголовок не отправляют. То, что человек открывает в браузере, — это публичный порт или приватный, проброшенный на его компьютер через ssh -L.
Превью, которые засыпают
Превью для каждого вашего пользователя — это несколько вызовов: шаблон с проектом и установленными зависимостями, песочница из него, dev-сервер, запущенный через run_command с wait_for_port, публичный порт и короткий таймер паузы. Когда никто не смотрит, песочница встает на паузу вместе с памятью и dev-сервером в ней — за 0,0054 $ в час для SMALL вместо 0,018 $. Следующий заход будит ее примерно за 0,2 с, и сервер отвечает с того места, где остановился. Песочница на паузе сохраняет свое место на сервере, поэтому в пробуждении никогда не отказывают из-за нехватки места.
Песочница в состоянии STOPPED отвечает на своих портах 503, «stopped: resume it», если только в ее жизненном цикле не указан wake_when_stopped. Тогда заход запускает ее, а ее vCPU засчитываются в ваш тариф, даже пока она остановлена. Когда песочница встает на паузу и останавливается.
Ограничения и цены
Своего домена нет: адреса находятся под именем сервера песочницы. До 20 публичных портов. Порты передают HTTP и WebSockets; до сырого TCP-порта, например порта базы данных, можно добраться через ssh -L. Адреса всех песочниц находятся под одним доменом, поэтому сервер убирает Domain из любой cookie, которую устанавливает ответ: давайте cookies вашего приложения префикс __Host-. Запросы к каждому порту видны в событиях песочницы, строкой в минуту с числом запросов, ответов 5xx и байтов. Своей цены у порта нет: запросы не дают песочнице уснуть, она оплачивается посекундно по цене своего размера, а в простое встает на паузу.
Сравнение с другими
На 21 ноября 2026 года boat.dev по умолчанию давал порту URL с токеном внутри, до 50 портов, а Vercel Sandbox открывал до 15 портов. Ни один не ставил превью на паузу вместе с памятью: у boat.dev нет паузы, а остановленная песочница Vercel сохраняла только файловую систему. Превью Pethost на паузе отвечает следующему посетителю с dev-сервером в прежнем состоянии.