Как зайти в песочницу по 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 открывает dev-сервер в вашем браузере по адресу 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 минут «обычно возвращает ту же машину, с памятью и работающими программами. Не рассчитывайте на это».