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

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

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

Сервер розробки в пісочниці — це URL для перегляду, який можна надіслати. Нічого не треба реєструвати й нічого не треба чекати, а перегляд, на який ніхто не дивиться, стоїть на паузі за 30 % ціни, доки його не розбудить наступне відвідування.

Адреса

Кожен порт пісочниці має власну HTTPS-адресу, https://<port>-<sandbox id>.<server>: наприклад, https://3000-k3x9q2m7v1c8p4ra.sbx1.sandboxes.pethost.network. Кожен сервер має один wildcard-запис DNS і сертифікат для кожного імені в цьому домені, тож новій пісочниці не потрібен власний запис, і її адреси працюють, щойно вона запуститься.

Сервер передає кожен запит тому, що слухає цей порт усередині пісочниці, зокрема на localhost, тож серверу розробки не потрібен --host 0.0.0.0. Працюють і HTTP/1.1, і HTTP/2, разом із WebSocket, а порти пісочниці обслуговують до 896 запитів одночасно. Серверу розробки, що перевіряє заголовок 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. Сторінка з будь-якого origin може звертатися до порту з його токеном, бо сервер відповідає для нього на CORS, тож фронтенд вашого продукту може спілкуватися з пісочницею користувача, не роблячи порт публічним.

Вкладка браузера, WebSocket чи зображення такого заголовка не надсилають. Те, що людина відкриває в браузері, — це публічний порт або приватний, прокинутий на її комп’ютер через ssh -L.

URL для перегляду, що засинають

Перегляд для кожного вашого користувача — це кілька викликів: шаблон із проєктом і встановленими залежностями, пісочниця з нього, сервер розробки, запущений через run_command з wait_for_port, його публічний порт і короткий таймер паузи. Коли ніхто не дивиться, пісочниця стає на паузу разом із пам’яттю й сервером розробки в ній, за 0,0054 $ на годину для SMALL замість 0,018 $. Наступне відвідування будить її приблизно за 0,2 с, і сервер відповідає з того місця, де зупинився. Пісочниця на паузі зберігає своє місце на сервері, тож пробудження ніколи не відхиляють через брак місця.

Пісочниця в стані STOPPED відповідає на запити до своїх портів кодом 503, «stopped: resume it», якщо її життєвий цикл не задає wake_when_stopped. Тоді відвідування її запускає, а її vCPU зараховуються в тариф і поки вона зупинена. Коли пісочниця стає на паузу й зупиняється.

Ліміти й ціни

Власного домену немає: адреси розміщено в домені сервера пісочниці. До 20 публічних портів. Порти передають HTTP і WebSocket; до звичайного TCP-порту, як-от бази даних, можна дістатися через ssh -L. Адреси всіх пісочниць розміщено в одному домені, тож сервер прибирає Domain з кожної cookie, яку встановлює відповідь: давайте cookie свого застосунку префікс __Host-. Запити до кожного порту видно в подіях пісочниці: рядок на хвилину із запитами, відповідями 5xx і байтами. Порт не має окремої ціни: запити тримають пісочницю пробудженою, з посекундною оплатою за ціною її розміру, а в простої вона стає на паузу.

Порівняння з іншими

21 листопада 2026 року boat.dev типово давав порту URL із токеном у ньому, до 50 портів, а Vercel Sandbox відкривав до 15 портів. Жоден не ставив перегляд на паузу разом із пам’яттю: у boat.dev немає паузи, а зупинена пісочниця Vercel зберігала лише файлову систему. Перегляд Pethost на паузі відповідає наступному відвідувачеві із сервером розробки в тому стані, у якому він був.

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

Запитання

Чи можна використовувати власний домен для URL перегляду?

Ні: кожна адреса розміщена в домені сервера пісочниці.

Чи працюють WebSocket?

Так, на публічних портах із браузера, а на приватних — із програми, що надсилає токен.

Чи будить відвідування пісочницю на паузі?

Так, приблизно за 0,2 с. Зупинена відповідає 503, якщо її життєвий цикл не будить її зупиненою.

Як зробити порт приватним?

Не додавайте його до публічних портів: кожен порт приватний, якщо його не вказано, а токен від create_link відкриває його програмі.

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

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

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