Polski
Zacznij

Agent Sandboxes Zwykłe SSH, scp i tunele

SSH do każdego sandboxa

Narzędzia, których już używasz, skierowane na sandbox: ssh do powłoki, scp i sftp do plików, ssh -L do portu. Nie ma serwera SSH do instalowania, a logowanie budzi wstrzymany sandbox tam, gdzie był.

Jak połączyć się z sandboxem przez SSH

Każdy sandbox odpowiada na SSH na porcie 2222 swojego serwera, z id sandboxa jako nazwą użytkownika. Jego rekord zawiera całe polecenie, ssh_command, na przykład ssh [email protected] -p 2222.

Zalogować się można na dwa sposoby. Kluczem publicznym przestrzeni roboczej: dodaj swój raz przez set_ssh_keys albo w ustawieniach konsoli webowej, a otworzy każdy sandbox tej przestrzeni roboczej. Albo tokenem połączenia jako hasłem, dla programu, który nie ma klucza: connect_sandbox tworzy go dla jednego sandboxa, ważny domyślnie godzinę, a najwyżej dzień. pethost sandbox shell tworzy go za ciebie i nim się loguje.

from pathlib import Path
from pethost.sandboxes import Sandboxes

sandboxes = Sandboxes()  # czyta PETHOST_TOKEN
key = Path("~/.ssh/id_ed25519.pub").expanduser().read_text()
sandboxes.set_ssh_keys(ssh_keys=[key])  # zastępuje klucze przestrzeni roboczej
box = sandboxes.create_sandbox()
print(box.ssh_command)
# ssh [email protected] -p 2222
pethost sandbox shell k3x9q2m7v1c8p4ra   # loguje się tokenem, klucz niepotrzebny
scp -P 2222 results.csv [email protected]:/home/user/
ssh -p 2222 -N -L 5432:localhost:5432 [email protected]

Jak to działa

W sandboxie nie działa żaden sshd. Brama SSH serwera rozmawia z tobą po SSH, a z demonem sandboxa przez vsock maszyny wirtualnej: twoja powłoka, twoje polecenie albo SFTP działa jako proces w sandboxie, a przekierowany port to tunel do jego środka. Dlatego każdy szablon ma SSH, także twój, a w sandboxie nic na nie nie nasłuchuje. To, co uruchamiasz przez SSH, jest poleceniem jak każde inne: widać je w list_commands i w zdarzeniach sandboxa, oznaczone jako uruchomione przez SSH.

Brama sprawdza twój klucz albo token, zanim cokolwiek się obudzi. Potem logowanie najpierw budzi sandbox w stanie PAUSED, z pamięcią i procesami takimi, jak były, a otwarta sesja nie pozwala mu zasnąć: przy domyślnym cyklu życia wstrzymuje się znowu 5 minut po zakończeniu ostatniej sesji. Sandbox w stanie STOPPED odrzuca logowanie z komunikatem „stopped: resume it”, chyba że jego cykl życia budzi go po zatrzymaniu. Usunięcie klucza z przestrzeni roboczej kończy sesje tego klucza.

Pliki i tunele

scp i sftp działają tak jak z każdym serwerem. Dla pliku większego, niż mieści wywołanie API, to najprostsza droga do środka i na zewnątrz; API ma do tego samego linki pobierania i wgrywania.

ssh -L przekierowuje port twojego komputera na port w sandboxie: -L 5432:localhost:5432 sięga do Postgresa, którego sandbox trzyma tylko dla siebie, a -L 5173:localhost:5173 otwiera serwer deweloperski w twojej przeglądarce pod localhost:5173 bez upubliczniania jego portu. Tak też przeglądarka otwiera port prywatny, bo karta przeglądarki nie wyśle tokena, którego wymaga port prywatny. Przekierowywane są tylko porty samego sandboxa, wskazane jako localhost; ssh -R jest odrzucane.

Limity i ceny

Port 2222 na serwerze sandboxa; tylko przekierowanie lokalne. Kanał SSH liczy się do 64 wywołań, strumieni i linków, które sandbox obsługuje naraz, a sesja przyjmuje do 64 zmiennych środowiskowych o łącznym rozmiarze 32 KiB. Token połączenia daje uprawnienia roota: daj go programowi, nigdy nie umieszczaj go na stronie internetowej. SSH nie ma własnej ceny. Sandbox jest rozliczany co do sekundy po cenie swojego rozmiaru, 0,018 $ za godzinę dla SMALL (2 vCPU, 4 GiB), i działa, dopóki sesja jest otwarta.

Jak to wypada na tle innych

21 listopada 2026 E2B dawało dostęp do powłoki sandboxa przez proxy WebSocket. boat.dev ma SSH, ale nie ma wstrzymania: po zatrzymaniu jego dokumentacja mówi, że wznowienie w ciągu 10 minut „zwykle daje z powrotem tę samą maszynę, z pamięcią i działającymi programami. Nie licz na to”.

Przeczytaj dokumentację

Pytania

Czy potrzebuję sshd w szablonie, żeby łączyć się z sandboxem przez SSH?

Nie. Na SSH odpowiada serwer i uruchamia twoją sesję w sandboxie, więc ma je każdy szablon, nasz albo zapisany przez ciebie.

Który port?

2222, na serwerze sandboxa, tak jak mówi jego ssh_command.

Czy sesja SSH nie pozwala sandboxowi zasnąć?

Tak, dopóki jest otwarta. Gdy się zamknie, liczniki bezczynności sandboxa ruszają znowu: domyślnie wstrzymuje się po 5 minutach.

Czy mogę kopiować pliki?

Tak, przez scp albo sftp, albo przez API: write_files do 17 MiB, link pobierania albo wgrywania dla dowolnej wielkości.

Czy program może się zalogować bez klucza?

Tak, tokenem z connect_sandbox jako hasłem. Działa godzinę, chyba że poprosisz o maksymalnie dzień, a unieważnienie tokenów sandboxa sprawia, że przestaje działać.

Powiązane

Daj swojemu agentowi komputer w 0,15 s

Zacznij darmowy okres próbny