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