Русский
Меню документации

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

Начать пробный период