> ## Documentation Index
> Fetch the complete documentation index at: https://docs.vetox.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Команды резервного копирования

> Группа команд /backup — создавайте, просматривайте, изучайте, восстанавливайте, планируйте, экспортируйте, импортируйте и удаляйте резервные копии вашего сервера прямо из Discord.

`/backup` управляет [Резервной копией сервера](/ru/server-management/server-backup) прямо из Discord. Одна команда, **тринадцать подкоманд**.

| Требование      | Значение                                                         |
| --------------- | ---------------------------------------------------------------- |
| **Вам нужно**   | Manage Server                                                    |
| **Vetox нужно** | View Channel, Read Message History — и больше для восстановления |
| **Кулдаун**     | 5 с                                                              |
| **Где**         | Только на серверах. Недоступно в личных сообщениях               |

<Warning>
  **Каждый ответ `/backup` виден только вам.** ID резервной копии — это ключ к содержимому вашего сервера, поэтому Vetox никогда не публикует его там, где его смогут прочитать другие участники.
</Warning>

<Note>
  Каждую подкоманду можно по отдельности отключить или ограничить конкретными ролями и каналами — через [Управление командами](/ru/server-management/command-management). `/backup create` может быть открыта вашим администраторам, пока `/backup load` выключена полностью.
</Note>

## Создание и просмотр

