---
title: "Preview-URLs für die Ports einer Sandbox · Pethost"
description: "Jeder Port einer Pethost-Sandbox hat eine HTTPS-Adresse: öffentlich oder privat hinter einem Token pro Port. Ein Besuch weckt eine pausierte in etwa 0,2 s."
---

[Agent Sandboxes](https://pethost.dev/de/sandboxes/) Eine URL für jeden Port

# Eine HTTPS-Adresse für jeden Port

Ein Dev-Server in einer Sandbox ist eine Preview-URL, die du verschicken kannst. Nichts muss registriert werden, auf nichts musst du warten, und eine Preview, die niemand ansieht, pausiert zu 30 % des Preises, bis der nächste Besuch sie weckt.

Ein Besuch der HTTPS-Adresse von Port 3000 weckt eine pausierte Sandbox in 0,2 s, und ihre Seite erscheint; ein privater Port antwortet 200 auf einen Request mit seinem Token und 401 auf einen ohne.

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

Python

CLI

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

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

[Doku lesen](https://pethost.dev/de/docs/sandboxes/ports-and-previews/)

## Fragen

**Kann ich meine eigene Domain für Preview-URLs nutzen?**

Nein: Jede Adresse liegt unter dem Namen des Servers der Sandbox.

**Funktionieren WebSockets?**

Ja, auf öffentlichen Ports aus einem Browser und auf privaten aus einem Programm, das das Token mitschickt.

**Weckt ein Besuch eine pausierte Sandbox?**

Ja, in etwa 0,2 s. Eine gestoppte antwortet mit 503, außer ihr Lebenszyklus weckt sie auch gestoppt.

**Wie halte ich einen Port privat?**

Lass ihn aus den öffentlichen Ports heraus: Jeder Port ist privat, wenn er nicht aufgeführt ist, und ein Token von `create_link` öffnet ihn für ein Programm.

## Verwandte Funktionen

- [Eine Sandbox pausiert: Ihr RAM wandert auf die Disk ihres Servers, und ihr Preis sinkt auf 30 %; ein Request kommt, und sie wacht in 0,08 s auf, derselbe Prozess läuft noch. Pausiert mit ihrem RAM Eine pausierte Sandbox behält RAM und Prozesse auf ihrem Server zu 30 % des Preises, und der nächste Aufruf weckt sie in etwa 0,1 s, genau dort, wo sie war. So funktioniert es](https://pethost.dev/de/sandboxes/pause-resume/)
- [Ein Programm ruft run_command auf, und die Testausgabe streamt zurück; es bearbeitet eine Datei direkt; es startet einen Dev-Server, und der Aufruf antwortet, sobald Port 5173 lauscht. Befehle, Dateien und ein Terminal Führ einen Befehl aus und warte auf seinen Port, streame seine Ausgabe, bearbeite Dateien per exaktem Ersetzen, öffne ein Terminal im Browser: je ein API-Aufruf. So funktioniert es](https://pethost.dev/de/sandboxes/code-execution/)

## Gib deinem Agenten einen Computer in 0,15 s

[Kostenlose Testphase starten](https://console.pethost.dev/welcome?kind=sandboxes)

Pethost · Stephan Gomer · NIP 1133096755

Pethost

- [Vorlagen](https://pethost.dev/de/templates/)
- [Über uns](https://pethost.dev/about/)
- [Doku](https://pethost.dev/docs/)
- [Blog](https://pethost.dev/de/blog/)
- [API](https://pethost.dev/docs/api/)
- [CLI](https://pethost.dev/docs/cli/)
- [Plugin](https://github.com/pethost-dev/plugin)
- [AGB](https://pethost.dev/terms/)
- [Datenschutz](https://pethost.dev/privacy/)
- [Erstattung](https://pethost.dev/refunds/)
- [support@pethost.dev](mailto:support@pethost.dev)

Datenbanken

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

Agent Sandboxes

- [Sandboxes](https://pethost.dev/de/sandboxes/)
- [Preise](https://pethost.dev/de/sandboxes/#pricing)
- [Doku](https://pethost.dev/de/docs/sandboxes/)
- [API](https://pethost.dev/docs/sandboxes/api/)

Vergleiche

- [Coolify vs Dokploy vs CapRover vs Dokku](https://pethost.dev/de/blog/coolify-vs-dokploy-vs-caprover-vs-dokku/)
- [Coolify Cloud vs Dokploy Cloud](https://pethost.dev/de/blog/coolify-cloud-vs-dokploy-cloud/)
- [Railway vs Render vs Fly.io Preise](https://pethost.dev/de/blog/railway-vs-render-vs-fly-io-pricing/)
- [Managed Hosting für Docker Compose](https://pethost.dev/de/blog/managed-docker-compose-hosting/)

Alternativen

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