---
title: "Тома: диск, который переживает песочницы | Pethost Agent Sandboxes"
description: "Создайте том, подключите его к песочницам по пути, на запись в одной или на чтение во многих, и узнайте, где он хранится и сколько стоит."
---

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

# Тома: диск, который переживает песочницы

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

Том — это диск вне всех песочниц, который подключается к песочнице по пути: датасет, который читают многие песочницы, кеш, который переживает каждую задачу, файлы, которые должны остаться после удаления песочницы. Он лежит на диске одного сервера, и это нужно знать, прежде чем что-то на него класть.

**Коротко**

- **`CreateVolume`** создает том от 1 до 1 000 GiB; `CreateSandbox` подключает до 4 томов при создании, каждый по своему пути.
- **На запись — одна песочница за раз,** на чтение — сколько угодно.
- **На одном сервере,** без копий: песочница, которая его подключает, работает там же, и если сервер потерян, потерян и том.
- **Оплачивается весь размер,** 0,20 $ за GiB в месяц, занят он или нет.

### Step 1: Создайте том

Том создается пустым, на сервере, где есть место, и его корень принадлежит `user`.

Python

```
volume = sandboxes.create_volume("data", size_gib=10)
print(volume.volume_id, volume.size_gib)  # ziwv1r8ean3dd9sk 10
```

TypeScript

```
const volume = await sandboxes.createVolume({ name: "data", sizeGib: 10 });
console.log(volume.volumeId, volume.sizeGib);
```

Go

```
volume, err := client.CreateVolume(ctx, &sandboxes.CreateVolumeRequest{Name: "data", SizeGib: 10})
if err != nil {
	log.Fatal(err)
}
fmt.Println(volume.VolumeID, volume.SizeGib)
```

Rust

```
let volume = sandboxes
    .create_volume(CreateVolumeRequest { name: "data".into(), size_gib: 10, ..Default::default() })
    .await?;
println!("{} {}", volume.volume_id, volume.size_gib);
```

CLI

```
$ pethost sandbox volume new data --size 10
✓ Made the volume data, 10 GiB. Mount it:  pethost sandbox new --mount o2rvhgm1dxaefoj7:/data
o2rvhgm1dxaefoj7
```

### Step 2: Подключите его к песочнице

Подключения задаются при создании, каждое — том и абсолютный путь. Песочница работает на сервере тома.

Python

```
from pethost.sandboxes import Mount

writer = sandboxes.create_sandbox("base", mounts=[Mount(volume_id=volume.volume_id, path="/data")])
sandboxes.run_command(writer.sandbox_id, command="date > /data/first-run.txt")
```

TypeScript

```
const writer = await sandboxes.createSandbox({
  template: "base",
  mounts: [{ volumeId: volume.volumeId, path: "/data" }],
});
await sandboxes.runCommand({ sandboxId: writer.sandboxId, command: "date > /data/first-run.txt" });
```

Go

```
writer, err := client.CreateSandbox(ctx, &sandboxes.CreateSandboxRequest{
	Template: "base",
	Mounts:   []sandboxes.Mount{{VolumeID: volume.VolumeID, Path: "/data"}},
})
if err != nil {
	log.Fatal(err)
}
_, err = client.RunCommand(ctx, &sandboxes.RunCommandRequest{SandboxID: writer.SandboxID, Command: "date > /data/first-run.txt"})
```

Rust

```
let mount = Mount { volume_id: volume.volume_id.clone(), path: "/data".into(), ..Default::default() };
let writer = sandboxes
    .create_sandbox(CreateSandboxRequest { template: "base".into(), mounts: vec![mount], ..Default::default() })
    .await?;
sandboxes
    .run_command(RunCommandRequest {
        sandbox_id: writer.sandbox_id.clone(),
        command: "date > /data/first-run.txt".into(),
        ..Default::default()
    })
    .await?;
```

CLI

```
$ pethost sandbox new --name writer --mount o2rvhgm1dxaefoj7:/data
✓ Made sandbox writer (upc3ehxd65rjgz32): default, running, from base@17, in <1 s
upc3ehxd65rjgz32
Next:   pethost sandbox run upc3ehxd65rjgz32 -- <command>   ·   pethost sandbox shell upc3ehxd65rjgz32
$ pethost sandbox run writer -- 'date > /data/first-run.txt'
```

