---
title: "URLs de preview para portas de sandboxes · Pethost"
description: "Toda porta de um sandbox do Pethost ganha um endereço HTTPS, público ou privado com um token por porta. Uma visita acorda um sandbox pausado em cerca de 0,2 s."
---

[Agent Sandboxes](https://pethost.dev/pt/sandboxes/) Uma URL para cada porta

# Um endereço HTTPS para cada porta

Um dev server em um sandbox é uma URL de preview que você pode mandar para alguém. Não há nada para registrar nem para esperar, e um preview que ninguém está vendo pausa por 30% do preço até a próxima visita acordá-lo.

Uma visita ao endereço HTTPS da porta 3000 acorda um sandbox pausado em 0,2 s e a página aparece; uma porta privada responde 200 a uma requisição com o token e 401 a uma sem.

## O endereço

Toda porta de um sandbox tem um endereço HTTPS próprio, `https://<port>-<sandbox id>.<server>`: por exemplo, `https://3000-k3x9q2m7v1c8p4ra.sbx1.sandboxes.pethost.network`. Cada servidor tem um registro DNS wildcard e um certificado para todo nome abaixo dele, então um sandbox novo não precisa de registro próprio, e os endereços dele funcionam assim que ele inicia.

O servidor passa cada requisição ao que escuta nessa porta dentro do sandbox, inclusive em `localhost`, então um dev server não precisa de `--host 0.0.0.0`. HTTP/1.1 e HTTP/2 funcionam, WebSockets incluídos, e as portas de um sandbox atendem até 896 requisições ao mesmo tempo. Um dev server que confere o cabeçalho Host, como o do Vite, precisa do host do preview nos hosts permitidos.

Python

CLI

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

sandboxes = Sandboxes()  # lê o 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)  # uma porta privada
print(private.url, private.token)  # uma requisição envia 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   # uma porta privada, e o token dela
```

## Público ou privado

Uma porta listada nas configurações de `ingress` do sandbox é pública: qualquer pessoa com o endereço a abre. Um sandbox lista até 20, na criação ou depois, e nenhuma por padrão.

Todas as outras portas são privadas. Uma porta privada só responde a uma requisição que leva `Pethost-Token: <token>`, com um token que `create_link` cria só para aquela porta, válido por uma hora por padrão e um dia no máximo. O servidor o confere antes de qualquer coisa acordar e tira o cabeçalho, então o seu programa nunca o vê; uma requisição sem ele recebe 401. Uma página de qualquer origem pode chamar a porta com o token, já que o servidor responde ao CORS por ela, então o frontend do seu produto pode falar com o sandbox de um usuário sem tornar uma porta pública.

Uma aba do navegador, um WebSocket ou uma imagem não enviam esse cabeçalho. O que uma pessoa abre no navegador é uma porta pública, ou uma privada encaminhada para o computador dela com [ssh -L](https://pethost.dev/pt/sandboxes/ssh/).

## URLs de preview que dormem

Um preview para cada um dos seus usuários são poucas chamadas: um template com o projeto e as dependências instaladas, um sandbox a partir dele, o dev server iniciado por `run_command` com `wait_for_port`, a porta pública e um timer de pausa curto. Quando ninguém olha, o sandbox pausa com a memória, e com ela o dev server, a US$ 0,0054 por hora para SMALL em vez de US$ 0,018. A próxima visita o acorda em cerca de 0,2 s, e o servidor responde de onde parou. Um sandbox pausado mantém o lugar no servidor, então acordar nunca é recusado por falta de espaço.

Um sandbox STOPPED responde às portas com 503, “stopped: resume it”, a não ser que o ciclo de vida dele diga `wake_when_stopped`. Aí uma visita o inicia, e as vCPUs dele contam no seu plano enquanto está parado. [Quando um sandbox pausa e para](https://pethost.dev/pt/sandboxes/auto-pause/).

## Limites e preços

Sem domínio próprio: os endereços ficam sob o servidor do sandbox. Até 20 portas públicas. As portas levam HTTP e WebSockets; uma porta TCP pura, como a de um banco de dados, é alcançada com ssh -L. O endereço de todo sandbox fica sob um mesmo domínio, então o servidor tira o `Domain` de qualquer cookie que uma resposta define: dê aos cookies do seu app o prefixo `__Host-`. As requisições a cada porta aparecem nos eventos do sandbox, uma linha por minuto com as requisições, as respostas 5xx e os bytes. Uma porta não tem preço próprio: as requisições mantêm o sandbox acordado, cobrado por segundo pelo preço do tamanho, e ocioso ele pausa.

## Como se compara

Em 21 de novembro de 2026, o boat.dev dava a uma porta uma URL com um token por padrão, até 50 portas, e o Vercel Sandbox abria até 15 portas. Nenhum dos dois pausava um preview com a memória: o boat.dev não tem pausa, e um sandbox parado do Vercel guardava só o sistema de arquivos. Um preview pausado do Pethost responde ao próximo visitante com o dev server como estava.

[Ler a documentação](https://pethost.dev/pt/docs/sandboxes/ports-and-previews/)

## Perguntas

**Posso usar o meu próprio domínio nas URLs de preview?**

Não: todo endereço fica sob o nome do servidor do sandbox.

**WebSockets funcionam?**

Sim, em portas públicas a partir de um navegador, e em privadas a partir de um programa que envia o token.

**Uma visita acorda um sandbox pausado?**

Sim, em cerca de 0,2 s. Um parado responde 503, a não ser que o ciclo de vida dele o acorde quando parado.

**Como mantenho uma porta privada?**

Deixe-a fora das portas públicas: toda porta é privada a não ser que esteja listada, e um token de `create_link` a abre para um programa.

## Relacionados

- [Um sandbox pausa: a memória vai para o disco do servidor e o preço cai para 30%; chega uma requisição e ele acorda em 0,08 s com o mesmo processo ainda rodando. Pausa com a memória Um sandbox pausado guarda a memória e os processos no servidor por 30% do preço, e a próxima chamada o acorda em cerca de 0,1 s, exatamente onde estava. Como funciona](https://pethost.dev/pt/sandboxes/pause-resume/)
- [Um programa chama run_command e a saída dos testes volta ao vivo; ele edita um arquivo direto; inicia um dev server e a chamada responde quando a porta 5173 passa a escutar. Comandos, arquivos e um terminal Rode um comando e espere a porta dele, acompanhe a saída ao vivo, edite arquivos por substituição exata, abra um terminal no navegador: uma chamada de API para cada. Como funciona](https://pethost.dev/pt/sandboxes/code-execution/)

## Dê um computador ao seu agente em 0,15 s

[Começar o teste grátis](https://console.pethost.dev/welcome?kind=sandboxes)

Pethost · Stephan Gomer · NIP 1133096755

Pethost

- [Templates](https://pethost.dev/pt/templates/)
- [Sobre nós](https://pethost.dev/about/)
- [Docs](https://pethost.dev/docs/)
- [Blog](https://pethost.dev/pt/blog/)
- [API](https://pethost.dev/docs/api/)
- [CLI](https://pethost.dev/docs/cli/)
- [Plugin](https://github.com/pethost-dev/plugin)
- [Termos](https://pethost.dev/terms/)
- [Privacidade](https://pethost.dev/privacy/)
- [Reembolsos](https://pethost.dev/refunds/)
- [support@pethost.dev](mailto:support@pethost.dev)

Bancos de dados

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

Agent Sandboxes

- [Sandboxes](https://pethost.dev/pt/sandboxes/)
- [Preços](https://pethost.dev/pt/sandboxes/#pricing)
- [Docs](https://pethost.dev/pt/docs/sandboxes/)
- [API](https://pethost.dev/docs/sandboxes/api/)

Comparativos

- [Coolify vs Dokploy vs CapRover vs Dokku](https://pethost.dev/pt/blog/coolify-vs-dokploy-vs-caprover-vs-dokku/)
- [Coolify Cloud vs Dokploy Cloud](https://pethost.dev/pt/blog/coolify-cloud-vs-dokploy-cloud/)
- [Preços Railway vs Render vs Fly.io](https://pethost.dev/pt/blog/railway-vs-render-vs-fly-io-pricing/)
- [Hospedagem gerenciada de Docker Compose](https://pethost.dev/pt/blog/managed-docker-compose-hosting/)

Alternativas

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