Português
Começar

Agent Sandboxes SSH puro, scp e túneis

SSH em qualquer sandbox

As ferramentas que você já usa, apontadas para um sandbox: ssh para um shell, scp e sftp para arquivos, ssh -L para uma porta. Não há servidor SSH para instalar, e um login acorda um sandbox pausado onde ele estava.

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 2222
pethost 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.”

Ler a documentação

Perguntas

Preciso de sshd no meu template para fazer SSH em um sandbox?

Não. O servidor atende o SSH e roda a sua sessão dentro do sandbox, então todo template tem SSH, o nosso ou um que você salvou.

Qual porta?

2222, no servidor do sandbox, como diz o ssh_command dele.

Uma sessão SSH mantém o sandbox acordado?

Sim, enquanto está aberta. Quando ela fecha, os timers de ociosidade do sandbox voltam a correr: por padrão, ele pausa depois de 5 minutos.

Dá para copiar arquivos?

Sim, com scp ou sftp, ou pela API: write_files para até 17 MiB, um link de download ou de upload para qualquer tamanho.

Um programa pode entrar sem chave?

Sim, com um token de connect_sandbox como senha. Ele dura uma hora, a não ser que você peça até um dia, e revogar os tokens do sandbox faz ele parar de funcionar.

Relacionados

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

Começar o teste grátis