В админке: Настройки
Зашифрованные резервные копии панели
Настройка бэкапов в Cloudflare R2, хранение ключа восстановления офлайн и восстановление панели в чистый каталог данных.
На этой странице
Mistgate умеет загружать резервные копии панели в бакет Cloudflare R2 по расписанию или вручную. Пока владелец не настроит бэкапы, загрузки нет. Архив шифруется через age до отправки: Cloudflare хранит шифротекст, а не содержимое базы.
До включения бэкапов#
Создайте офлайн-ключ восстановления#
Выполните команду один раз на доверенном компьютере, но не на сервере панели:
mistgate backup keygen --identity-file ./mistgate-recovery.txtКоманда создаст закрытый age-ключ и не перезапишет существующий файл, выставит ему права 0600 и напечатает соответствующий открытый адресат. Ключ гибридный, постквантовый, поэтому адресат начинается с age1pq1; адресат X25519 из age-keygen (age1…) тоже подходит. Храните закрытый ключ вне панели и R2, сделайте отдельную офлайн-копию. В админку вставляется только открытый адресат. Без закрытого ключа расшифровать бэкап нельзя.
Создайте бакет и ключ R2#
Создайте бакет в Cloudflare R2 и S3 API-токен только для этого бакета. Mistgate нужен доступ к объектам на чтение, запись и удаление: проверка читает список бэкапов, записывает временный объект, читает его обратно (восстановление скачивает архив) и удаляет, а срок хранения удаляет старые бэкапы. Используйте отдельный токен, а не ключ всего аккаунта.
Настройте панель#
Настраивать и запускать бэкапы может только владелец; сохранение настроек, проверка хранилища и Создать бэкап сейчас просят свежего подтверждения входа. Откройте Настройки → Бэкапы и введите ID аккаунта Cloudflare, Юрисдикция бакета (По умолчанию, EU, US или FedRAMP), Имя бакета R2, ID ключа доступа R2 и Секретный ключ доступа R2, а также Открытый ключ age для восстановления. Секретный ключ R2 шифруется мастер-ключом панели и никогда не возвращается через API. Если оставить поле пустым, сохранённый секрет не меняется; Удалить сохранённый секретный ключ доступа удаляет его.
- Сохраните настройки.
- Нажмите Проверить доступ к R2. Панель прочитает список объектов бакета, запишет временный объект, прочитает его обратно и удалит.
- Укажите интервал от 1 до 168 часов (по умолчанию 24) и срок хранения в днях.
0означает «не удалять»; иначе срок должен быть от 7 до 3650 дней. Три самых новых бэкапа не удаляются, даже если они старше срока хранения, поэтому и при сроке, равном интервалу, в бакете остаётся больше одной копии. - Включите автоматические бэкапы и сохраните. Первый запуск начнётся примерно в течение минуты, затем — по интервалу. Создать бэкап сейчас запускает резервирование сразу после подтверждения владельца. Бэкап создаётся в самой панели, а не в запросе браузера: страница покажет, что он идёт, а потом скажет, чем закончилось, и закрытие страницы его не остановит. Бэкап, который идёт дольше 4 часов, прерывается.
Панель делает согласованный snapshot SQLite, включает остальные файлы каталога данных (среди них пакет релиза и кэш Let's Encrypt) и действующий master.key, добавляет манифест с хешами файлов, шифрует архив на открытый адресат и загружает его в R2. Страница показывает последний успешный бэкап, срок хранения, код последней ошибки и последние бэкапы в бакете. Закрытый ключ восстановления Mistgate не хранит. Держите его отдельную копию, даже если R2 доступен.
Работа идёт во временном каталоге внутри каталога данных, поэтому на этом диске нужно место ещё на одну копию базы и на зашифрованный архив; остальные файлы читаются на месте. После неудачного запуска по расписанию следующая попытка ждёт 2 минуты, потом 4, 8 и так далее, но не дольше интервала. Сохранение настроек сбрасывает ожидание.
Копия на компьютере#
Файл на компьютер в окне перед обновлением панели (см. Обновления) и Скачать на компьютер на этой странице сохраняют тот же зашифрованный архив на компьютер, где открыт браузер, с именем mistgate-backup-<панель>-<версия>-<дата UTC>.tar.gz.age; R2 для этого не нужен. Если на этой странице задан ключ восстановления, файл шифруется на него; иначе вы придумываете пароль для этого файла (от 12 символов), который нигде не сохраняется: без него файл не открыть. Скачивать может только владелец, со свежим подтверждением входа; копии архива на панели не остаётся, а в журнале аудита пишется backup.download. Восстанавливается он так же, как ниже; для файла с паролем вместо --identity-file укажите --passphrase (пароль спросят в терминале) или --passphrase-file FILE.
Восстановление в панели#
Восстановить… в разделе Восстановление из бэкапа на этой странице возвращает работающую панель к бэкапу. Это может только владелец, со свежим подтверждением входа, в версии для VPS.
- Бэкап: файл с этого компьютера (панель загружает его в закрытую папку своего каталога данных) или один из бэкапов в R2 (панель сама скачивает его из бакета; Восстановить рядом с бэкапом в списке открывает окно сразу с ним).
- Ключ: файл ключа восстановления (закрытый ключ, который сделал
mistgate backup keygen; им открываются бэкапы в R2 и файлы, скачанные без пароля) или пароль файла. Ключ отправляется один раз и используется в памяти, чтобы открыть этот бэкап: он не пишется ни на диск, ни в логи, ни в журнал аудита. - Проверить бэкап: панель расшифровывает и проверяет архив так же, как
backup restore(манифест, хеши,master.key, база открывается, её миграции не новее этой панели), и показывает название панели, версию, которая сделала бэкап, и когда, а также ноды, людей и профили в нём рядом с нынешними числами. Пока ничего не изменилось; проверка действует 30 минут. - Восстановить, после того как введено название панели: помощник обновлений панели останавливает её, переносит нынешний каталог данных в
<каталог-данных>.before-restore-<время UTC>, кладёт на его место данные бэкапа и запускает панель. Если восстановленная панель не проработает 45 секунд, помощник вернёт прежние данные и запустит их.
Всё, что изменилось после бэкапа, пропадает, сессии тоже: входите с паролем и passkey из бэкапа. Затем раздел показывает результат: «Панель восстановлена из бэкапа» или «Восстановить не вышло: панель работает на прежних данных»; в журнале аудита — backup.restore_started в старых данных и backup.restored в восстановленных. Данные до восстановления перечисляют перенесённые каталоги с их размером; каждый хранится, пока его не удалить кнопкой Удалить (владелец, с подтверждением входа). Чтобы вернуться вручную, остановите службу и поменяйте каталоги местами.
Восстановление идёт только одно за раз и никогда во время бэкапа, обновления панели или раскатки на ноды. Панель, которая не умеет обновляться сама, не умеет и восстанавливаться сама (это делает тот же помощник): окно так и скажет, а способ ниже работает.
Восстановите новую панель#
Установщик восстанавливает бэкап на новом сервере одной командой, до первого запуска панели:
curl -fsSL https://mistgate.app/install.sh | sudo bash -s -- --restore ./backup.tar.gz.age --identity-file ./mistgate-recovery.txtДля файла с паролем укажите --passphrase-file FILE вместо --identity-file; пароль в командной строке установщик не принимает. Он ставит бинарник, восстанавливает данные в каталог данных, сохраняет master.key, адрес панели и сертификаты из бэкапа, пропускает одноразовую ссылку настройки и говорит, какой домен направить на сервер: как только домен туда указывает, ноды переподключаются сами. С --dry-run он проверяет архив и ключ, ничего не устанавливая.
Вручную:
Скачайте зашифрованный объект из R2 и перенесите его, закрытый ключ восстановления и бинарник mistgate на новый сервер панели. Если Mistgate уже запущен, остановите его. Восстанавливайте в новый, ещё не существующий каталог данных — команда откажется перезаписывать файлы:
mistgate backup restore \
--identity-file ./mistgate-recovery.txt \
--file ./backup.tar.gz.age \
--data-dir /var/lib/mistgate-restoredБинарник mistgate должен быть не старше панели, которая сделала бэкап. Архив, в базе которого есть миграции, неизвестные бинарнику, восстановлен не будет: команда назовёт версию, которая его сделала. Архив постарше подходит, при запуске панель обновит его базу.
Запустите восстановление от пользователя службы панели или смените владельца каталога перед запуском. Укажите /var/lib/mistgate-restored в systemd-юните через serve --data-dir. В восстановленные данные входят база, CA панели и мастер-ключ, поэтому подключённые ноды и зашифрованные секреты панели смогут продолжить работу.
Если systemd передаёт master.key через CREDENTIALS_DIRECTORY, перед запуском замените этот credential восстановленным master.key. Панель должна использовать именно восстановленный ключ, чтобы читать восстановленную базу.
Старый каталог оставьте, пока новая панель не запустится и вы не проверите вход, ноды и подписки. Не восстанавливайте поверх работающего каталога данных. Потеря закрытого ключа сделает бэкапы R2 бесполезными; потеря восстановленного мастер-ключа не даст прочитать зашифрованные секреты панели.
Сбои#
У неудавшегося бэкапа код ошибки виден на странице настроек. Если владелец привязал Telegram, ему ещё и приходит одно сообщение (сколько бы ни повторяло расписание) и ещё одно, когда следующий бэкап проходит: см. Алерты в Telegram.