---
title: "Превью-адреса для портов песочниц · Pethost"
description: "Любой порт песочницы Pethost получает HTTPS-адрес: публичный или приватный, за токеном для этого порта. Заход будит песочницу на паузе примерно за 0,2 с."
---

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

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

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

Заход на HTTPS-адрес порта 3000 будит песочницу на паузе за 0,2 с, и появляется ее страница; приватный порт отвечает 200 на запрос с токеном и 401 на запрос без него.

## Адрес

У каждого порта песочницы свой 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, нужно добавить хост превью в разрешенные.

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. Страница с любого источника может обращаться к порту с его токеном, потому что сервер отвечает на CORS для него, так что фронтенд вашего продукта может общаться с песочницей пользователя, не делая порт публичным.

Вкладка браузера, WebSocket или картинка такой заголовок не отправляют. То, что человек открывает в браузере, — это публичный порт или приватный, проброшенный на его компьютер через [ssh -L](https://pethost.dev/ru/sandboxes/ssh/).

## Превью, которые засыпают

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

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

## Ограничения и цены

Своего домена нет: адреса находятся под именем сервера песочницы. До 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-сервером в прежнем состоянии.

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

## Вопросы

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

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

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

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

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

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

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

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

## По теме

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

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

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

Pethost · Stephan Gomer · NIP 1133096755

Pethost

- [Шаблоны](https://pethost.dev/ru/templates/)
- [О нас](https://pethost.dev/about/)
- [Документация](https://pethost.dev/docs/)
- [Блог](https://pethost.dev/ru/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/ru/postgres/)
- [Valkey](https://pethost.dev/ru/valkey/)

Agent Sandboxes

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

Сравнения

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

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

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