MCP

```
CreateSandbox {"name": "writer", "mounts": [{"volume_id": "…", "path": "/data"}]}
```

### Step 3: Откройте его на чтение другим и удалите, когда закончите

Когда ни одна песочница не подключает его на запись, на чтение его может подключить сколько угодно песочниц. Том остается, когда удаляются подключавшие его песочницы, и уходит только через `DeleteVolume`, который получает отказ, пока том подключен к какой-либо песочнице.

Python

```
sandboxes.delete_sandbox(writer.sandbox_id)
reader = sandboxes.create_sandbox("base", mounts=[Mount(volume_id=volume.volume_id, path="/data", read_only=True)])
print(sandboxes.run_command(reader.sandbox_id, command="cat /data/first-run.txt").stdout)  # Sun Nov 22 00:25:33 UTC 2026
sandboxes.delete_sandbox(reader.sandbox_id)
sandboxes.delete_volume(volume.volume_id)
```

TypeScript

```
await sandboxes.deleteSandbox({ sandboxId: writer.sandboxId });
const reader = await sandboxes.createSandbox({
  template: "base",
  mounts: [{ volumeId: volume.volumeId, path: "/data", readOnly: true }],
});
console.log((await sandboxes.runCommand({ sandboxId: reader.sandboxId, command: "cat /data/first-run.txt" })).stdout);
await sandboxes.deleteSandbox({ sandboxId: reader.sandboxId });
await sandboxes.deleteVolume({ volumeId: volume.volumeId });
```

Go

```
if _, err := client.DeleteSandbox(ctx, &sandboxes.DeleteSandboxRequest{SandboxID: writer.SandboxID}); err != nil {
	log.Fatal(err)
}
reader, err := client.CreateSandbox(ctx, &sandboxes.CreateSandboxRequest{
	Template: "base",
	Mounts:   []sandboxes.Mount{{VolumeID: volume.VolumeID, Path: "/data", ReadOnly: true}},
})
if err != nil {
	log.Fatal(err)
}
read, err := client.RunCommand(ctx, &sandboxes.RunCommandRequest{SandboxID: reader.SandboxID, Command: "cat /data/first-run.txt"})
if err != nil {
	log.Fatal(err)
}
fmt.Print(read.Stdout)
_, err = client.DeleteSandbox(ctx, &sandboxes.DeleteSandboxRequest{SandboxID: reader.SandboxID})
if err == nil {
	_, err = client.DeleteVolume(ctx, &sandboxes.DeleteVolumeRequest{VolumeID: volume.VolumeID})
}
```

Rust

```
sandboxes
    .delete_sandbox(DeleteSandboxRequest { sandbox_id: writer.sandbox_id.clone(), ..Default::default() })
    .await?;
let mount = Mount { volume_id: volume.volume_id.clone(), path: "/data".into(), read_only: true };
let reader = sandboxes
    .create_sandbox(CreateSandboxRequest { template: "base".into(), mounts: vec![mount], ..Default::default() })
    .await?;
let read = sandboxes
    .run_command(RunCommandRequest {
        sandbox_id: reader.sandbox_id.clone(),
        command: "cat /data/first-run.txt".into(),
        ..Default::default()
    })
    .await?;
print!("{}", read.stdout);
sandboxes
    .delete_sandbox(DeleteSandboxRequest { sandbox_id: reader.sandbox_id.clone(), ..Default::default() })
    .await?;
sandboxes
    .delete_volume(DeleteVolumeRequest { volume_id: volume.volume_id.clone(), ..Default::default() })
    .await?;
```

CLI

