Резервное копирование
Cuento автоматически делает резервные копии базы данных на Google Drive по настраиваемому расписанию. Резервные копии — это обычные SQL-дампы: читаемые, восстанавливаемые без специального инструментария и автоматически удаляемые по лимиту, чтобы Drive не переполнялся.
Как это работает
Планировщик резервного копирования работает в фоне внутри процесса Cuento. Каждый час он проверяет, пора ли делать резервную копию — исходя из настроенной частоты. Когда приходит время, запускается mysqldump с флагом --single-transaction, и получившийся .sql-файл загружается в папку Cuento Backups на вашем Google Drive. Файлы называются backup_ГГГГ-ММ-ДД_ЧЧ-ММ-СС.sql. После каждой загрузки планировщик удаляет старые файлы, оставляя лишь N последних, которые вы указали.
Для работы резервного копирования нужно три значения в административной панели: Client ID, Client Secret и Refresh Token из вашего OAuth2-приложения Google. Шаги ниже объясняют, как их получить.
Шаг 1 — Создайте проект в Google Cloud
- Перейдите на console.cloud.google.com и войдите под Google-аккаунтом, который будет владеть хранилищем Drive.
- Нажмите на выбор проекта вверху → Новый проект. Назовите его как угодно (например,
cuento-backup). - Выбрав новый проект, перейдите в API и сервисы → Библиотека.
- Найдите Google Drive API и нажмите Включить.
Шаг 2 — Создайте учётные данные OAuth 2.0
- В том же проекте перейдите в API и сервисы → Учётные данные.
- Нажмите Создать учётные данные → Идентификатор клиента OAuth.
- Если потребуется настроить экран согласия:
- Выберите тип Внешний (или Внутренний для аккаунта Google Workspace).
- Заполните обязательные поля: название приложения и контактный email. Добавлять права доступа и тестовых пользователей на этом этапе не нужно — приложение останется в режиме тестирования.
- На экране создания учётных данных укажите Тип приложения: Приложение для ПК. Дайте любое имя и нажмите Создать.
- В диалоговом окне появятся ваши Client ID и Client Secret. Скопируйте оба — они понадобятся чуть позже.
Шаг 3 — Получите refresh token
Cuento использует долгосрочный refresh token, чтобы загружать резервные копии без повторной аутентификации. Проще всего получить его через Google OAuth2 Playground:
- Откройте developers.google.com/oauthplayground.
- Нажмите на шестерёнку (⚙) в правом верхнем углу.
- Поставьте галочку Use your own OAuth credentials и вставьте Client ID и Client Secret из шага 2.
- В левом столбце найдите Drive API v3 и выберите область видимости
https://www.googleapis.com/auth/drive. Нажмите Authorize APIs. - Откроется окно входа Google. Войдите под тем же аккаунтом, который владеет проектом.
- Нажмите Exchange authorization code for tokens.
- Скопируйте Refresh token из ответа. Он начинается с
1//.
Держите этот токен в тайне. Любой, у кого есть Client ID, Client Secret и Refresh Token, получит доступ к вашему Drive.
Шаг 4 — Настройте резервное копирование в административной панели
Перейдите в Администрирование → Резервное копирование. Введите полученные данные:
| Поле | Значение |
|---|---|
| Client ID | Из шага 2 |
| Client Secret | Из шага 2 |
| Refresh Token | Из шага 3 |
| Folder ID | Оставьте пустым для автоматически созданной папки Cuento Backups, или вставьте ID конкретной папки Drive |
| Частота | daily (ежедневно), weekly (еженедельно) или monthly (ежемесячно) |
| Хранить | Количество файлов резервных копий для хранения (старые удаляются после каждой новой загрузки) |
| Включено | Переключатель для запуска планировщика |
Нажмите Сохранить настройки. Чтобы сразу проверить подключение, нажмите Запустить резервное копирование — резервная копия должна появиться в списке в течение нескольких секунд.
Скачивание резервной копии
В административной панели отображается список всех резервных копий в папке Drive с временными метками. Нажмите на любую запись, чтобы скачать .sql-файл прямо на компьютер.
Восстановление из резервной копии
Когда форум работает
Если форум доступен, можно восстановить через административную панель:
- Перейдите в Администрирование → Резервное копирование → Восстановление.
- Загрузите
.sql-файл (скачанный с Drive или полученный при ручном экспорте). - Бэкенд передаёт файл в
mysqlи возвращает результат по завершении импорта.
Внимание: это перезапишет текущую базу данных. Все данные, добавленные после создания резервной копии, будут утеряны.
Когда форум недоступен
Если сайт не открывается и нужно восстановить базу вручную, воспользуйтесь Cuento CLI:
- Скачайте
.sql-файл с Google Drive напрямую (через drive.google.com). - Запустите CLI, перейдите в Database → Restore from file и укажите путь к
.sql-файлу. - CLI подключится к серверу по SSH, скопирует файл и запустит импорт через
mysql.
Ручной импорт через SSH
Если предпочитаете сделать это самостоятельно:
# Скопируйте резервную копию на сервер
scp backup_2026-01-01_12-00-00.sql user@ваш-сервер:/tmp/
# Подключитесь по SSH и запустите импорт
ssh user@ваш-сервер
mysql -u <пользователь_бд> -p<пароль_бд> <имя_бд> < /tmp/backup_2026-01-01_12-00-00.sql
Ручной экспорт (без Google Drive)
Если нужен разовый SQL-дамп без настройки Google Drive, в административной панели есть кнопка Экспортировать в разделе Администрирование → Резервное копирование. Она скачивает свежий mysqldump прямо в браузер.