Документація Agent Sandboxes · Завдання
SSH у пісочницю: оболонка, scp, SFTP і тунелі
Кожна пісочниця приймає звичайні 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-ключів.
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']
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));
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))
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. Вона змінюється, лише коли зупинена пісочниця запускається на іншому сервері, тож читайте її із запису, а не зберігайте.
print(sandboxes.get_sandbox(sandbox_id).ssh_command)
# ssh [email protected] -p 2222
console.log((await sandboxes.getSandbox({ sandboxId })).sshCommand);
record, err := client.GetSandbox(ctx, &sandboxes.GetSandboxRequest{SandboxID: id})
if err != nil {
log.Fatal(err)
}
fmt.Println(record.SSHCommand)
let record = sandboxes
.get_sandbox(GetSandboxRequest { sandbox_id: id.clone(), ..Default::default() })
.await?;
println!("{}", record.ssh_command);
$ 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
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 $ на місяць, який включає стільки ж використання.