Polski
Zacznij

Agent 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.

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.

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.

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.

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ę

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

Daj swojemu agentowi komputer w 0,15 s

Zacznij darmowy okres próbny