Русский
Начать

Agent Sandboxes Обычный SSH, scp и туннели

SSH в любую песочницу

Инструменты, которыми вы уже пользуетесь, нацеленные на песочницу: ssh для шелла, scp и sftp для файлов, ssh -L для порта. SSH-сервер ставить не нужно, а вход будит песочницу на паузе там, где она остановилась.

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

Читать документацию

Вопросы

Нужен ли sshd в шаблоне, чтобы заходить в песочницу по SSH?

Нет. По SSH отвечает сервер, и он запускает вашу сессию внутри песочницы, поэтому SSH есть в каждом шаблоне — нашем или сохраненном вами.

Какой порт?

2222 на сервере песочницы, как указано в ее ssh_command.

Не дает ли SSH-сессия песочнице уснуть?

Да, пока она открыта. Когда она закрывается, таймеры простоя песочницы снова идут: по умолчанию она встает на паузу через 5 минут.

Можно ли копировать файлы?

Да, через scp или sftp или через API: write_files — до 17 MiB, ссылка на скачивание или загрузку — любого размера.

Может ли программа войти без ключа?

Да, с токеном из connect_sandbox вместо пароля. Он действует час, если не попросить до суток, и перестает работать, если отозвать токены песочницы.

По теме

Дайте агенту компьютер за 0,15 с

Начать пробный период