<AccordionGroup>
  <Accordion title="/backup create — создать копию" icon="camera">
    | Опция      | Обязательно | Примечания                                     |
    | ---------- | ----------- | ---------------------------------------------- |
    | `name`     | Нет         | До 64 символов. По названию копию проще найти  |
    | `messages` | Нет         | 0–250, с ограничением максимумом вашего тарифа |

    Премиум-разделы включаются автоматически в пределах того, что позволяет ваш тариф. В ответе приходит ID новой копии, а затем он обновляется по мере выполнения. Когда копирование завершено, в ответе показываются **ID**, две команды для работы с ним (`/backup info` и `/backup load`) и ссылка на копию в панели управления, а на Starter — напоминание о том, что сообщения, данные участников, баны и вложения сохранены не были.

    <Note>
      Одна ручная копия на сервер раз в **10 минут** и только одна задача копирования или восстановления одновременно. Для создания нужно право Administrator, а на [уровне прав доступа](/ru/server-management/server-backup#права-доступа) **Только владелец** — оно доступно лишь владельцу.
    </Note>
  </Accordion>

  <Accordion title="/backup list — посмотреть свои копии" icon="list">
    | Опция   | Обязательно | Примечания                                                                                         |
    | ------- | ----------- | -------------------------------------------------------------------------------------------------- |
    | `page`  | Нет         | От 1. Двадцать строк на страницу                                                                   |
    | `scope` | Нет         | **Этот сервер** (по умолчанию), **Копии каналов этого сервера** или **Мои копии со всех серверов** |

    Новые сверху. Автоматические и страховочные копии помечены, чтобы их можно было отличить с первого взгляда. `scope:mine` перечисляет все созданные вами копии на любом сервере вместе с сервером, откуда они, — так находят ID копии, сделанной в другом месте, прежде чем загрузить её сюда.
  </Accordion>

  <Accordion title="/backup info — что содержит копия" icon="circle-info">
    | Опция       | Обязательно | Примечания                    |
    | ----------- | ----------- | ----------------------------- |
    | `backup_id` | **Да**      | Автодополняется по мере ввода |

    Количества, параметры копирования, размер, самые активные каналы, предупреждения, то, заблокирована ли копия вашим тарифом, и ссылка на копию в Просмотре снимка в панели управления — там можно прочитать каждый канал, роль, настройку, бан и участника, которые в ней есть.
  </Accordion>
</AccordionGroup>

<Tip>
  `backup_id` автодополняется в каждой подкоманде, которая его принимает, поэтому копировать ID вручную не нужно. Предлагаются только те копии, которыми вам разрешено пользоваться.
</Tip>

## Восстановление

<AccordionGroup>
  <Accordion title="/backup load — восстановить копию" icon="rotate-left">
    | Опция       | Обязательно | Примечания                                                        |
    | ----------- | ----------- | ----------------------------------------------------------------- |
    | `backup_id` | **Да**      | Автодополняется, включая ваши собственные копии с других серверов |
    | `messages`  | Нет         | 0–250, с ограничением максимумом вашего тарифа                    |
    | `options`   | Нет         | До 200 символов. См. грамматику ниже                              |

    При первом нажатии ничего не восстанавливается. Vetox отвечает **планом** — сколько каналов и ролей будет удалено и создано и есть ли роли выше собственной роли Vetox, которые поэтому нельзя тронуть, — с кнопками **Подтвердить** и **Отмена**, которые истекают через **60 секунд**. Только после подтверждения Vetox делает страховочную копию и запускает восстановление.

    <Warning>
      Загрузка резервной копии заменяет каналы и роли этого сервера. Участников никогда не исключают, но всё созданное после создания копии будет потеряно.
    </Warning>

    <Note>
      `/backup load` подчиняется [уровню прав доступа](/ru/server-management/server-backup#права-доступа) сервера. На уровне по умолчанию **Администраторы не могут выполнять разрушительные действия** всем, кроме владельца, будет отказано — даже с правом Administrator.
    </Note>

    <Note>
      Восстановления и откаты нормируются посуточно — **10 на сервер**, **20 на человека**. `/backup load`, `/backup channel load` и откат отслеженного изменения расходуют оба лимита; продолжение прерванного восстановления — нет.
    </Note>
  </Accordion>

  <Accordion title="/backup cancel — остановить текущую задачу" icon="ban">
    Без опций. Отменяет активное копирование или восстановление на этом сервере. Контрольная точка сохраняется, поэтому отменённое восстановление всё ещё можно продолжить из панели управления.
  </Accordion>

  <Accordion title="/backup status — что выполняется и какой лимит действует" icon="heart-pulse">
    Без опций. Показывает задачу, которая выполняется на этом сервере (вид, этап, прогресс, предупреждения, время запуска), — или что ничего не выполняется; когда будет возможна следующая ручная копия, если действует 10-минутный кулдаун; когда снимется **лимит Discord на создание**, если восстановление в него упёрлось; а когда ничего не выполняется — почему остановилась последняя задача и можно ли продолжить её из панели управления.
  </Accordion>
</AccordionGroup>

### Грамматика `options`

`options` — это список токенов через пробел, применяемых **слева направо**.

| Токен                                                                                                      | Действие            |
| ---------------------------------------------------------------------------------------------------------- | ------------------- |
| `settings` `roles` `delete-roles` `channels` `delete-channels` `members` `bans` `pins` `emojis` `stickers` | Включает эту часть  |
| `!` перед любым из них — `!members`                                                                        | Выключает эту часть |
| `*`                                                                                                        | Включает **всё**    |
| `!*`                                                                                                       | Выключает **всё**   |

Если не указывать `options` вовсе, Vetox использует значение по умолчанию: **`delete-channels channels delete-roles roles settings`** — полная замена структуры, без участников, банов, закреплений, эмодзи и стикеров.

| Пример                                   | Результат                                                      |
| ---------------------------------------- | -------------------------------------------------------------- |
| `options:!* roles delete-roles`          | Только роли — удаляет нынешние роли и воссоздаёт роли из копии |
| `options:!* channels roles settings`     | Структура в дополнение к тому, что есть, — ничего не удаляется |
| `options:* !members !bans`               | Всё, кроме данных участников и банов                           |
| `options:!delete-channels !delete-roles` | Значение по умолчанию, сделанное добавляющим                   |

<Warning>
  **Порядок важен.** `* !members` включает всё, а затем выключает участников. `!members *` выключает участников, а затем снова включает всё, включая участников. Читайте свой список токенов слева направо.
</Warning>

<Note>
  Токены никогда не расширяют то, что позволяет ваш тариф, — ограничение тарифа применяется последним. Неизвестный токен не игнорируется, а отклоняется с указанием его имени, поэтому опечатка никогда не пропадает молча.
</Note>

## Расписание

<AccordionGroup>
  <Accordion title="/backup interval — автоматические копии" icon="clock">
    | Опция      | Обязательно | Примечания                                                 |
    | ---------- | ----------- | ---------------------------------------------------------- |
    | `mode`     | **Да**      | `on`, `off` или `status`                                   |
    | `interval` | Нет         | 4 часа, 8 часов, 12 часов, 24 часа, 2 дня, 3 дня, 1 неделя |
    | `messages` | Нет         | 0–250, с ограничением максимумом вашего тарифа             |

    `status` сообщает текущее расписание, ничего не меняя: интервал, сколько копий хранится, последний и следующий запуск и ID самой свежей автоматической копии. При включении расписания вам сообщат, когда выполнится первая копия.

    <Note>
      Интервал короче, чем позволяет ваш тариф, будет отклонён, а в отказе назван минимум вашего тарифа в часах. Автоматические копии ротируются: самые старые сверх количества, которое хранит ваш тариф, удаляются по мере появления новых.
    </Note>
  </Accordion>
</AccordionGroup>

## Копии каналов

<AccordionGroup>
  <Accordion title="/backup channel create — создать копию одного канала" icon="hashtag">
    | Опция      | Обязательно | Примечания                                                    |
    | ---------- | ----------- | ------------------------------------------------------------- |
    | `channel`  | Нет         | Текстовый, объявлений или ветка. По умолчанию — текущий канал |
    | `messages` | Нет         | 0–1000, с ограничением максимумом вашего тарифа               |
    | `before`   | Нет         | ID сообщения. Сохраняет сообщения **до** него                 |

    <Tip>
      `before` — способ уйти в прошлое дальше, чем позволяет один запуск: создайте копию канала, а затем вторую, указав в `before` ID самого старого сообщения, до которого дошла первая.
    </Tip>
  </Accordion>

  <Accordion title="/backup channel load — опубликовать их в канал" icon="paste">
    | Опция       | Обязательно | Примечания                                      |
    | ----------- | ----------- | ----------------------------------------------- |
    | `backup_id` | **Да**      | Автодополняет только копии каналов              |
    | `channel`   | Нет         | Куда публиковать. По умолчанию — текущий канал  |
    | `messages`  | Нет         | 0–1000, с ограничением максимумом вашего тарифа |

    Сообщения публикуются от старых к новым, вместе с закреплениями.

    <Note>
      **Ничего не удаляется.** Сохранённые сообщения добавляются к тому, что уже есть в канале. Большая копия канала публикуется долго — ответ сообщает о прогрессе по ходу дела.
    </Note>
  </Accordion>
</AccordionGroup>

<Info>
  Копии каналов требуют **Basic** или выше.
</Info>

## Перенос копий

<AccordionGroup>
  <Accordion title="/backup export — скачать в JSON" icon="file-export">
    | Опция       | Обязательно | Примечания      |
    | ----------- | ----------- | --------------- |
    | `backup_id` | **Да**      | Автодополняется |

    Отправляет копию файлом `.json` в формате Discord, прикреплённым к ответу, который видите только вы. Свыше **8 МБ** вместо файла приходит ссылка на панель управления.

    <Note>
      В экспорт входят сервер, роли, каналы, эмодзи и стикеры. **Сообщения, участники и баны не включаются** — чтобы перенести их, восстановите копию. Экспорт работает на любом тарифе.
    </Note>
  </Accordion>

  <Accordion title="/backup import — собрать копию из файла" icon="file-import">
    | Опция  | Обязательно | Примечания                                      |
    | ------ | ----------- | ----------------------------------------------- |
    | `file` | **Да**      | Файл сервера `.json` в формате Discord, до 5 МБ |

    Vetox проверяет файл, превращает его в резервную копию и отвечает её ID. Восстанавливайте и изучайте её, как любую другую.

    <Warning>
      Файл, который не соответствует формату сервера Discord, отклоняется целиком с указанием первого поля, не прошедшего проверку. Vetox никогда не применяет файл наполовину.
    </Warning>

    <Info>
      Импорт требует **Basic** или выше.
    </Info>
  </Accordion>
</AccordionGroup>

## Удаление

<AccordionGroup>
  <Accordion title="/backup delete — удалить одну копию" icon="trash">
    | Опция       | Обязательно | Примечания      |
    | ----------- | ----------- | --------------- |
    | `backup_id` | **Да**      | Автодополняется |

    Сначала просит **Подтвердить**. Удаление стирает снимок и все сохранённые с ним файлы — немедленно и безвозвратно.
  </Accordion>

  <Accordion title="/backup purge — удалить все копии" icon="dumpster-fire">
    Без опций. Просит **Подтвердить**, а затем удаляет **все** копии этого сервера вместе с сохранёнными в них файлами.

    <Warning>
      Отмены нет, корзины тоже. Сначала экспортируйте всё, что хотите сохранить.
    </Warning>
  </Accordion>
</AccordionGroup>

<Note>
  `/backup delete` и `/backup purge` — это разрушительные действия в рамках [уровня прав доступа](/ru/server-management/server-backup#права-доступа) сервера, поэтому на уровне по умолчанию они доступны лишь владельцу.
</Note>

## Примеры

```text theme={null}
/backup create name:before-rework
/backup list page:1
/backup list scope:mine
/backup info backup_id:GB7K2QX4M1ZP
/backup load backup_id:GB7K2QX4M1ZP options:!* channels roles
/backup status
/backup interval mode:on interval:12h
/backup channel create channel:#general messages:500
```

## Когда команда отклонена

Vetox всегда называет причину. Самые частые:

| Что отвечает                                                                        | Что делать                                                                                                                                                            |
| ----------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Резервная копия здесь создавалась недавно                                           | Дождитесь окончания 10-минутного кулдауна на создание, действующего на сервер                                                                                         |
| На этом сервере уже выполняется другая задача копирования                           | Дождитесь её или выполните `/backup cancel`                                                                                                                           |
| Достигнут сегодняшний лимит на восстановление и откат изменений                     | Этот сервер или ваш аккаунт израсходовал суточный лимит: 10 на сервер / 20 на человека. Попробуйте ещё раз завтра                                                     |
| Вы достигли лимита резервных копий вашего тарифа                                    | Удалите одну или повысьте тариф                                                                                                                                       |
| Эта копия превышает лимит вашего тарифа                                             | Она заблокирована понижением тарифа. Удалите более новую копию или повысьте тариф                                                                                     |
| Это могут делать только те, кому разрешают права доступа к резервным копиям сервера | Уровень прав доступа сервера оставляет это владельцу. Действует владелец — или он меняет уровень в «Настройки → Права доступа»                                        |
| Этот интервал короче, чем разрешает ваш тариф                                       | Используйте минимум, названный в сообщении, или повысьте тариф                                                                                                        |
| Один из выбранных параметров недопустим                                             | Неизвестный токен `options` — сверьтесь с грамматикой выше                                                                                                            |
| У Vetox нет нужных прав                                                             | Выдайте Vetox право Administrator и поднимите его роль выше восстанавливаемых ролей                                                                                   |
| Discord позволяет боту создать только 250 ролей или 500 каналов в течение 48 часов  | Собственный лимит Discord на создание. `/backup status` показывает, когда он снимется; подождите и продолжите — или загрузите заново с `options:!delete-roles !roles` |
| Этот файл не является корректным экспортом сервера Discord                          | Файл для импорта не соответствует формату Discord                                                                                                                     |
| Резервное копирование сервера временно недоступно                                   | Приостановлено на время обслуживания. Ваши копии не затронуты                                                                                                         |

## Связанное

<CardGroup cols={2}>
  <Card title="Резервная копия сервера" icon="server" href="/ru/server-management/server-backup">
    Функция целиком — восстановление, расписания, отслеживание изменений и Машина времени.
  </Card>

  <Card title="Мои резервные копии" icon="box-archive" href="/ru/members/my-backups">
    Ваши копии со всех серверов.
  </Card>

  <Card title="Управление командами" icon="sliders" href="/ru/server-management/command-management">
    Отключайте или ограничивайте каждую подкоманду по отдельности.
  </Card>

  <Card title="Справочник команд" icon="terminal" href="/ru/commands/overview">
    Как работают права и кулдауны во всех командах.
  </Card>
</CardGroup>
