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ópriogithub.com; - um IP ou um CIDR,
203.0.113.7ou203.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:22faz. - 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.
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 listaEm 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 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 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 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.