Como fazer SSH em um sandbox
Todo sandbox responde SSH na porta 2222 do servidor dele, com o id do sandbox como nome de usuário. O registro dele traz o comando inteiro, ssh_command, como ssh [email protected] -p 2222.
Duas coisas fazem o login. Uma chave pública do espaço de trabalho: adicione a sua uma vez com set_ssh_keys ou nas configurações do painel web, e ela abre todos os sandboxes do espaço de trabalho. Ou um token de conexão como senha, para um programa que não tem chave: connect_sandbox cria um para um sandbox, válido por uma hora por padrão e um dia no máximo. pethost sandbox shell cria um para você e entra com ele.
from pathlib import Path
from pethost.sandboxes import Sandboxes
sandboxes = Sandboxes() # lê o PETHOST_TOKEN
key = Path("~/.ssh/id_ed25519.pub").expanduser().read_text()
sandboxes.set_ssh_keys(ssh_keys=[key]) # substitui as chaves do espaço de trabalho
box = sandboxes.create_sandbox()
print(box.ssh_command)
# ssh [email protected] -p 2222pethost sandbox shell k3x9q2m7v1c8p4ra # entra com um token, sem precisar de chave
scp -P 2222 results.csv [email protected]:/home/user/
ssh -p 2222 -N -L 5432:localhost:5432 [email protected]Como funciona
Nenhum sshd roda no sandbox. O gateway SSH do servidor fala SSH com você e conversa com o daemon do próprio sandbox pelo vsock da VM: o seu shell, o seu comando ou o SFTP roda como um processo dentro do sandbox, e uma porta encaminhada é um túnel para dentro dele. Assim, todo template tem SSH, inclusive os seus, e nada dentro do sandbox fica escutando por ele. O que você roda por SSH é um comando como qualquer outro: aparece em list_commands e nos eventos do sandbox, marcado como iniciado por SSH.
O gateway confere a sua chave ou o seu token antes de qualquer coisa acordar. Então um login acorda primeiro um sandbox PAUSED, com memória e processos como estavam, e uma sessão aberta o mantém acordado: com o ciclo de vida padrão, ele pausa de novo 5 minutos depois que a última sessão termina. Um sandbox STOPPED recusa o login com “stopped: resume it”, a não ser que o ciclo de vida dele o acorde quando parado. Remover uma chave do espaço de trabalho encerra as sessões dessa chave.
Arquivos e túneis
scp e sftp funcionam como em qualquer servidor. Para um arquivo maior do que uma chamada de API comporta, eles são o jeito simples de entrar e sair; a API tem links de download e de upload para o mesmo fim.
ssh -L encaminha uma porta do seu computador para uma porta dentro do sandbox: -L 5432:localhost:5432 alcança um Postgres que o sandbox mantém só para si, e -L 5173:localhost:5173 abre um dev server no seu navegador em localhost:5173 sem tornar a porta pública. É assim também que um navegador abre uma porta privada, já que uma aba do navegador não consegue enviar o token que uma porta privada pede. Só as portas do próprio sandbox são encaminhadas, indicadas como localhost; ssh -R é recusado.
Limites e preços
Porta 2222 no servidor do sandbox; só encaminhamento local. Um canal SSH conta entre as 64 chamadas, streams e links que um sandbox atende ao mesmo tempo, e uma sessão aceita até 64 variáveis de ambiente, com 32 KiB no total. Um token de conexão é uma credencial de root: dê a um programa, nunca coloque em uma página web. SSH não tem preço próprio. O sandbox é cobrado por segundo pelo preço do tamanho, US$ 0,018 por hora para SMALL (2 vCPU, 4 GiB), e roda enquanto uma sessão está aberta.
Como se compara
Em 21 de novembro de 2026, o E2B chegava ao shell de um sandbox por um proxy WebSocket. O boat.dev tem SSH mas não tem pausa: depois de uma parada, a documentação dele diz que uma retomada em até 10 minutos “normalmente traz a mesma máquina de volta, com a memória e os programas rodando. Não conte com isso.”