---
title: "SSH в песочницу: шелл, scp, SFTP и туннели | Pethost Agent Sandboxes"
description: "Входите в любую песочницу обычным ssh, копируйте файлы через scp и SFTP и пробрасывайте ее порты через ssh -L — с ключом рабочего пространства или токеном."
---

[Документация Agent Sandboxes](https://pethost.dev/ru/docs/sandboxes/) · Задачи

# SSH в песочницу: шелл, scp, SFTP и туннели

Обновлено 22 ноября 2026 г. · 4 мин чтения

Каждая песочница принимает обычные `ssh`, `scp`, `sftp` и `ssh -L`: `ssh <sandbox id>@<server> -p 2222`, с SSH-ключом рабочего пространства или токеном в качестве пароля. Вход будит песочницу на паузе, и ничего устанавливать в нее не нужно.

**Коротко**

- **`Sandbox.ssh_command`** — это готовая команда: ID песочницы как имя пользователя, ее сервер, порт 2222.
- **Ключи:** `SetSshKeys` дает рабочему пространству публичные ключи, с которыми можно войти в каждую его песочницу; удаление ключа завершает его сессии.
- **Или токен:** токен из `ConnectSandbox` — это пароль, для программы или песочницы, в которую вы заходите один раз.
- **Шелл, SFTP и туннели `-L`** — только в песочницу, никогда на ее сервер.

### Step 1: Дайте рабочему пространству свой публичный ключ

`SetSshKeys` заменяет ключи рабочего пространства переданным списком, поэтому отправляйте уже имеющиеся вместе со своим. То же самое делают настройки рабочего пространства в панели, в разделе SSH-ключей.

Python

```
from pathlib import Path

mine = (Path.home() / ".ssh" / "id_ed25519.pub").read_text().strip()
kept = [key.public_key for key in sandboxes.get_workspace().ssh_keys]
workspace = sandboxes.set_ssh_keys(ssh_keys=[*kept, mine])
print([key.fingerprint for key in workspace.ssh_keys])
# ['SHA256:EqzSrW++0DTmPtQLG+r1oKBoKzfKQRilcUFxx/p/Eyw']
```

TypeScript

```
import { readFile } from "node:fs/promises";
import { homedir } from "node:os";

const mine = (await readFile(`${homedir()}/.ssh/id_ed25519.pub`, "utf8")).trim();
const kept = (await sandboxes.getWorkspace()).sshKeys.map((key) => key.publicKey);
const workspace = await sandboxes.setSshKeys({ sshKeys: [...kept, mine] });
console.log(workspace.sshKeys.map((key) => key.fingerprint));
```

Go

```
home, _ := os.UserHomeDir()
mine, err := os.ReadFile(home + "/.ssh/id_ed25519.pub")
if err != nil {
	log.Fatal(err)
}
current, err := client.GetWorkspace(ctx, &sandboxes.GetWorkspaceRequest{})
if err != nil {
	log.Fatal(err)
}
keys := []string{strings.TrimSpace(string(mine))}
for _, key := range current.SSHKeys {
	keys = append(keys, key.PublicKey)
}
workspace, err := client.SetSSHKeys(ctx, &sandboxes.SetSSHKeysRequest{SSHKeys: keys})
if err != nil {
	log.Fatal(err)
}
fmt.Println(len(workspace.SSHKeys))
```

Rust

```
let mine = std::fs::read_to_string(format!("{}/.ssh/id_ed25519.pub", std::env::var("HOME")?))?;
let current = sandboxes.get_workspace(GetWorkspaceRequest::default()).await?;
let mut keys: Vec<String> = current.ssh_keys.into_iter().map(|key| key.public_key).collect();
keys.push(mine.trim().to_string());
let workspace = sandboxes
    .set_ssh_keys(SetSshKeysRequest { ssh_keys: keys, ..Default::default() })
    .await?;
println!("{}", workspace.ssh_keys.len());
```

### Step 2: Возьмите SSH-команду песочницы

В записи песочницы есть ее `ssh_command`. Она меняется, только когда остановленная песочница запускается на другом сервере, поэтому читайте ее из записи, а не храните у себя.

Python

```
print(sandboxes.get_sandbox(sandbox_id).ssh_command)
# ssh e9bprbw1hovj6sw5@sbx1.sandboxes.pethost.network -p 2222
```

TypeScript

```
console.log((await sandboxes.getSandbox({ sandboxId })).sshCommand);
```

Go

```
record, err := client.GetSandbox(ctx, &sandboxes.GetSandboxRequest{SandboxID: id})
if err != nil {
	log.Fatal(err)
}
fmt.Println(record.SSHCommand)
```

Rust

```
let record = sandboxes
    .get_sandbox(GetSandboxRequest { sandbox_id: id.clone(), ..Default::default() })
    .await?;
println!("{}", record.ssh_command);
```

CLI

```
$ pethost sandbox show api-dev
id          e9bprbw1hovj6sw5
name        api-dev
state       running since 01:19
next        paused today at 01:29, unless something happens in it
size        default, disk 20 GiB
template    base@17
port 5173   https://5173-e9bprbw1hovj6sw5.sbx1.sandboxes.pethost.network
ssh         ssh e9bprbw1hovj6sw5@sbx1.sandboxes.pethost.network -p 2222
panel       https://console.pethost.dev/w/af6hvmyk/sandboxes/e9bprbw1hovj6sw5
used        running 6 min 17 s
created     today at 01:19
```

MCP

```
GetSandbox {"sandbox_id": "…"}
```

### Step 3: Войдите

```
$ ssh e9bprbw1hovj6sw5@sbx1.sandboxes.pethost.network -p 2222
user@e9bprbw1hovj6sw5:~$
```

Шелл работает от имени `user` в `/home/user`, с sudo. Песочница на паузе просыпается при входе и не засыпает, пока сессия открыта.

## Без ключа: токен как пароль

`ConnectSandbox` отвечает токеном для одной песочницы, который действует час, если `ttl_seconds` не говорит иначе, — до 86 400 с, — и той же `ssh_command`: токен — это ее пароль. Это подходит программе или человеку, который заходит в песочницу один раз. Токен — это root в той песочнице: не допускайте его в логи и сообщения. `UpdateSandbox` с `revoke_tokens` отключает все токены и ссылки, созданные для песочницы.

`pethost sandbox shell <id>` делает все это за вас: просит токен и открывает шелл в вашем терминале, ничего не нужно настраивать, а команду после `--` тоже выполняет в терминале.

```
$ pethost sandbox shell api-dev -- uptime
 00:25:49 up 6 min,  0 user,  load average: 0.04, 0.04, 0.00
```

## Файлы и туннели

Тот же адрес и порт обслуживают `scp` и `sftp` и пробрасывают порты через `-L`:

```
scp -P 2222 ./data.csv k7f3q2xy0a1b2c3d@sbx1.sandboxes.pethost.network:data/
sftp -P 2222 k7f3q2xy0a1b2c3d@sbx1.sandboxes.pethost.network
ssh -N -L 5173:localhost:5173 k7f3q2xy0a1b2c3d@sbx1.sandboxes.pethost.network -p 2222
```

Туннель достает до любого порта в песочнице, включая порты, привязанные к `localhost`, поэтому открывает приватный порт в вашем браузере по адресу `http://localhost:5173` без токена ([порты и превью](https://pethost.dev/ru/docs/sandboxes/ports-and-previews/)).

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

В песочнице не работает никакой SSH-сервер. На порту 2222 отвечает сервер, на котором она работает: он проверяет ключ или токен, прежде чем что-либо проснется, затем запускает ваш шелл как процесс на терминале песочницы, SFTP — как программу в ней, а туннель — прямо к порту. Он достает только до этой песочницы и ни до чего на самом сервере. Команда, запущенная по SSH, видна в `ListCommands`, пока идет, а ее завершение — событие с пометкой о запуске по SSH.

- **Вход будит песочницу на паузе** примерно за 0,1 с. Остановленная так просыпается, только если задан `wake_when_stopped`; иначе вход получает отказ «stopped: resume it», и запускает ее `ResumeSandbox`.
- **Открытая сессия не дает песочнице уснуть** и считается работой (RUNNING). Закройте ее, и пойдут таймеры простоя.
- **Удаление ключа завершает его сессии** во всех песочницах рабочего пространства.
- **Сессия принимает не больше 64 переменных** от вашего клиента.

## Если не работает

- **«Permission denied (publickey,password)»:** ключа нет среди ключей рабочего пространства, или токен истек. Добавьте ключ через `SetSshKeys` или попросите у `ConnectSandbox` свежий токен.
- **«stopped: resume it»:** песочница остановлена. `ResumeSandbox` запускает ее, и файлы — такими, какими она их оставила.
- **Подключение не устанавливается по тайм-ауту:** файрвол на вашей стороне блокирует порт 2222. Попробуйте из другой сети или используйте `pethost sandbox shell`, которому нужен тот же порт.
- **Адрес больше не отвечает за песочницу:** остановленная песочница запустилась на другом сервере, с новой `ssh_command`. Прочитайте ее из записи снова.
- **Сессия завершилась сама:** ее ключ удалили, или токены песочницы отозвали.

## Вопросы

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

Добавьте свой публичный ключ в рабочее пространство, затем выполните `ssh_command` песочницы: `ssh <sandbox id>@<server> -p 2222`.

### Можно ли пользоваться scp и SFTP?

Да, по тому же адресу с `-P 2222`, а `ssh -L` пробрасывает ее порты.

### Будит ли SSH песочницу на паузе?

Да, при входе, примерно за 0,1 с, а открытая сессия не дает ей уснуть.

### Можно ли зайти по SSH на сервер, где работает песочница?

Нет. Вход достает только до своей песочницы.

### Нужно ли устанавливать в песочницу SSH-сервер?

Нет. На SSH отвечает сервер песочницы, и он запускает ваш шелл внутри песочницы.

[ПредыдущаяТома: диск, который переживает песочницы](https://pethost.dev/ru/docs/sandboxes/volumes/) [СледующаяНаблюдаемость: метрики, события и использование песочницы](https://pethost.dev/ru/docs/sandboxes/observability/)

## Попробуйте Pethost Agent Sandboxes

Пробный период на 7 дней: 1 $ использования и 4 vCPU, нужна карта. Затем тариф от 20 $ в месяц, в который входит столько же использования.

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

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/)
