Документация 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 $ в месяц, в который входит столько же использования.