```
$ pethost sandbox rm writer --yes
upc3ehxd65rjgz32   deleted
$ pethost sandbox new --name reader --mount o2rvhgm1dxaefoj7:/data:ro
✓ Made sandbox reader (zc44605gliwn2v1b): default, running, from base@17, in <1 s
zc44605gliwn2v1b
Next:   pethost sandbox run zc44605gliwn2v1b -- <command>   ·   pethost sandbox shell zc44605gliwn2v1b
$ pethost sandbox run reader -- cat /data/first-run.txt
Sun Nov 22 00:25:40 UTC 2026
$ pethost sandbox rm reader --yes
zc44605gliwn2v1b   deleted
$ pethost sandbox volume rm o2rvhgm1dxaefoj7 --yes
o2rvhgm1dxaefoj7
```

## Где хранится том

Том — это файл на диске одного сервера песочниц с файловой системой ext4, и песочница, которая его подключает, работает на этом сервере. Он не копируется ни в объектное хранилище, ни на другой сервер. Из этого следуют три вещи:

- **Если его сервер потерян, том потерян:** он становится DELETED, и песочницы, которые его подключали, его теряют. Не храните там единственную копию чего-либо: то, что важно, отправляйте еще и в свое хранилище.
- **Песочница с томом остается на его сервере.** Остановленная песочница без томов может запуститься на другом сервере, когда ее собственный заполнен; песочница с томом ждет места на своем и пока получает отказ с `NoCapacity`.
- **Песочницу с томом на запись нельзя скопировать форком:** в том пишет только одна песочница за раз.

Том делит скорость диска с песочницей, которая его подключает, — 64 MiB/s на vCPU. Том больше половины диска сервера получает отказ.

## Тома и собственный диск песочницы

Большинству задач том не нужен. Собственный диск песочницы переживает ее паузы и остановки: диск остановленной песочницы хранится в объектном хранилище и возвращается, когда она возобновляется, на любом сервере. Шаблон переносит файлы в каждую новую песочницу. Том — для данных, которые переживают использующие их песочницы или которые читают многие сразу: датасет, веса модели, общий кеш.

## Сколько он стоит

Том оплачивается за весь свой размер, 0,20 $ за GiB в месяц, посекундно, от создания до удаления, подключен он к песочнице или нет. Ваш тариф ограничивает, сколько занимают все тома рабочего пространства вместе: 100 GiB на тарифе за 20 $, 600 GiB на тарифе за 100 $, 10 GiB в пробном периоде. `Workspace.volume_gib_used` говорит, сколько они занимают сейчас.

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

- **`FAILED_PRECONDITION`: том подключен к другой песочнице:** он подключен на запись. Подключите его только для чтения или удалите либо остановите песочницу, которая в него пишет.
- **`FAILED_PRECONDITION`: возможно, нужно воспроизвести его журнал:** последняя песочница, которая в него писала, завершилась, не отключив его. Подключите его один раз на запись, затем снова только для чтения.
- **`FAILED_PRECONDITION` на `DeleteVolume`:** том подключен к песочнице. Сначала удалите ее.
- **`RESOURCE_EXHAUSTED` с `LimitReached`, `volume_gib`:** тома рабочего пространства превысили бы GiB тарифа. Удалите один или сделайте его меньше.
- **`UNAVAILABLE` с `NoCapacity` при создании или возобновлении:** на сервере тома сейчас нет места, а песочница с томом не может переехать. Попробуйте позже.

## Вопросы

### Есть ли у тома бэкап?

Нет. Он лежит на диске одного сервера и никуда не копируется: храните копию важного где-то еще.

### Могут ли несколько песочниц делить один том?

На чтение — сколько угодно одновременно. На запись — по одной за раз.

### Можно ли подключить том к работающей песочнице?

Нет: подключения задаются при создании, до 4 на песочницу.

### Оплачивается ли том, пока его никто не подключает?

Да, за весь размер, 0,20 $ за GiB в месяц, пока вы его не удалите.

### Нужен ли том, чтобы сохранять файлы между сессиями?

Нет. Собственный диск песочницы переживает паузы и остановки; том — для данных, которые переживают саму песочницу.

[ПредыдущаяФорк песочницы вместе с памятью и процессами](https://pethost.dev/ru/docs/sandboxes/forks/) [СледующаяSSH в песочницу: шелл, scp, SFTP и туннели](https://pethost.dev/ru/docs/sandboxes/ssh/)

## Попробуйте 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/)
