Українська
Меню документації

Документація Agent Sandboxes · Завдання

SSH у пісочницю: оболонка, scp, SFTP і тунелі

Оновлено · 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 [email protected] -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 [email protected] -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 [email protected] -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 [email protected]:data/
sftp -P 2222 [email protected]
ssh -N -L 5173:localhost:5173 [email protected] -p 2222

Тунель дістається до будь-якого порту в пісочниці, зокрема до портів, прив’язаних до localhost, тож відкриває приватний порт у вашому власному браузері на http://localhost:5173 без токена (порти й прев’ю).

Як це працює

У пісочниці не працює жоден 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 відповідає сервер пісочниці, і він запускає вашу оболонку всередині пісочниці.

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

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

Почати пробний період