Die Adresse
Jeder Port einer Sandbox hat eine eigene HTTPS-Adresse, https://<port>-<sandbox id>.<server>: zum Beispiel https://3000-k3x9q2m7v1c8p4ra.sbx1.sandboxes.pethost.network. Jeder Server hat einen Wildcard-DNS-Eintrag und ein Zertifikat für jeden Namen darunter, also braucht eine neue Sandbox keinen eigenen Eintrag, und ihre Adressen funktionieren, sobald sie startet.
Der Server reicht jeden Request an das weiter, was in der Sandbox auf diesem Port lauscht, auch auf localhost, also braucht ein Dev-Server kein --host 0.0.0.0. HTTP/1.1 und HTTP/2 funktionieren beide, WebSockets eingeschlossen, und die Ports einer Sandbox bedienen bis zu 896 Requests gleichzeitig. Ein Dev-Server, der den Host-Header prüft, wie der von Vite, braucht den Host der Preview in seinen erlaubten Hosts.
from pethost.sandboxes import Ingress, PublicPort, Sandboxes, SandboxSettings
sandboxes = Sandboxes() # liest 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) # ein privater Port
print(private.url, private.token) # ein Request schickt 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 # ein privater Port und sein TokenÖffentlich oder privat
Ein Port, der in den Einstellungen ingress der Sandbox steht, ist öffentlich: Alle, die die Adresse haben, öffnen ihn. Eine Sandbox führt bis zu 20 auf, beim Erstellen oder später, und standardmäßig keinen.
Jeder andere Port ist privat. Er antwortet nur einem Request, der Pethost-Token: <token> mitschickt, mit einem Token, das create_link für genau diesen Port erstellt, standardmäßig eine Stunde gültig und höchstens einen Tag. Der Server prüft es, bevor irgendetwas aufwacht, und entfernt den Header, sodass dein Programm ihn nie sieht; ein Request ohne ihn bekommt 401. Eine Seite jedes Origins darf den Port mit seinem Token aufrufen, da der Server CORS dafür beantwortet, also kann das Frontend deines Produkts mit der Sandbox einer Person sprechen, ohne einen Port öffentlich zu machen.
Ein Browser-Tab, ein WebSocket oder ein Bild schickt keinen solchen Header. Was eine Person im Browser öffnet, ist ein öffentlicher Port oder ein privater, der mit ssh -L auf ihren Computer weitergeleitet wird.
Preview-URLs, die schlafen
Eine Preview für jede Person, die dein Produkt nutzt, sind ein paar Aufrufe: eine Vorlage mit dem Projekt und seinen installierten Abhängigkeiten, eine Sandbox daraus, der Dev-Server, gestartet mit run_command und wait_for_port, sein Port öffentlich und ein kurzer Pause-Timer. Wenn niemand hinsieht, pausiert die Sandbox mit ihrem RAM, samt Dev-Server, für 0,0054 $ pro Stunde bei SMALL statt 0,018 $. Der nächste Besuch weckt sie in etwa 0,2 s, und der Server antwortet dort, wo er aufgehört hat. Eine pausierte Sandbox behält ihren Platz auf ihrem Server, also wird ein Aufwachen nie aus Platzmangel abgelehnt.
Eine gestoppte Sandbox antwortet auf ihren Ports mit 503, „stopped: resume it“, außer ihr Lebenszyklus sagt wake_when_stopped. Dann startet ein Besuch sie, und ihre vCPUs zählen auch gestoppt gegen deinen Tarif. Wann eine Sandbox pausiert und stoppt.
Grenzen und Preise
Keine eigene Domain: Die Adressen liegen unter dem Server der Sandbox. Bis zu 20 öffentliche Ports. Ports tragen HTTP und WebSockets; einen reinen TCP-Port, etwa den einer Datenbank, erreichst du mit ssh -L. Die Adresse jeder Sandbox liegt unter einer Domain, also entfernt der Server Domain von jedem Cookie, das eine Antwort setzt: Gib den Cookies deiner App das Präfix __Host-. Requests an jeden Port erscheinen in den Events der Sandbox, eine Zeile pro Minute mit den Requests, 5xx-Antworten und Bytes. Ein Port hat keinen eigenen Preis: Requests halten die Sandbox wach, sekundengenau zum Preis ihrer Größe abgerechnet, und im Leerlauf pausiert sie.
Im Vergleich
Am 21. November 2026 gab boat.dev einem Port standardmäßig eine URL mit einem Token darin, bis zu 50 Ports, und Vercel Sandbox öffnete bis zu 15 Ports. Keiner von beiden pausierte eine Preview mit ihrem RAM: boat.dev hat keine Pause, und eine gestoppte Sandbox von Vercel behielt nur ihr Dateisystem. Eine pausierte Preview bei Pethost antwortet dem nächsten Besuch mit dem Dev-Server, wie er war.