---
title: "SSH в песочницу: шелл, scp и туннели · Pethost"
description: "Обычные ssh, scp, sftp и ssh -L в любую песочницу Pethost — с вашим ключом или с токеном на час вместо пароля. Вход по SSH будит песочницу на паузе."
---

[Agent Sandboxes](https://pethost.dev/ru/sandboxes/) Обычный SSH, scp и туннели

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

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

Команда ssh к песочнице на паузе на порт 2222 будит ее и открывает шелл; потом файл копируется через scp, а порт пробрасывается через ssh -L.

## Как зайти в песочницу по SSH

Каждая песочница отвечает по SSH на порту 2222 своего сервера, а имя пользователя — ее id. Готовая команда целиком лежит в ее записи, `ssh_command`, например `ssh k3x9q2m7v1c8p4ra@sbx1.sandboxes.pethost.network -p 2222`.

Войти можно двумя способами. Публичным ключом рабочего пространства: добавьте свой один раз через `set_ssh_keys` или в настройках панели, и он открывает все песочницы рабочего пространства. Или токеном подключения вместо пароля — для программы, у которой нет ключа: `connect_sandbox` создает его для одной песочницы, по умолчанию на час, максимум на сутки. `pethost sandbox shell` сам создает такой токен и входит с ним.

Python

CLI

```
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 k3x9q2m7v1c8p4ra@sbx1.sandboxes.pethost.network -p 2222
```

```
pethost sandbox shell k3x9q2m7v1c8p4ra   # входит по токену, ключ не нужен
scp -P 2222 results.csv k3x9q2m7v1c8p4ra@sbx1.sandboxes.pethost.network:/home/user/
ssh -p 2222 -N -L 5432:localhost:5432 k3x9q2m7v1c8p4ra@sbx1.sandboxes.pethost.network
```

## Как это устроено

В песочнице не работает 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`, не делая его порт публичным. Так же браузер открывает приватный порт: вкладка браузера не может отправить токен, которого требует [приватный порт](https://pethost.dev/ru/sandboxes/preview-urls/). Пробрасываются только собственные порты песочницы, названные как `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 минут «обычно возвращает ту же машину, с памятью и работающими программами. Не рассчитывайте на это».

[Читать документацию](https://pethost.dev/ru/docs/sandboxes/ssh/)

## Вопросы

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

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

**Какой порт?**

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

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

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

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

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

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

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

## По теме

- [Заход на HTTPS-адрес порта 3000 будит песочницу на паузе за 0,2 с, и появляется ее страница; приватный порт отвечает 200 на запрос с токеном и 401 на запрос без него. URL для каждого порта Dev-сервер на порту 3000 отвечает по собственному HTTPS-адресу, публичному или за токеном, а заход будит песочницу на паузе примерно за 0,2 с. Как это устроено](https://pethost.dev/ru/sandboxes/preview-urls/)
- [Программа вызывает run_command, и вывод тестов приходит потоком; она правит файл на месте; она запускает dev-сервер, и вызов отвечает, как только порт 5173 начинает слушать. Команды, файлы и терминал Запустить команду и дождаться ее порта, получить вывод потоком, править файлы точной заменой, открыть терминал в браузере — каждое действие одним вызовом API. Как это устроено](https://pethost.dev/ru/sandboxes/code-execution/)

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

[Начать пробный период](https://console.pethost.dev/welcome?kind=sandboxes)

Pethost · Stephan Gomer · NIP 1133096755

Pethost

- [Шаблоны](https://pethost.dev/ru/templates/)
- [О нас](https://pethost.dev/about/)
- [Документация](https://pethost.dev/docs/)
- [Блог](https://pethost.dev/ru/blog/)
- [API](https://pethost.dev/docs/api/)
- [CLI](https://pethost.dev/docs/cli/)
- [Плагин](https://github.com/pethost-dev/plugin)
- [Условия](https://pethost.dev/terms/)
- [Конфиденциальность](https://pethost.dev/privacy/)
- [Возвраты](https://pethost.dev/refunds/)
- [support@pethost.dev](mailto:support@pethost.dev)

Базы данных

- [Postgres](https://pethost.dev/ru/postgres/)
- [Valkey](https://pethost.dev/ru/valkey/)

Agent Sandboxes

- [Песочницы](https://pethost.dev/ru/sandboxes/)
- [Цены](https://pethost.dev/ru/sandboxes/#pricing)
- [Документация](https://pethost.dev/ru/docs/sandboxes/)
- [API](https://pethost.dev/docs/sandboxes/api/)

Сравнения

- [Coolify vs Dokploy vs CapRover vs Dokku](https://pethost.dev/ru/blog/coolify-vs-dokploy-vs-caprover-vs-dokku/)
- [Coolify Cloud vs Dokploy Cloud](https://pethost.dev/ru/blog/coolify-cloud-vs-dokploy-cloud/)
- [Цены Railway, Render и Fly.io](https://pethost.dev/ru/blog/railway-vs-render-vs-fly-io-pricing/)
- [Управляемый хостинг Docker Compose](https://pethost.dev/ru/blog/managed-docker-compose-hosting/)

Альтернативы

- [Альтернативы Railway](https://pethost.dev/ru/blog/railway-alternatives/)
- [Альтернативы Heroku](https://pethost.dev/ru/blog/heroku-alternatives/)
- [Альтернативы Dokploy](https://pethost.dev/ru/blog/dokploy-alternatives/)
- [Альтернативы Coolify](https://pethost.dev/ru/blog/coolify-alternatives/)
- [Альтернативы Render](https://pethost.dev/ru/blog/render-alternatives/)
- [Альтернативы Sliplane](https://pethost.dev/ru/blog/sliplane-alternatives/)
