---
title: "Saída do sandbox liberada por domínio, IP e CIDR · Pethost"
description: "Escolha a que um sandbox do Pethost se conecta: domínios, wildcards, IPs, CIDRs e portas. O DNS só responde nomes liberados, sem UDP, e mudanças valem na hora."
---

[Agent Sandboxes](https://pethost.dev/pt/sandboxes/) Saída que você libera, por nome

# Uma lista de permissões de saída para cada sandbox

Um sandbox alcança toda a internet pública, a não ser que você diga o contrário. Uma lista de permissões de saída restringe isso aos nomes, endereços e portas que você listar, como o seu registry de pacotes, a sua API e o GitHub, e o sandbox não alcança mais nada.

As conexões de um sandbox passam por um portão que libera pypi.org e *.github.com e recusa example.com com 403; uma pergunta DNS por um nome fora da lista recebe REFUSED, e o UDP não sai.

## Como se lê a lista de permissões de saída

As configurações de saída de um sandbox guardam duas listas, `allow` e `deny`. Cada entrada é uma destas:

- `*`: qualquer lugar público;
- um domínio, `pypi.org`: esse nome;
- os subdomínios dele, `*.github.com`: nomes em qualquer profundidade abaixo dele, não o próprio `github.com`;
- um IP ou um CIDR, `203.0.113.7` ou `203.0.113.0/24`: esses endereços, acessados pelo endereço.

Qualquer entrada aceita uma porta: `github.com:22`. Um domínio em `allow` sem porta quer dizer as portas 80 e 443; um IP, um CIDR ou `*` sem porta quer dizer todas as portas. `deny` guarda exceções ao `allow`, escritas do mesmo jeito, e vence. As duas listas guardam até 100 entradas juntas. Um `allow` vazio não deixa nada sair, e o padrão é `allow: ["*"]`.

Uma mudança vale na hora, sem reinício, e fecha as conexões abertas que ela não permite mais.

## Como a lista é aplicada

Só TCP e DNS saem de um sandbox: nada de UDP, então nada de QUIC ou HTTP/3, e nada de ping. Toda conexão TCP passa pelo proxy de saída do servidor, e toda pergunta DNS pelo resolver próprio do sandbox.

- **O DNS só responde nomes permitidos.** O resolver só consulta o upstream por um nome que uma entrada de domínio (ou `*`) permite, e responde REFUSED para qualquer outro sem consultar adiante, então nenhum dado sai em perguntas DNS.
- **Quem se conecta é o proxy, não o sandbox.** Ele lê o nome que um cliente TLS envia ou o Host de uma requisição HTTP, julga-o pela lista, resolve o nome ele mesmo e se conecta a esse endereço, nunca ao que o sandbox escolheu.
- **HTTP puro é julgado requisição por requisição.** Uma requisição para outro host que não aquele pelo qual a conexão foi julgada recebe 421, e o cliente abre uma nova conexão, julgada por esse host.
- **Outros protocolos precisam de uma porta.** O SSH, e qualquer outra coisa que não seja TLS nem HTTP, só passa para uma entrada de domínio que indique a porta, como `github.com:22` faz.
- **Uma recusa diz o porquê.** Um cliente HTTP ou TLS recebe um 403 que indica o host e o que o recusou; qualquer outra coisa recebe um reset.

Sempre recusados, diga a lista o que disser: faixas privadas, link-local e CGNAT, o próprio servidor, a porta 25 e HTTP/2 sem TLS.

Python

CLI

```
from pethost.sandboxes import Egress, SandboxSettings, Sandboxes

sandboxes = Sandboxes()  # lê o PETHOST_TOKEN
allow = ["pypi.org", "files.pythonhosted.org", "github.com", "*.github.com"]
sandbox = sandboxes.create_sandbox(settings=SandboxSettings(egress=Egress(allow=allow)))

print(sandboxes.run_command(sandbox.sandbox_id, command="curl -sI https://pypi.org/simple/ | head -1").stdout)
# HTTP/2 200
print(sandboxes.run_command(sandbox.sandbox_id, command="curl -sS https://example.com").stderr)
# curl: (6) Could not resolve host: example.com

# git por SSH também, na hora, no sandbox rodando
sandboxes.update_sandbox(sandbox.sandbox_id, settings=SandboxSettings(egress=Egress(allow=allow + ["github.com:22"])))
```

```
pethost sandbox new --name builder --allow pypi.org --allow files.pythonhosted.org --allow github.com --allow '*.github.com'
pethost sandbox set builder --allow pypi.org --allow github.com --allow github.com:22   # substitui a lista
```

## Em que uma entrada de domínio confia

O TLS é julgado pelo nome que o cliente envia, e depois passa sem ser lido. Então uma entrada de domínio confia em tudo o que é servido nos endereços desse nome: outros sites de uma CDN, ou um cliente que esconde o nome que pede. Uma cerca que precisa segurar aí indica IPs, ou liga um [segredo](https://pethost.dev/pt/sandboxes/secrets/) ao host, cujo TLS o servidor então termina para julgar cada requisição.

## Limites e registros

Cada sandbox abre 200 conexões novas por segundo depois de um pico de 1.000, mantém 1.024 abertas pelo proxy e faz 200 perguntas DNS por segundo. Todo host que ele alcançou ou tentou, permitido ou não, está nos [eventos](https://pethost.dev/pt/sandboxes/observability/) dele, um minuto por vez, com as conexões e os bytes em cada sentido, então você pode escrever uma lista a partir do que um sandbox realmente usou. O [guia de segredos e saída](https://pethost.dev/pt/docs/sandboxes/secrets-and-egress/) tem todas as regras.

## Como se compara

Em 21 de novembro de 2026, o boat.dev não tinha controle de saída: “o boat não tem configuração de API para regras de rede.” O E2B permitia e negava IPs, CIDRs e domínios. O Daytona restringia o acesso à rede nos dois primeiros tiers, sem como mudar isso lá, e deixava configurá-lo a partir do tier 3, que uma recarga de US$ 500 libera. O controle por CIDR e domínio do Modal estava em beta, para TLS na porta 443. No Pethost a lista está em todos os planos e no teste grátis, e não custa nada.

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

## Perguntas

**O que a saída de um sandbox permite por padrão?**

Todo endereço público, por `allow: ["*"]`. Faixas privadas, o próprio servidor e a porta 25 são recusados mesmo assim.

**Dá para bloquear tudo?**

Sim: envie um `allow` vazio. O sandbox então não alcança nada lá fora, e o DNS dele não responde nada. Comandos, arquivos, SSH e requisições às portas dele continuam funcionando: eles entram, não saem.

**O git por SSH funciona?**

Sim, com `github.com:22` na lista. Clones por HTTPS precisam de `github.com`.

**Um sandbox pode enviar UDP?**

Não. Só TCP e DNS saem de um sandbox, e o DNS só pelo resolver próprio dele.

**Uma mudança precisa de reinício?**

Não. Ela vale na hora e fecha as conexões abertas que não permite mais.

## Relacionados

- [Dentro do sandbox a chave de API é um marcador; o proxy de saída coloca a chave real na requisição para api.anthropic.com, e uma requisição para outro host fica com o marcador. Chaves que nunca entram Um sandbox vê um marcador; o proxy de saída o troca pela chave de API real nos cabeçalhos das requisições HTTPS, só para os hosts que você indicar. Como funciona](https://pethost.dev/pt/sandboxes/secrets/)
- [O painel de um sandbox: uma linha de CPU, a memória em uso e um stream de eventos: criado, um comando que saiu com 0, os hosts que alcançou, um turno de agente com os tokens, pausado. Cada comando, host e turno CPU, memória, disco e rede por 24 horas; cada mudança de ciclo de vida, comando, host alcançado e turno de agente, como lista ou stream ao vivo. Como funciona](https://pethost.dev/pt/sandboxes/observability/)

## 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/)
