---
title: "Adresy podglądu dla portów sandboxa · Pethost"
description: "Każdy port sandboxa Pethost dostaje adres HTTPS: publiczny albo prywatny, za tokenem dla tego portu. Wejście budzi wstrzymany sandbox w ok. 0,2 s."
---

[Agent Sandboxes](https://pethost.dev/pl/sandboxes/) Adres dla każdego portu

# Adres HTTPS dla każdego portu

Serwer deweloperski w sandboxie to adres podglądu, który możesz wysłać dalej. Nie trzeba niczego rejestrować ani na nic czekać, a podgląd, na który nikt nie patrzy, wstrzymuje się za 30% ceny, aż następne wejście go obudzi.

Wejście na adres HTTPS portu 3000 budzi wstrzymany sandbox w 0,2 s i pojawia się jego strona; port prywatny odpowiada 200 na żądanie z tokenem i 401 na żądanie bez niego.

## Adres

Każdy port sandboxa ma własny adres HTTPS, `https://<port>-<sandbox id>.<server>`: na przykład `https://3000-k3x9q2m7v1c8p4ra.sbx1.sandboxes.pethost.network`. Każdy serwer ma jeden rekord DNS z symbolem wieloznacznym i certyfikat dla każdej nazwy pod nim, więc nowy sandbox nie potrzebuje własnego rekordu, a jego adresy działają od chwili startu.

Serwer przekazuje każde żądanie temu, co nasłuchuje na tym porcie w sandboxie, także na `localhost`, więc serwer deweloperski nie potrzebuje `--host 0.0.0.0`. Działają HTTP/1.1 i HTTP/2, łącznie z WebSocketami, a porty sandboxa obsługują do 896 żądań naraz. Serwer deweloperski, który sprawdza nagłówek Host, jak serwer Vite, potrzebuje hosta podglądu na liście dozwolonych hostów.

Python

CLI

```
from pethost.sandboxes import Ingress, PublicPort, Sandboxes, SandboxSettings

sandboxes = Sandboxes()  # czyta 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)  # port prywatny
print(private.url, private.token)  # żądanie wysyła 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   # port prywatny i jego token
```

## Publiczny albo prywatny

Port wymieniony w ustawieniach `ingress` sandboxa jest publiczny: otworzy go każdy, kto zna adres. Sandbox może wymienić do 20 portów, przy utworzeniu albo później, a domyślnie nie wymienia żadnego.

Każdy inny port jest prywatny. Odpowiada tylko na żądanie z nagłówkiem `Pethost-Token: <token>`, z tokenem, który `create_link` tworzy dla tego jednego portu, ważnym domyślnie godzinę, a najwyżej dzień. Serwer sprawdza go, zanim cokolwiek się obudzi, i zdejmuje nagłówek, więc twój program go nie widzi; żądanie bez niego dostaje 401. Strona z dowolnego originu może wywołać port z jego tokenem, bo serwer odpowiada na CORS, więc frontend twojego produktu może rozmawiać z sandboxem użytkownika bez upubliczniania portu.

Karta przeglądarki, WebSocket ani obrazek nie wysyłają takiego nagłówka. To, co człowiek otwiera w przeglądarce, to port publiczny albo prywatny przekierowany na jego komputer przez [ssh -L](https://pethost.dev/pl/sandboxes/ssh/).

## Adresy podglądu, które zasypiają

Podgląd dla każdego z twoich użytkowników to kilka wywołań: szablon z projektem i zainstalowanymi zależnościami, sandbox z niego, serwer deweloperski uruchomiony przez `run_command` z `wait_for_port`, publiczny port i krótki licznik wstrzymania. Gdy nikt nie patrzy, sandbox wstrzymuje się z pamięcią, razem z serwerem deweloperskim, i kosztuje wtedy 0,0054 $ za godzinę dla SMALL zamiast 0,018 $. Następne wejście budzi go w ok. 0,2 s, a serwer odpowiada od miejsca, w którym skończył. Wstrzymany sandbox zachowuje swoje miejsce na serwerze, więc wybudzenia nigdy nie odmawiamy z braku miejsca.

Sandbox w stanie STOPPED odpowiada na swoich portach 503, „stopped: resume it”, chyba że jego cykl życia ma `wake_when_stopped`. Wtedy wejście go uruchamia, a jego vCPU liczą się do twojego planu, także gdy jest zatrzymany. [Kiedy sandbox się wstrzymuje i zatrzymuje](https://pethost.dev/pl/sandboxes/auto-pause/).

## Limity i ceny

Bez własnej domeny: adresy są pod nazwą serwera sandboxa. Do 20 portów publicznych. Porty przenoszą HTTP i WebSockety; do surowego portu TCP, na przykład bazy danych, docierasz przez ssh -L. Adresy wszystkich sandboxów są pod jedną domeną, więc serwer zdejmuje `Domain` z każdego ciasteczka, które ustawia odpowiedź: daj ciasteczkom swojej aplikacji prefiks `__Host-`. Żądania do każdego portu widać w zdarzeniach sandboxa, linia na minutę z liczbą żądań, odpowiedzi 5xx i bajtów. Port nie ma własnej ceny: żądania nie pozwalają sandboxowi zasnąć, a ten jest rozliczany co do sekundy po cenie swojego rozmiaru i w bezczynności się wstrzymuje.

## Jak to wypada na tle innych

21 listopada 2026 boat.dev dawało portowi domyślnie adres z tokenem w środku, do 50 portów, a Vercel Sandbox otwierał do 15 portów. Żaden nie wstrzymywał podglądu z pamięcią: boat.dev nie ma wstrzymania, a zatrzymany sandbox Vercela zachowywał tylko system plików. Wstrzymany podgląd w Pethost odpowiada następnemu odwiedzającemu serwerem deweloperskim takim, jaki był.

[Przeczytaj dokumentację](https://pethost.dev/pl/docs/sandboxes/ports-and-previews/)

## Pytania

**Czy mogę użyć własnej domeny dla adresów podglądu?**

Nie: każdy adres jest pod nazwą serwera sandboxa.

**Czy działają WebSockety?**

Tak, na portach publicznych z przeglądarki, a na prywatnych z programu, który wysyła token.

**Czy wejście budzi wstrzymany sandbox?**

Tak, w ok. 0,2 s. Zatrzymany odpowiada 503, chyba że jego cykl życia budzi go po zatrzymaniu.

**Jak utrzymać port jako prywatny?**

Nie dodawaj go do portów publicznych: każdy port jest prywatny, jeśli nie jest wymieniony, a token z `create_link` otwiera go dla programu.

## Powiązane

- [Sandbox się wstrzymuje: jego pamięć trafia na dysk serwera, a cena spada do 30%; przychodzi żądanie i sandbox budzi się w 0,08 s z tym samym procesem wciąż działającym. Wstrzymanie z pamięcią Wstrzymany sandbox trzyma pamięć i procesy na swoim serwerze za 30% ceny, a następne wywołanie budzi go w ok. 0,1 s dokładnie tam, gdzie był. Jak to działa](https://pethost.dev/pl/sandboxes/pause-resume/)
- [Program wywołuje run_command i wynik testów wraca na żywo; edytuje plik na miejscu; uruchamia serwer deweloperski, a wywołanie odpowiada, gdy port 5173 nasłuchuje. Polecenia, pliki i terminal Uruchom polecenie i poczekaj na jego port, odbieraj wynik na żywo, edytuj pliki przez dokładną zamianę, otwórz terminal w przeglądarce: każde to jedno wywołanie API. Jak to działa](https://pethost.dev/pl/sandboxes/code-execution/)

## Daj swojemu agentowi komputer w 0,15 s

[Zacznij darmowy okres próbny](https://console.pethost.dev/welcome?kind=sandboxes)

Pethost · Stephan Gomer · NIP 1133096755

Pethost

- [Szablony](https://pethost.dev/pl/templates/)
- [O nas](https://pethost.dev/about/)
- [Dokumentacja](https://pethost.dev/docs/)
- [Blog](https://pethost.dev/pl/blog/)
- [API](https://pethost.dev/docs/api/)
- [CLI](https://pethost.dev/docs/cli/)
- [Plugin](https://github.com/pethost-dev/plugin)
- [Regulamin](https://pethost.dev/terms/)
- [Prywatność](https://pethost.dev/privacy/)
- [Zwroty](https://pethost.dev/refunds/)
- [support@pethost.dev](mailto:support@pethost.dev)

Bazy danych

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

Agent Sandboxes

- [Sandboxy](https://pethost.dev/pl/sandboxes/)
- [Cennik](https://pethost.dev/pl/sandboxes/#pricing)
- [Dokumentacja](https://pethost.dev/pl/docs/sandboxes/)
- [API](https://pethost.dev/docs/sandboxes/api/)

Porównania

- [Coolify vs Dokploy vs CapRover vs Dokku](https://pethost.dev/pl/blog/coolify-vs-dokploy-vs-caprover-vs-dokku/)
- [Coolify Cloud vs Dokploy Cloud](https://pethost.dev/pl/blog/coolify-cloud-vs-dokploy-cloud/)
- [Cennik Railway vs Render vs Fly.io](https://pethost.dev/pl/blog/railway-vs-render-vs-fly-io-pricing/)
- [Zarządzany hosting Docker Compose](https://pethost.dev/pl/blog/managed-docker-compose-hosting/)

Alternatywy

- [Alternatywy dla Railway](https://pethost.dev/pl/blog/railway-alternatives/)
- [Alternatywy dla Heroku](https://pethost.dev/pl/blog/heroku-alternatives/)
- [Alternatywy dla Dokploy](https://pethost.dev/pl/blog/dokploy-alternatives/)
- [Alternatywy dla Coolify](https://pethost.dev/pl/blog/coolify-alternatives/)
- [Alternatywy dla Render](https://pethost.dev/pl/blog/render-alternatives/)
- [Alternatywy dla Sliplane](https://pethost.dev/pl/blog/sliplane-alternatives/)
