---
title: "URL для перегляду портів пісочниці · Pethost"
description: "Будь-який порт пісочниці Pethost отримує HTTPS-адресу: публічну або приватну, за токеном порту. Відвідування будить пісочницю на паузі приблизно за 0,2 с."
---

[Agent Sandboxes](https://pethost.dev/uk/sandboxes/) URL для кожного порту

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

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

Відвідування HTTPS-адреси порту 3000 будить пісочницю на паузі за 0,2 с, і з’являється її сторінка; приватний порт відповідає 200 на запит із токеном і 401 на запит без нього.

## Адреса

Кожен порт пісочниці має власну 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, потрібно додати хост перегляду до дозволених хостів.

Python

CLI

```
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](https://pethost.dev/uk/sandboxes/ssh/).

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

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

Пісочниця в стані STOPPED відповідає на запити до своїх портів кодом 503, «stopped: resume it», якщо її життєвий цикл не задає `wake_when_stopped`. Тоді відвідування її запускає, а її vCPU зараховуються в тариф і поки вона зупинена. [Коли пісочниця стає на паузу й зупиняється](https://pethost.dev/uk/sandboxes/auto-pause/).

## Ліміти й ціни

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

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

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

[Читати документацію](https://pethost.dev/uk/docs/sandboxes/ports-and-previews/)

## Запитання

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

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

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

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

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

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

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

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

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

- [Пісочниця стає на паузу: її пам’ять переходить на диск сервера, а ціна падає до 30 %; приходить запит, і вона прокидається за 0,08 с, а той самий процес досі працює. Пауза разом із пам’яттю Пісочниця на паузі зберігає пам’ять і процеси на своєму сервері за 30 % ціни, а наступний виклик будить її приблизно за 0,1 с, саме там, де вона була. Як це працює](https://pethost.dev/uk/sandboxes/pause-resume/)
- [Програма викликає run_command, і вивід тестів транслюється назад; вона редагує файл на місці; вона запускає сервер розробки, і виклик відповідає, щойно порт 5173 починає слухати. Команди, файли й термінал Запустіть команду й дочекайтеся її порту, транслюйте вивід, редагуйте файли точною заміною, відкрийте термінал у браузері: кожне — одним викликом API. Як це працює](https://pethost.dev/uk/sandboxes/code-execution/)

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

[Почати пробний період](https://console.pethost.dev/welcome?kind=sandboxes)

Pethost · Stephan Gomer · NIP 1133096755

Pethost

- [Шаблони](https://pethost.dev/uk/templates/)
- [Про нас](https://pethost.dev/about/)
- [Документація](https://pethost.dev/docs/)
- [Блог](https://pethost.dev/uk/blog/)
- [API](https://pethost.dev/docs/api/)
- [CLI](https://pethost.dev/docs/cli/)
- [Плагін](https://github.com/pethost-dev/plugin)
- [Умови](https://pethost.dev/terms/)
- [Конфіденційність](https://pethost.dev/privacy/)
- [Повернення коштів](https://pethost.dev/refunds/)
- [support@pethost.dev](mailto:support@pethost.dev)

Бази даних

- [Postgres](https://pethost.dev/uk/postgres/)
- [Valkey](https://pethost.dev/uk/valkey/)

Agent Sandboxes

- [Пісочниці](https://pethost.dev/uk/sandboxes/)
- [Тарифи](https://pethost.dev/uk/sandboxes/#pricing)
- [Документація](https://pethost.dev/uk/docs/sandboxes/)
- [API](https://pethost.dev/docs/sandboxes/api/)

Порівняння

- [Coolify vs Dokploy vs CapRover vs Dokku](https://pethost.dev/uk/blog/coolify-vs-dokploy-vs-caprover-vs-dokku/)
- [Coolify Cloud vs Dokploy Cloud](https://pethost.dev/uk/blog/coolify-cloud-vs-dokploy-cloud/)
- [Ціни Railway vs Render vs Fly.io](https://pethost.dev/uk/blog/railway-vs-render-vs-fly-io-pricing/)
- [Керований хостинг Docker Compose](https://pethost.dev/uk/blog/managed-docker-compose-hosting/)

Альтернативи

- [Альтернативи Railway](https://pethost.dev/uk/blog/railway-alternatives/)
- [Альтернативи Heroku](https://pethost.dev/uk/blog/heroku-alternatives/)
- [Альтернативи Dokploy](https://pethost.dev/uk/blog/dokploy-alternatives/)
- [Альтернативи Coolify](https://pethost.dev/uk/blog/coolify-alternatives/)
- [Альтернативи Render](https://pethost.dev/uk/blog/render-alternatives/)
- [Альтернативи Sliplane](https://pethost.dev/uk/blog/sliplane-alternatives/)
