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

[Документація Agent Sandboxes](https://pethost.dev/uk/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/uk/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/uk/docs/sandboxes/volumes/) [ДаліСпостережуваність: метрики, події й використання пісочниці](https://pethost.dev/uk/docs/sandboxes/observability/)

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

Пробний період на 7 днів із використанням на 1 $ і 4 vCPU, потрібна картка. Далі — тариф від 20 $ на місяць, який включає стільки ж використання.

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

Pethost · Stephan Gomer · NIP 1133096755

Pethost

- [Шаблони](https://pethost.dev/uk/templates/)
- [Про нас](https://pethost.dev/about/)
- [Документація](https://pethost.dev/docs/)
- [Блог](https://pethost.dev/uk/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/uk/postgres/)
- [Valkey](https://pethost.dev/uk/valkey/)

Agent Sandboxes

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

Порівняння

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

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

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