---
title: "SSH em um sandbox: shell, scp e túneis · Pethost"
description: "ssh, scp, sftp e ssh -L puros em qualquer sandbox do Pethost, com a sua chave ou um token de uma hora como senha. Um login acorda um sandbox pausado."
---

[Agent Sandboxes](https://pethost.dev/pt/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.

Um comando ssh para um sandbox pausado na porta 2222 o acorda e abre um shell; depois um arquivo é copiado com scp e uma porta é encaminhada com ssh -L.

## 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 k3x9q2m7v1c8p4ra@sbx1.sandboxes.pethost.network -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.

Python

CLI

```
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 k3x9q2m7v1c8p4ra@sbx1.sandboxes.pethost.network -p 2222
```

```
pethost sandbox shell k3x9q2m7v1c8p4ra   # entra com um token, sem precisar de chave
scp -P 2222 results.csv k3x9q2m7v1c8p4ra@sbx1.sandboxes.pethost.network:/home/user/
ssh -p 2222 -N -L 5432:localhost:5432 k3x9q2m7v1c8p4ra@sbx1.sandboxes.pethost.network
```

## 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](https://pethost.dev/pt/sandboxes/preview-urls/) 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](https://pethost.dev/pt/docs/sandboxes/ssh/)

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

- [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. Uma URL para cada porta Um dev server na porta 3000 responde no próprio endereço HTTPS, público ou atrás de um token, e uma visita acorda um sandbox pausado em cerca de 0,2 s. Como funciona](https://pethost.dev/pt/sandboxes/preview-urls/)
- [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/)
