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

# Резервные копии и восстановление

> Согласованный бэкап, отдельное хранение master key, восстановление на другом сервере и возврат доступа владельцу.

Резервная копия Telepúrte должна содержать согласованные базу и зашифрованное состояние установки. Для этого используйте штатные команды `backup create`, `backup verify` и `backup restore`. Простое копирование одного файла работающей SQLite-базы не заменяет эту процедуру.

## Что сохранить

| Материал | Входит в `backup create` | Назначение |
| - | - | - |
| SQLite и `state.enc` | Да | Пользователи, доступы, задания, история и идентичность |
| Манифест комплекта | Да | Проверка согласованности и целостности |
| `master.key` | Нет | Расшифровка данных исходной установки |
| `config.json` | Нет | Адреса, пути и настройки сервиса |
| TLS и конфигурация reverse proxy | Нет | Восстановление внешнего входа |

Храните master key отдельным защищённым способом. Без исходного ключа зашифрованные данные бэкапа не восстановить. Восстановление панели также не возвращает автоматически файлы приложений на управляемых нодах — их резервное копирование организуется отдельно.

## Создать и проверить копию

Команда может работать при запущенной панели. Подготовьте приватный родительский каталог, доступный пользователю `telepurte`, с режимом `0700`. Каталог конкретного комплекта ещё не должен существовать.

```bash theme={null}
sudo -u telepurte telepurte backup create \
  --config /etc/telepurte/config.json \
  --output /secure/telepurte-backups/2026-10-30

sudo -u telepurte telepurte backup verify \
  --config /etc/telepurte/config.json \
  --source /secure/telepurte-backups/2026-10-30
```

Путь и дата — пример; для следующей копии используйте новое имя. Проверка сверяет базу, состояние и сохранённые зашифрованные материалы. Сохраните результат с ID установки и временем, но не публикуйте сам комплект.

Успех `verify` подтверждает целостность данного комплекта. Он не доказывает, что вы выбрали самый свежий бэкап: отдельно сверьте дату и нужную точку восстановления.

## Восстановить установку

1. Остановите Telepúrte и другие процессы, которые пишут в его данные.
2. Сохраните текущий каталог данных отдельно, даже если установка повреждена.
3. Подготовьте конфигурацию на целевом сервере и исходный `master.key` с правильным владельцем и режимом `0600`.
4. Укажите пустой приватный `data_dir` либо ещё не существующий каталог. Команда не перезаписывает существующую установку.
5. Проверьте комплект и ID установки.
6. Выполните восстановление с ожидаемым ID.

```bash theme={null}
sudo -u telepurte telepurte backup restore \
  --config /etc/telepurte/config.json \
  --source /secure/telepurte-backups/2026-10-30 \
  --expect-instance tp_REPLACE_WITH_VERIFIED_INSTANCE_ID

sudo -u telepurte telepurte database status --config /etc/telepurte/config.json
sudo -u telepurte telepurte check --config /etc/telepurte/config.json
```

Замените условный `tp_REPLACE_WITH_VERIFIED_INSTANCE_ID` на ID из проверенного комплекта. Не запускайте исходную и восстановленную установку одновременно с одной идентичностью. После успешной проверки запустите сервис и проверьте сеть, домен, TLS, бастионы, агенты и интеграции.

Старый совместимый комплект может мигрироваться при восстановлении; исходная копия остаётся неизменной. База с более новой неизвестной схемой не должна открываться старым бинарником.

## Незавершённое восстановление

При сбое может остаться `.restore-incomplete`. Этот маркер закрывает запуск частично восстановленных данных. Не удаляйте его для обхода ошибки: остановите сервис, сохраните каталог для разбора, подготовьте новый пустой каталог и повторите восстановление из проверенного комплекта.

Если ошибка связана с ключом или ID установки, сначала исправьте выбранные материалы. Создание нового master key не расшифрует старый бэкап.

## Восстановление владельца

Если локальный владелец потерял пароль или второй фактор, используйте доступ к серверу панели. HTTP-сброса владельца нет. Остановите сервис, сделайте согласованную копию и сверьте ID через `telepurte identity` либо манифест.

Подготовьте новый пароль в защищённом файле и передайте через stdin из административной оболочки:

```bash theme={null}
sudo -u telepurte telepurte owner recover \
  --login owner \
  --expect-instance tp_REPLACE_WITH_VERIFIED_INSTANCE_ID \
  --config /etc/telepurte/config.json < /secure/new-owner-password.txt
```

Используйте фактический логин исходного владельца. Восстановление отзывает его браузерные и шлюзовые сессии, прежний TOTP и резервные коды. При новом входе заново настройте MFA и сохраните новые коды.

Роли, гранты, плейбуки и расписания не отменяются этой командой. Если причиной была компрометация, отдельно проверьте выданные права и операционные решения перед возвращением установки в работу.

## Проверка

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

## Откат

До восстановления сохраните исходные данные и конфигурацию. Для возврата остановите восстановленную установку и верните согласованный прежний комплект с подходящим бинарником и ключом. Изменения, совершённые после даты выбранной копии, в ней отсутствуют; их нельзя восстановить одним увеличением срока хранения.

Команды относятся к стандартной Linux-установке; фактические пути проверьте в своей конфигурации.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.