Руководство по установке

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

Плагин «Менеджер резервных копий» теперь имеет открытый исходный код: плагин «Менеджер резервных копий», необходимый для восстановления, теперь имеет открытый исходный код и доступен во всех версиях (включая Community). Рекомендуем выполнять восстановление непосредственно через этот плагин.

Перед началом убедитесь, что выполнены условия:

Важные замечания:

  • Это решение построено на PostgreSQL 16. Убедитесь, что в вашем окружении используется PostgreSQL 16.
  • DB_UNDERSCORED не должен иметь значение true: проверьте docker-compose.yml и убедитесь, что DB_UNDERSCORED не установлен в true, иначе это войдёт в конфликт с резервной копией решения и восстановление завершится ошибкой.

Восстановление через менеджер резервных копий

Этот метод использует встроенный в NocoBase плагин «Менеджер резервных копий» для восстановления «в один клик». Это самый простой вариант, но у него есть требования к окружению и редакции.

Ключевые особенности

  • Преимущества:
    1. Просто использовать: полностью через интерфейс; восстанавливает все конфигурации, включая плагины.
    2. Полное восстановление: восстанавливает все системные файлы, включая шаблоны печати и файлы, загруженные в поля файлов таблиц.
  • Ограничения:
    1. Строгие требования к окружению: окружение БД (версия, настройки чувствительности к регистру и т. п.) должно быть максимально совместимо с окружением, в котором создавалась резервная копия.
    2. Зависимость от плагинов: если решение включает коммерческие плагины, которых нет в вашем окружении, восстановление завершится ошибкой.

Шаги

Шаг 1: (настоятельно рекомендуется) запустите приложение с образом full

Чтобы избежать сбоев восстановления из‑за отсутствия клиента БД, настоятельно рекомендуем использовать Docker-образ full, в котором уже есть все необходимые инструменты.

Пример команды для загрузки образа:

docker pull nocobase/nocobase:beta-full

Затем запустите сервис NocoBase, используя этот образ.

Примечание: без образа full может потребоваться вручную установить клиент pg_dump внутри контейнера — это неудобно и менее надёжно.

Шаг 2: включите плагин «Менеджер резервных копий»

  1. Войдите в систему NocoBase.
  2. Перейдите в Управление плагинами.
  3. Найдите и включите плагин Менеджер резервных копий.

Шаг 3: восстановление из локального файла резервной копии

  1. После включения плагина обновите страницу.
  2. В левом меню перейдите в Управление системойМенеджер резервных копий.
  3. Нажмите кнопку Восстановить из локальной резервной копии в правом верхнем углу.
  4. Перетащите скачанный файл резервной копии в область загрузки.
  5. Нажмите Отправить и дождитесь завершения восстановления. Это может занять от нескольких секунд до нескольких минут.

Примечания

  • Совместимость БД: это самый критичный пункт. Версия PostgreSQL, кодировка/набор символов и настройки чувствительности к регистру должны совпадать с окружением источника резервной копии. В частности, имя schema должно быть одинаковым.
  • Соответствие коммерческих плагинов: убедитесь, что установлены и включены все коммерческие плагины, необходимые решению, иначе восстановление будет прервано.

Надеемся, это руководство поможет вам успешно развернуть решение службы поддержки. Если возникнут вопросы — пишите!

Last updated: 2026-03-24