Памятка для редакторов — в 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 ГБ). Если копии больше, увеличьте оба значения. Перед приёмом
служба проверяет место на диске: на саму копию, её распаковку и копию «перед
восстановлением».
Команда на сервере (ниже) остаётся для случаев, когда консоль недоступна.
Восстановление на этом же сервере (командой)
Загрузите файл копии на сервер (если его прислал клиент):
scp site-backup-....zip user@server:/tmp/Восстановите:
sudo python3 /opt/cms-youwebsite/site_backup.py restore /tmp/site-backup-....zipКоманда:
- проверит архив (если он повреждён или изменён — остановится, ничего не меняя);
- покажет, что внутри, и попросит ввести
ВОССТАНОВИТЬ; - остановит службу сайта (
cms-youwebsite; другое имя —--service ИМЯ); - сохранит текущее состояние копией
…-before-restore.zip; - заменит тексты, фото и документы, сохранив корзину и журнал (в журнал добавится запись «восстановление сайта из копии»);
- запустит службу — она заново соберёт страницы публикаций — и проверит, что сайт отвечает.
Откройте сайт и консоль, проверьте публикации.
Если восстановили не ту копию — восстановите …-before-restore.zip той же
командой: это состояние сразу перед восстановлением.
Переезд на новый сервер
- Направьте домен на новый сервер: запись A у регистратора (без этого не выпустят сертификат HTTPS).
- Установите CMS YouWebsite по INSTALL.md, шаги 1–2:
sudo bash install.shпоставит программу, nginx, сертификат и таймер копий. На вопрос о демонстрационных публикациях ответьте «н». - Задайте почту сайта и владельца в окнах установки (INSTALL.md, шаг 3): пользователи и почта в копию не входят.
- Восстановите сайт из копии: проще всего владельцу — в консоли, «Резервные копии» → «Загрузить копию с компьютера»; или командой, как описано выше.
- Проверьте сайт, вход в консоль и скачивание копии. Остальных пользователей владелец приглашает заново.
Если что-то пошло не так
Ошибка: Недостаточно места на диске…— удалите старые копии в/var/lib/cms-youwebsite/backups/или освободите место.Файл … в копии изменён или повреждён— копия испорчена при передаче; возьмите другую копию (клиент мог распаковать и снова запаковать архив — так делать нельзя).- Служба не ответила после восстановления:
journalctl -u cms-youwebsite -n 50.