CMS YouWebsite · 2.0.0

Резервирование и восстановление

← Все руководства

Памятка для редакторов — в docs/backup-for-editors.md. Ниже — то, что делается на сервере.

Что входит в копию

Одна копия — один ZIP-файл site-backup-<дата>-<время>-<вид>.zip:

В копии Нет в копии
content.json — тексты публикаций и документов /etc/cms-youwebsite/service.env — настройки, пароль почты, ключи
/var/lib/cms-youwebsite/mail.json — почта из окон установки (с паролем)
uploads/ — фото и документы (без корзины) /var/lib/cms-youwebsite/editors.json — пользователи и хеши паролей
editor-journal.log — журнал (для справки, при восстановлении не заменяет текущий) собранные страницы публикаций — служба собирает их сама при запуске
manifest.json — состав и контрольные суммы SHA-256 код сайта — его берут из репозитория
README.txt — пояснение для человека

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

sudo tar -czf ~/site-settings-$(date +%F).tar.gz \
  /etc/cms-youwebsite/service.env /var/lib/cms-youwebsite/editors.json \
  $(ls /var/lib/cms-youwebsite/mail.json 2>/dev/null)

Если файла пользователей нет, на новом сервере заведите суперадмина и почту в окнах установки (sudo cms-youwebsite-setup выдаст ссылку) или командой sudo cms-youwebsite-users; остальных суперадмин пригласит из консоли.

Ночные копии

Копию делает таймер systemd в 03:30 (± 30 минут) — та же программа, что и кнопка «Сделать копию сейчас» в консоли.

sudo cp deploy/cms-youwebsite-backup.service deploy/cms-youwebsite-backup.timer /etc/systemd/system/
sudo systemctl daemon-reload
sudo systemctl enable --now cms-youwebsite-backup.timer
systemctl list-timers cms-youwebsite-backup.timer     # когда следующий запуск
sudo systemctl start cms-youwebsite-backup.service    # сделать копию прямо сейчас

Копии лежат в /var/lib/cms-youwebsite/backups/ (CONTENT_BACKUP_DIR). Хранятся 7 последних ночных (CONTENT_BACKUP_KEEP) и 5 последних сделанных вручную или перед восстановлением (CONTENT_BACKUP_KEEP_MANUAL); лишние удаляются автоматически. Если места на диске не хватает, копия не создаётся, чтобы не остановить сайт, а консоль заранее предупреждает, когда места мало.

Список и проверка копий

sudo -u www-data python3 /opt/cms-youwebsite/site_backup.py list
sudo python3 /opt/cms-youwebsite/site_backup.py verify ФАЙЛ.zip

verify открывает архив и сверяет каждый файл с контрольной суммой. Так стоит проверить копию, которую прислал клиент, ещё до восстановления.

Скачать копию на компьютер

  • Через консоль: «Резервные копии» → «Скачать». Так делают редакторы.

  • По SSH (macOS, Linux, Windows 10/11 в PowerShell):

    scp user@server:/var/lib/cms-youwebsite/backups/site-backup-....zip .
    

    В Windows можно также использовать WinSCP.

Восстановление из консоли (владелец сайта)

Суперадмин восстанавливает сайт сам: «Резервные копии» → «Восстановить» у копии на сервере или «Загрузить копию с компьютера». Подтверждение — словом ВОССТАНОВИТЬ и кодом на почту. Служба не перезапускается: подмена идёт под замком хранилища, затем страницы собираются заново. Порядок тот же, что у команды ниже: проверка архива → копия …-before-restore.zip → подмена данных.

Загрузка идёт отдельным адресом /api/admin/backups/upload. У него в nginx свой предел размера (client_max_body_size 4g, без буфера), остальная консоль — по прежнему 12 МБ. Предел самой службы — CONTENT_BACKUP_UPLOAD_MAX_BYTES (по умолчанию 4 ГБ). Если копии больше, увеличьте оба значения. Перед приёмом служба проверяет место на диске: на саму копию, её распаковку и копию «перед восстановлением».

Команда на сервере (ниже) остаётся для случаев, когда консоль недоступна.

Восстановление на этом же сервере (командой)

  1. Загрузите файл копии на сервер (если его прислал клиент):

    scp site-backup-....zip user@server:/tmp/
    
  2. Восстановите:

    sudo python3 /opt/cms-youwebsite/site_backup.py restore /tmp/site-backup-....zip
    

    Команда:

    1. проверит архив (если он повреждён или изменён — остановится, ничего не меняя);
    2. покажет, что внутри, и попросит ввести ВОССТАНОВИТЬ;
    3. остановит службу сайта (cms-youwebsite; другое имя — --service ИМЯ);
    4. сохранит текущее состояние копией …-before-restore.zip;
    5. заменит тексты, фото и документы, сохранив корзину и журнал (в журнал добавится запись «восстановление сайта из копии»);
    6. запустит службу — она заново соберёт страницы публикаций — и проверит, что сайт отвечает.
  3. Откройте сайт и консоль, проверьте публикации.

Если восстановили не ту копию — восстановите …-before-restore.zip той же командой: это состояние сразу перед восстановлением.

Переезд на новый сервер

  1. Направьте домен на новый сервер: запись A у регистратора (без этого не выпустят сертификат HTTPS).
  2. Установите CMS YouWebsite по INSTALL.md, шаги 1–2: sudo bash install.sh поставит программу, nginx, сертификат и таймер копий. На вопрос о демонстрационных публикациях ответьте «н».
  3. Задайте почту сайта и владельца в окнах установки (INSTALL.md, шаг 3): пользователи и почта в копию не входят.
  4. Восстановите сайт из копии: проще всего владельцу — в консоли, «Резервные копии» → «Загрузить копию с компьютера»; или командой, как описано выше.
  5. Проверьте сайт, вход в консоль и скачивание копии. Остальных пользователей владелец приглашает заново.

Если что-то пошло не так

  • Ошибка: Недостаточно места на диске… — удалите старые копии в /var/lib/cms-youwebsite/backups/ или освободите место.
  • Файл … в копии изменён или повреждён — копия испорчена при передаче; возьмите другую копию (клиент мог распаковать и снова запаковать архив — так делать нельзя).
  • Служба не ответила после восстановления: journalctl -u cms-youwebsite -n 50.