---
title: "URL de prévisualisation des ports d’une sandbox · Pethost"
description: "Chaque port d’une sandbox a une adresse HTTPS : publique, ou privée derrière un token par port. Une visite réveille une sandbox en pause en 0,2 s environ."
---

[Agent Sandboxes](https://pethost.dev/fr/sandboxes/) Une URL pour chaque port

# Une adresse HTTPS pour chaque port

Un serveur de développement dans une sandbox, c’est une URL de prévisualisation que vous pouvez envoyer. Rien à enregistrer, rien à attendre, et une prévisualisation que personne ne regarde se met en pause à 30 % du prix jusqu’à ce que la visite suivante la réveille.

Une visite à l’adresse HTTPS du port 3000 réveille une sandbox en pause en 0,2 s et sa page s’affiche ; un port privé répond 200 à une requête avec son token et 401 à une requête sans.

## L’adresse

Chaque port d’une sandbox a sa propre adresse HTTPS, `https://<port>-<sandbox id>.<server>` : par exemple `https://3000-k3x9q2m7v1c8p4ra.sbx1.sandboxes.pethost.network`. Chaque serveur a un enregistrement DNS wildcard et un certificat pour tous les noms en dessous : une nouvelle sandbox n’a besoin d’aucun enregistrement à elle, et ses adresses marchent dès qu’elle démarre.

Le serveur transmet chaque requête à ce qui écoute sur ce port dans la sandbox, y compris sur `localhost` : un serveur de développement n’a pas besoin de `--host 0.0.0.0`. HTTP/1.1 et HTTP/2 marchent tous deux, WebSockets compris, et les ports d’une sandbox servent jusqu’à 896 requêtes en même temps. Un serveur de développement qui vérifie l’en-tête Host, comme celui de Vite, doit avoir l’hôte de la prévisualisation dans ses hôtes autorisés.

Python

CLI

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

sandboxes = Sandboxes()  # lit 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)  # un port privé
print(private.url, private.token)  # une requête envoie 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   # un port privé, et son token
```

## Public ou privé

Un port listé dans les paramètres `ingress` de la sandbox est public : quiconque a l’adresse l’ouvre. Une sandbox en liste jusqu’à 20, à sa création ou plus tard, et aucun par défaut.

Tous les autres ports sont privés. Ils ne répondent qu’à une requête qui porte `Pethost-Token: <token>`, avec un token que `create_link` crée pour ce seul port, valable une heure par défaut et un jour au plus. Le serveur le vérifie avant que quoi que ce soit ne se réveille et retire l’en-tête, si bien que votre programme ne le voit jamais ; une requête sans token reçoit 401. Une page de n’importe quelle origine peut appeler le port avec son token, puisque le serveur répond au CORS pour lui : le frontend de votre produit peut parler à la sandbox d’un utilisateur sans rendre un port public.

Un onglet de navigateur, un WebSocket ou une image n’envoie pas cet en-tête. Ce qu’une personne ouvre dans un navigateur, c’est un port public, ou un port privé redirigé vers son ordinateur avec [ssh -L](https://pethost.dev/fr/sandboxes/ssh/).

## Des URL de prévisualisation qui dorment

Une prévisualisation pour chacun de vos utilisateurs, c’est quelques appels : un template avec le projet et ses dépendances installées, une sandbox qui en part, le serveur de développement lancé par `run_command` avec `wait_for_port`, son port public, et un délai de pause court. Quand personne ne regarde, la sandbox se met en pause avec sa mémoire, serveur de développement compris, à 0,0054 $ de l’heure pour SMALL au lieu de 0,018 $. La visite suivante la réveille en 0,2 s environ, et le serveur répond là où il en était. Une sandbox en pause garde sa place sur son serveur : un réveil n’est jamais refusé faute de place.

Une sandbox STOPPED répond 503 sur ses ports, « stopped: resume it », sauf si son cycle de vie indique `wake_when_stopped`. Une visite la démarre alors, et ses vCPU comptent dans votre offre même quand elle est arrêtée. [Quand une sandbox se met en pause et s’arrête](https://pethost.dev/fr/sandboxes/auto-pause/).

## Limites et prix

Pas de domaine personnalisé : les adresses sont sous le serveur de la sandbox. Jusqu’à 20 ports publics. Les ports transportent HTTP et WebSockets ; un port TCP brut, comme celui d’une base de données, s’atteint avec ssh -L. Les adresses de toutes les sandboxes sont sous un même domaine : le serveur retire donc le `Domain` de tout cookie qu’une réponse définit, et vous donnez aux cookies de votre application le préfixe `__Host-`. Les requêtes vers chaque port apparaissent dans les événements de la sandbox, une ligne par minute avec les requêtes, les réponses 5xx et les octets. Un port n’a pas de prix à part : les requêtes gardent la sandbox éveillée, facturée à la seconde au prix de sa taille, et inactive, elle se met en pause.

## Face aux autres

Le 21 novembre 2026, boat.dev donnait par défaut à un port une URL contenant un token, jusqu’à 50 ports, et Vercel Sandbox ouvrait jusqu’à 15 ports. Aucun des deux ne mettait une prévisualisation en pause avec sa mémoire : boat.dev n’a pas de pause, et une sandbox Vercel arrêtée ne gardait que son système de fichiers. Une prévisualisation Pethost en pause répond à son visiteur suivant avec le serveur de développement tel qu’il était.

[Lire la documentation](https://pethost.dev/fr/docs/sandboxes/ports-and-previews/)

## Questions

**Puis-je utiliser mon propre domaine pour les URL de prévisualisation ?**

Non : chaque adresse est sous le nom du serveur de la sandbox.

**Les WebSockets marchent-ils ?**

Oui, sur les ports publics depuis un navigateur, et sur les ports privés depuis un programme qui envoie le token.

**Une visite réveille-t-elle une sandbox en pause ?**

Oui, en 0,2 s environ. Une sandbox arrêtée répond 503, sauf si son cycle de vie la réveille quand elle est arrêtée.

**Comment garder un port privé ?**

Laissez-le hors des ports publics : tout port est privé s’il n’est pas listé, et un token de `create_link` l’ouvre à un programme.

## Voir aussi

- [Une sandbox se met en pause : sa mémoire passe sur le disque de son serveur et son prix tombe à 30 % ; une requête arrive et elle se réveille en 0,08 s, avec le même processus toujours en marche. La pause garde la mémoire Une sandbox en pause garde sa mémoire et ses processus sur son serveur à 30 % du prix, et le prochain appel la réveille en 0,1 s environ, exactement là où elle en était. Comment ça marche](https://pethost.dev/fr/sandboxes/pause-resume/)
- [Un programme appelle run_command et la sortie des tests revient en direct ; il modifie un fichier sur place ; il lance un serveur de développement et l’appel répond dès que le port 5173 écoute. Commandes, fichiers et terminal Lancez une commande et attendez son port, suivez sa sortie en direct, modifiez des fichiers par remplacement exact, ouvrez un terminal dans le navigateur : un appel d’API chacun. Comment ça marche](https://pethost.dev/fr/sandboxes/code-execution/)

## Donnez un ordinateur à votre agent en 0,15 s

[Démarrer l’essai gratuit](https://console.pethost.dev/welcome?kind=sandboxes)

Pethost · Stephan Gomer · NIP 1133096755

Pethost

- [Templates](https://pethost.dev/fr/templates/)
- [À propos](https://pethost.dev/about/)
- [Docs](https://pethost.dev/docs/)
- [Blog](https://pethost.dev/fr/blog/)
- [API](https://pethost.dev/docs/api/)
- [CLI](https://pethost.dev/docs/cli/)
- [Plugin](https://github.com/pethost-dev/plugin)
- [Conditions](https://pethost.dev/terms/)
- [Confidentialité](https://pethost.dev/privacy/)
- [Remboursements](https://pethost.dev/refunds/)
- [support@pethost.dev](mailto:support@pethost.dev)

Bases de données

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

Agent Sandboxes

- [Sandboxes](https://pethost.dev/fr/sandboxes/)
- [Tarifs](https://pethost.dev/fr/sandboxes/#pricing)
- [Docs](https://pethost.dev/fr/docs/sandboxes/)
- [API](https://pethost.dev/docs/sandboxes/api/)

Comparatifs

- [Coolify vs Dokploy vs CapRover vs Dokku](https://pethost.dev/fr/blog/coolify-vs-dokploy-vs-caprover-vs-dokku/)
- [Coolify Cloud vs Dokploy Cloud](https://pethost.dev/fr/blog/coolify-cloud-vs-dokploy-cloud/)
- [Tarifs Railway vs Render vs Fly.io](https://pethost.dev/fr/blog/railway-vs-render-vs-fly-io-pricing/)
- [Hébergement Docker Compose managé](https://pethost.dev/fr/blog/managed-docker-compose-hosting/)

Alternatives

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