Español
Empezar

Agent Sandboxes Una URL para cada puerto

Una dirección HTTPS para cada puerto

Un servidor de desarrollo en un sandbox es una URL de vista previa que puedes enviar. No hay nada que registrar ni nada que esperar, y una vista previa que nadie mira se pausa al 30 % del precio hasta que la siguiente visita la despierta.

La dirección

Cada puerto de un sandbox tiene su propia dirección HTTPS, https://<port>-<sandbox id>.<server>: por ejemplo, https://3000-k3x9q2m7v1c8p4ra.sbx1.sandboxes.pethost.network. Cada servidor tiene un registro DNS comodín y un certificado para cada nombre bajo él, así que un sandbox nuevo no necesita un registro propio, y sus direcciones funcionan en cuanto se inicia.

El servidor pasa cada petición a lo que escucha en ese puerto dentro del sandbox, también en localhost, así que un servidor de desarrollo no necesita --host 0.0.0.0. Funcionan HTTP/1.1 y HTTP/2, WebSockets incluidos, y los puertos de un sandbox atienden hasta 896 peticiones a la vez. Un servidor de desarrollo que comprueba la cabecera Host, como el de Vite, necesita el host de la vista previa entre sus hosts permitidos.

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

sandboxes = Sandboxes()  # lee 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 puerto privado
print(private.url, private.token)  # una petición enví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   # un puerto privado y su token

Público o privado

Un puerto que aparece en los ajustes ingress del sandbox es público: cualquiera con la dirección lo abre. Un sandbox puede listar hasta 20, al crearlo o después, y ninguno por defecto.

Cualquier otro puerto es privado. Solo responde a una petición que lleva Pethost-Token: <token>, con un token que create_link crea para ese único puerto, válido una hora por defecto y un día como máximo. El servidor lo comprueba antes de que nada despierte y quita la cabecera, así que tu programa nunca la ve; una petición sin ella recibe un 401. Una página de cualquier origen puede llamar al puerto con su token, ya que el servidor responde a CORS para él, así que el frontend de tu producto puede hablar con el sandbox de un usuario sin hacer público ningún puerto.

Una pestaña del navegador, un WebSocket o una imagen no envían esa cabecera. Lo que una persona abre en un navegador es un puerto público, o uno privado reenviado a su equipo con ssh -L.

URL de vista previa que se duermen

Una vista previa para cada uno de tus usuarios son unas pocas llamadas: una plantilla con el proyecto y sus dependencias instaladas, un sandbox a partir de ella, el servidor de desarrollo iniciado con run_command y wait_for_port, su puerto público y un temporizador de pausa corto. Cuando nadie mira, el sandbox se pausa con su memoria, con el servidor de desarrollo dentro, a 0,0054 US$ la hora para SMALL en vez de 0,018 US$. La siguiente visita lo despierta en unos 0,2 s, y el servidor responde donde lo dejó. Un sandbox en pausa conserva su sitio en su servidor, así que despertarlo nunca se rechaza por falta de espacio.

Un sandbox detenido (STOPPED) responde en sus puertos con un 503, “stopped: resume it”, salvo que su ciclo de vida indique wake_when_stopped. En ese caso una visita lo inicia, y sus vCPU cuentan para tu plan mientras está detenido. Cuándo se pausa y se detiene un sandbox.

Límites y precios

Sin dominio propio: las direcciones están bajo el servidor del sandbox. Hasta 20 puertos públicos. Los puertos llevan HTTP y WebSockets; a un puerto TCP sin más, como el de una base de datos, se llega con ssh -L. Las direcciones de todos los sandboxes están bajo un mismo dominio, así que el servidor quita el Domain de cualquier cookie que fije una respuesta: dale a las cookies de tu app el prefijo __Host-. Las peticiones a cada puerto aparecen en los eventos del sandbox, una línea por minuto con las peticiones, las respuestas 5xx y los bytes. Un puerto no tiene precio propio: las peticiones mantienen despierto el sandbox, facturado por segundo al precio de su tamaño, y si está inactivo se pausa.

Cómo se compara

El 21 de noviembre de 2026, boat.dev daba a un puerto una URL con un token incluido por defecto, hasta 50 puertos, y Vercel Sandbox abría hasta 15 puertos. Ninguno pausaba una vista previa con su memoria: boat.dev no tiene pausa, y un sandbox de Vercel detenido solo conservaba su sistema de archivos. Una vista previa de Pethost en pausa responde a su siguiente visitante con el servidor de desarrollo como estaba.

Leer la documentación

Preguntas

¿Puedo usar mi propio dominio para las URL de vista previa?

No: todas las direcciones están bajo el nombre del servidor del sandbox.

¿Funcionan los WebSockets?

Sí, en los puertos públicos desde un navegador, y en los privados desde un programa que envía el token.

¿Una visita despierta un sandbox en pausa?

Sí, en unos 0,2 s. Uno detenido responde con un 503 salvo que su ciclo de vida lo despierte estando detenido.

¿Cómo mantengo privado un puerto?

Déjalo fuera de los puertos públicos: todo puerto es privado salvo que se liste, y un token de create_link lo abre a un programa.

Relacionado

Dale a tu agente una VM en 0,15 s

Empezar la prueba gratis