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

Agent Sandboxes URL для каждого порта

HTTPS-адрес для каждого порта

Dev-сервер в песочнице — это превью-адрес, который можно отправить. Ничего не нужно регистрировать и ничего не нужно ждать, а превью, на которое никто не смотрит, стоит на паузе за 30% цены, пока его не разбудит следующий заход.

Адрес

У каждого порта песочницы свой 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-сервером в прежнем состоянии.

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

Вопросы

Можно ли использовать свой домен для превью-адресов?

Нет: каждый адрес находится под именем сервера песочницы.

Работают ли WebSockets?

Да, на публичных портах из браузера и на приватных — из программы, которая отправляет токен.

Будит ли заход песочницу на паузе?

Да, примерно за 0,2 с. Остановленная отвечает 503, если только ее жизненный цикл не будит ее в остановленном состоянии.

Как сделать порт приватным?

Не добавляйте его в публичные порты: любой порт приватный, если он не указан, а токен из create_link открывает его программе.

По теме

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

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