---
title: "Шаблоны: песочницы, готовые к работе сразу | Pethost Agent Sandboxes"
description: "Сохраните диск песочницы как шаблон, вместе с вашими пакетами и образами Docker, и запускайте из него новые песочницы на любом сервере примерно за 0,2 с."
---

[Документация Agent Sandboxes](https://pethost.dev/ru/docs/sandboxes/) · Задачи

# Шаблоны: песочницы, готовые к работе сразу

Обновлено 22 ноября 2026 г. · 5 мин чтения

Шаблон — это то, из чего запускается песочница. В нашем, `base`, есть инструменты; ваш — это диск песочницы, сохраненный как есть, с установленными вами пакетами, вашим кодом и его образами Docker. Песочница из него запускается примерно за 0,22 с, и устанавливать уже нечего.

**Коротко**

- **`CreateTemplate`** сохраняет диск и настройки песочницы как новую версию, `my-app@1`, `my-app@2`, а песочница продолжает работать.
- **SAVING, затем READY** — примерно за 1,5 с для маленького и примерно 10 с на GiB его собственных данных.
- **`CreateSandbox`** с `"my-app"` запускается из его новейшей версии в READY, на любом сервере.
- **Только файлы:** шаблон не хранит ни памяти, ни процессов, ни разговоров агентов. Он не оплачивается; его размер ограничивает ваш тариф.

### Step 1: Подготовьте песочницу

Создайте песочницу из `base` и настройте ее так, какой должна быть каждая новая: склонируйте код, установите его зависимости, скачайте образы Docker, которые он запускает, прогрейте кеши ([команды и файлы](https://pethost.dev/ru/docs/sandboxes/commands-and-files/)). Ее настройки тоже важны: шаблон берет жизненный цикл, исходящий трафик, публичные порты и окружение песочницы в их нынешнем виде, и песочницы из него запускаются с ними, если при создании не сказано иначе.

### Step 2: Сохраните ее как шаблон

`CreateTemplate` за миллисекунды отвечает новой версией в SAVING, как только зафиксирует диск в нынешнем виде: песочница продолжает работать. Затем сервер ужимает версию до того, что на ней есть, и загружает ее. Дождитесь READY, прежде чем запускаться из этой версии.

Python

```
import time

from pethost.sandboxes import TemplateState

version = sandboxes.create_template("my-app", sandbox_id=sandbox_id, description="Node 22 and our dependencies")
while version.state == TemplateState.SAVING:
    time.sleep(1)
    version = sandboxes.get_template(f"my-app@{version.version}")
print(version.name, version.version, version.state.name, version.min_size.name, version.size_bytes)
# my-app 1 READY SMALL 25447048
```

TypeScript

```
let version = await sandboxes.createTemplate({
  name: "my-app",
  sandboxId,
  description: "Node 22 and our dependencies",
});
while (version.state === TemplateState.SAVING) {
  await new Promise((resolve) => setTimeout(resolve, 1000));
  version = await sandboxes.getTemplate({ template: `my-app@${version.version}` });
}
console.log(version.name, version.version, version.state, version.minSize, version.sizeBytes);
```

Go

```
version, err := client.CreateTemplate(ctx, &sandboxes.CreateTemplateRequest{
	Name:        "my-app",
	SandboxID:   id,
	Description: "Node 22 and our dependencies",
})
for err == nil && version.State == sandboxes.TemplateStateSaving {
	time.Sleep(time.Second)
	version, err = client.GetTemplate(ctx, &sandboxes.GetTemplateRequest{Template: fmt.Sprintf("my-app@%d", version.Version)})
}
if err != nil {
	log.Fatal(err)
}
fmt.Println(version.Name, version.Version, version.State, version.MinSize, version.SizeBytes)
```

Rust

```
let mut version = sandboxes
    .create_template(CreateTemplateRequest {
        name: "my-app".into(),
        sandbox_id: id.clone(),
        description: "Node 22 and our dependencies".into(),
        ..Default::default()
    })
    .await?;
while matches!(version.state, TemplateState::Saving) {
    tokio::time::sleep(std::time::Duration::from_secs(1)).await;
    let template = format!("my-app@{}", version.version);
    version = sandboxes.get_template(GetTemplateRequest { template, ..Default::default() }).await?;
}
println!("{} {} {:?} {:?} {}", version.name, version.version, version.state, version.min_size, version.size_bytes);
```

CLI

```
$ pethost sandbox template save api-dev my-app --description 'Node 22 and our dependencies'
✓ Saving my-app@2: it is ready once uploaded. See:  pethost sandbox template show my-app@2
my-app@2
$ pethost sandbox template ls my-app
my-app@2   ready   68 MB      55 s ago    Node 22 and our dependencies
my-app@1   ready   24 MB      1 min ago   Node 22 and our dependencies
```

MCP

```
CreateTemplate {"name": "my-app", "sandbox_id": "…", "description": "Node 22 and our dependencies"}
ListTemplates {"name": "my-app"}
```

### Step 3: Запускайте из него песочницы

Назовите шаблон в `CreateSandbox`: `"my-app"` — его новейшая версия в READY, `"my-app@2"` — именно эта. Первая песочница версии на сервере скачивает ее, примерно 10 с на GiB; сервер ее хранит, и следующие запускаются примерно за 0,22 с.

Python

```
preview = sandboxes.create_sandbox("my-app")
print(preview.sandbox_id, preview.template)  # 8j37xshusqwdz8cs my-app@1
```

TypeScript

```
const preview = await sandboxes.createSandbox({ template: "my-app" });
console.log(preview.sandboxId, preview.template);
```

Go

```
preview, err := client.CreateSandbox(ctx, &sandboxes.CreateSandboxRequest{Template: "my-app"})
if err != nil {
	log.Fatal(err)
}
fmt.Println(preview.SandboxID, preview.Template)
```

Rust

```
let preview = sandboxes
    .create_sandbox(CreateSandboxRequest { template: "my-app".into(), ..Default::default() })
    .await?;
println!("{} {}", preview.sandbox_id, preview.template);
```

CLI

```
$ pethost sandbox new --template my-app
✓ Made sandbox ofvm8by6buvd4rkd: default, running, from my-app@2, in <1 s
  port 5173: https://5173-ofvm8by6buvd4rkd.sbx1.sandboxes.pethost.network
ofvm8by6buvd4rkd
Next:   pethost sandbox run ofvm8by6buvd4rkd -- <command>   ·   pethost sandbox shell ofvm8by6buvd4rkd
```

MCP

```
CreateSandbox {"template": "my-app"}
```

`template` в ответе называет точную версию, из которой она запустилась, например `my-app@1`.

## Что хранит шаблон

- **Хранит:** каждый файл диска песочницы, в том числе пакеты, ваш код, образы и контейнеры Docker; и настройки песочницы, с которыми запускаются ее песочницы, если при создании не сказано иначе.
- **Не хранит:** память и процессы, поэтому песочница из шаблона запускается без ничего работающего; историю команд и разговоры агентов для кода, без которых запускаются его песочницы.
- **Свежее в каждой песочнице:** собственные ID, имя хоста, machine-id и случайность ядра.

Чтобы скопировать песочницу вместе с памятью и процессами, такой, какая она в эту секунду, сделайте форк: [форки](https://pethost.dev/ru/docs/sandboxes/forks/). Шаблон — для многих песочниц на протяжении дней; форк — для нескольких копий прямо сейчас.

## Версии и размеры

Каждое сохранение под одним именем — его следующая версия. `"my-app"` всегда означает новейшую версию в READY, а пока сохраняется новая — предыдущую, так что сохранение никогда не ломает ваши создания. Имя хранит 10 версий; версия в FAILED ничего не занимает и исчезает через сутки. Рабочее пространство сохраняет по одной версии за раз, а песочница сохраняет версию, из которой запустилась, даже после удаления шаблона.

У версии в READY есть `min_size`: наименьший размер, чей диск вмещает то, что она сохранила. Ее песочницы берут любой размер начиная с него. Создание с размером меньше получает отказ, где назван подходящий.

## Где он хранится и сколько стоит

Версия ужимается до того, что на ней есть, сжимается, шифруется своим ключом и хранится в объектном хранилище в ЕС, откуда любой сервер может запускать из нее песочницы. Считаются только ее собственные байты, а не базовый образ под ней. Шаблоны не оплачиваются: ваш тариф ограничивает, сколько занимают все версии рабочего пространства вместе, — 5 GiB на тарифе за 20 $ и 30 GiB на тарифе за 100 $ (`Limits.template_gib`; `Workspace.template_bytes` — сколько они занимают сейчас). `DeleteTemplate` удаляет все версии имени и сразу освобождает место; песочницы, созданные из него, продолжают работать, вставать на паузу и возобновляться.

## Наш шаблон: base

`base` — это Ubuntu 24.04 с инструментами сборки и git, Python 3, Node.js 22, Docker с Compose, Claude Code, Codex и OpenCode и рабочий стол с Google Chrome. Мы пересобираем его каждый месяц и сразу же ради исправления уязвимости Chrome, ядра или пакета. `Template.base` называет версию, на которой запускаются песочницы шаблона, по хешу ее содержимого: сохраненная вами версия хранит базовый образ, на котором запустилась ее песочница, так что ваш шаблон не меняется у вас под ногами.

Сборки из Dockerfile нет: выполните шаги своего Dockerfile в песочнице или `docker build` внутри нее и сохраните эту песочницу.

## Если не работает

- **`RESOURCE_EXHAUSTED` с `LimitReached`, `template_gib`:** версии рабочего пространства заняли место тарифа, или сохраняется другая версия. Удалите старый шаблон или дождитесь сохранения.
- **`LimitReached`, `template_versions`:** у имени уже 10 версий. Сохраните под новым именем или удалите шаблон и сохраните снова.
- **Версия в FAILED:** `failure_message` говорит почему, например собственные байты версии превысили оставшееся место. Освободите место и сохраните снова.
- **`INVALID_ARGUMENT` с названным размером:** размер меньше `min_size` версии. Попросите этот размер или больше.
- **Первая песочница из новой версии запускается медленно:** ее сервер скачивал версию, примерно 10 с на GiB. Следующие там запускаются примерно за 0,22 с.

## Вопросы

### Как сделать свой шаблон песочницы?

Настройте песочницу так, какими должны быть новые, затем вызовите `CreateTemplate` с именем и ее ID. Запускайте новые песочницы с этим именем.

### Сохраняет ли шаблон работающие процессы?

Нет: только файлы и настройки. Чтобы скопировать работающую песочницу с ее памятью и процессами, сделайте форк.

### Оплачиваются ли шаблоны?

Нет. Ваш тариф ограничивает, сколько GiB занимают шаблоны рабочего пространства в объектном хранилище.

### Можно ли собрать шаблон из Dockerfile?

Не напрямую: выполните шаги Dockerfile или `docker build` в песочнице, затем сохраните песочницу как шаблон.

### Сохраняются ли образы Docker в шаблоне?

Да. Образы и контейнеры Docker лежат на диске песочницы, который хранит шаблон.

[ПредыдущаяComputer use: Chrome на рабочем столе в песочнице](https://pethost.dev/ru/docs/sandboxes/computer-use/) [СледующаяСекреты и исходящий трафик: ключи, которых нет в песочнице](https://pethost.dev/ru/docs/sandboxes/secrets-and-egress/)

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

Пробный период на 7 дней: 1 $ использования и 4 vCPU, нужна карта. Затем тариф от 20 $ в месяц, в который входит столько же использования.

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

Pethost · Stephan Gomer · NIP 1133096755

Pethost

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

Agent Sandboxes

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

Сравнения

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

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

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