Як підключитися до пісочниці по SSH
Кожна пісочниця відповідає по SSH на порту 2222 свого сервера, з id пісочниці як ім’ям користувача. Її запис містить усю команду, ssh_command, наприклад ssh [email protected] -p 2222.
Увійти можна двома способами. Публічний ключ робочого простору: додайте свій один раз через set_ssh_keys або в налаштуваннях вебпанелі, і він відкриває кожну пісочницю робочого простору. Або токен підключення замість пароля, для програми, що не тримає ключа: connect_sandbox створює його для однієї пісочниці, дійсний типово годину, щонайбільше добу. pethost sandbox shell створює його за вас і входить із ним.
from pathlib import Path
from pethost.sandboxes import Sandboxes
sandboxes = Sandboxes() # читає PETHOST_TOKEN
key = Path("~/.ssh/id_ed25519.pub").expanduser().read_text()
sandboxes.set_ssh_keys(ssh_keys=[key]) # замінює ключі робочого простору
box = sandboxes.create_sandbox()
print(box.ssh_command)
# ssh [email protected] -p 2222pethost sandbox shell k3x9q2m7v1c8p4ra # входить із токеном, ключ не потрібен
scp -P 2222 results.csv [email protected]:/home/user/
ssh -p 2222 -N -L 5432:localhost:5432 [email protected]Як це працює
У пісочниці не працює sshd. SSH-шлюз сервера говорить із вами по SSH і спілкується з власним демоном пісочниці через vsock ВМ: ваша оболонка, команда чи SFTP працює як процес усередині пісочниці, а прокинутий порт — це тунель у неї. Тож SSH є в кожному шаблоні, у вашому теж, і ніщо всередині пісочниці не слухає для нього порт. Те, що ви запускаєте через SSH, — така сама команда, як будь-яка інша: вона видна в list_commands і в подіях пісочниці з позначкою, що її запущено через SSH.
Шлюз перевіряє ваш ключ або токен, перш ніж щось прокинеться. Потім вхід спершу будить пісочницю в стані PAUSED, з пам’яттю й процесами як були, а відкрита сесія не дає їй заснути: з типовим життєвим циклом вона знову стає на паузу через 5 хв після завершення останньої сесії. Пісочниця в стані STOPPED відхиляє вхід із повідомленням «stopped: resume it», якщо її життєвий цикл не будить її зупиненою. Вилучення ключа з робочого простору завершує сесії цього ключа.
Файли й тунелі
scp і sftp працюють так само, як із будь-яким сервером. Для файлу, більшого, ніж уміщує виклик API, це найпростіший шлях туди й назад; для того самого API має посилання для звантаження й завантаження.
ssh -L прокидає порт вашого комп’ютера на порт усередині пісочниці: -L 5432:localhost:5432 дістається до Postgres, який пісочниця тримає для себе, а -L 5173:localhost:5173 відкриває сервер розробки у вашому браузері на localhost:5173, не роблячи його порт публічним. Так само браузер відкриває приватний порт, адже вкладка браузера не може надіслати токен, якого вимагає приватний порт. Прокидаються лише власні порти пісочниці, названі як localhost; ssh -R відхиляється.
Ліміти й ціни
Порт 2222 на сервері пісочниці; лише локальне прокидання. SSH-канал рахується серед 64 викликів, потоків і посилань, які пісочниця обслуговує одночасно, а сесія приймає до 64 змінних середовища загальним обсягом 32 KiB. Токен підключення — це облікові дані root: передавайте його програмі, але ніколи не вставляйте у вебсторінку. SSH не має окремої ціни. Пісочниця оплачується посекундно за ціною свого розміру, 0,018 $ на годину для SMALL (2 vCPU, 4 GiB), і працює, поки відкрита сесія.
Порівняння з іншими
21 листопада 2026 року E2B давав доступ до оболонки пісочниці через WebSocket-проксі. У boat.dev є SSH, але немає паузи: після зупинки, як каже його документація, продовження протягом 10 хвилин «зазвичай повертає ту саму машину, з пам’яттю й запущеними програмами. Не розраховуйте на це».