#Установка

Единая система управления бизнесом охватывает шесть модулей: CRM, Управление продажами, Help Desk, Управление проектами, Управление активами, HR / Управление персоналом. Достаточно одним действием восстановить файл резервной копии .nbdata через встроенный в NocoBase плагин «Менеджер резервных копий», чтобы получить полный набор данных.

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

#Шаги

#Шаг 1: Запустить приложение из образа full

Настоятельно рекомендуется использовать full-вариант Docker-образа — в нём уже есть клиент БД и прочие утилиты, дополнительная настройка не нужна:

docker pull nocobase/nocobase:alpha-full

После этого запускайте NocoBase из этого образа.

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

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

#Шаг 3: Восстановить из локального файла

1. После включения плагина обновите страницу

2. В боковом меню перейдите в Системное администрирование / Менеджер резервных копий

   

3. Нажмите Восстановить из локальной резервной копии в правом верхнем углу

4. Перетащите скачанный файл nocobase_all_in_one_backup_260521.nbdata в область загрузки

   

5. Нажмите Отправить и дождитесь завершения восстановления — это может занять от нескольких десятков секунд до нескольких минут

#Замечания

• Совместимость БД — версия PostgreSQL, кодировка и настройки регистрозависимости должны совпадать с исходными; особенно важно совпадение имени schema
• Соответствие коммерческих плагинов — все используемые в резервной копии коммерческие плагины должны быть заранее установлены и включены локально, иначе восстановление прервётся. В единое решение входят: «Управление почтой», «Журнал аудита», «AI-сотрудники». В Community эти плагины отсутствуют, и соответствующие пункты меню просто не появятся, остальные модули не пострадают

#Обязательная настройка после установки

После восстановления система уже открывается, но две настройки указывают на наше демо-окружение и требуют замены на ваши собственные.

#1. Движок хранилища файлов (OSS / локально)

В демо-резервной копии хранилище по умолчанию указывает на наш демонстрационный Alibaba Cloud OSS — Access Key наружу не публикуется, поэтому любая загрузка вложений, шаблонов печати и аватаров AI-сотрудников завершится ошибкой.

В большинстве случаев достаточно переключиться на локальное хранилище; собственный OSS нужен только при необходимости CDN-ускорения или работы с крупными файлами.

Шаги переключения:

1. Перейдите в Управление плагинами / Менеджер файлов (или откройте /admin/settings/file-manager напрямую)

2. Вариант A — локальное хранилище (самый простой, подходит для самостоятельного развёртывания):

   • Найдите автоматически созданную запись «Local Storage (локальное хранилище)»
   • Нажмите Изменить, в нижней части панели настроек отметьте «Использовать как хранилище по умолчанию» и нажмите Отправить

   

   Внимание

   При развёртывании в Docker локальное хранилище находится внутри контейнера; при удалении контейнера файлы будут потеряны. Для production рекомендуется монтировать volume или использовать облачное хранилище.

3. Вариант B — собственный OSS / S3 / COS:

   • Нажмите Добавить новое, выберите нужный тип (Alibaba Cloud OSS / Amazon S3 / Tencent Cloud COS / S3 Pro)
   • Заполните Access Key, Bucket, Region, домен и прочие параметры, отметьте «Использовать как хранилище по умолчанию» и нажмите Отправить

   

4. Удалите или отключите преднастроенную в демо запись OSS, чтобы избежать ошибочного использования

Подробное описание параметров см. в Обзоре движка хранилища.

#2. Ключи LLM-сервисов для AI Employees

В демо-резервной копии предустановлены несколько записей LLM-сервисов (OpenAI, Claude, Gemini, DeepSeek, Qwen, Kimi и др.), в них прописаны наши API Key, которые не работают снаружи. До замены ключей функционал AI-сотрудников недоступен.

Шаги настройки:

1. Перейдите в Системные настройки / AI Employees / LLM service (или откройте /admin/settings/ai/llm-services)

   

2. В списке предустановленных сервисов записи можно сортировать перетаскиванием, переключателем Enabled — включать и отключать

   

3. Для каждой записи, которую планируете использовать:

   • Нажмите Изменить
   • Замените API Key на ваш собственный ключ (получите его в личном кабинете соответствующего провайдера: OpenAI, Anthropic, Google AI Studio, DeepSeek, Qwen, Kimi и др.)
   • Если используется прокси или внутренний шлюз, скорректируйте Base URL
   • В Enabled Models оставьте только те модели, которые планируете использовать, остальные можно убрать

   

4. Нажмите Test flight внизу для проверки подключения; после успешной проверки нажмите Submit для сохранения

   

5. Неиспользуемые сервисы достаточно перевести в Disabled, удалять необязательно

Подробную настройку см. в Настройке LLM-сервиса.

#Часто задаваемые вопросы

#Подойдёт ли Community-версия? Не будет ли ошибок?

Подойдёт, ошибок не будет. «Менеджер резервных копий» стал open source начиная с v2.1.0-alpha.40 и может быть установлен в Community. В демо использованы некоторые Enterprise-плагины («Управление почтой», «Журнал аудита», «AI-сотрудники» и др.); в Community эти плагины отсутствуют, и соответствующие пункты меню просто не появятся, остальные модули не пострадают. Например, исчезнет раздел «Журнал аудита», но CRM, продажи, тикеты, проекты, активы, HR и другие основные модули будут работать как обычно.

#Какую версию выбрать после восстановления?

Рекомендуется последний alpha-full-образ (nocobase/nocobase:alpha-full). Образ full включает клиент БД и другие зависимости, что позволяет избежать ошибок восстановления из-за отсутствующих утилит.

#После восстановления не отображается логотип?

Логотип на демо-сайте привязан к домену, поэтому на локальной установке он не загружается. Зайдите в Системные настройки и загрузите собственный логотип.

#Ошибка при загрузке файлов (неверный ключ OSS)?

Преднастроенный в демо-резервной копии движок хранилища указывает на наш демонстрационный OSS, ключи которого наружу не публикуются. Перейдите в Управление плагинами / Менеджер файлов, установите «Local Storage (локальное хранилище)» в качестве хранилища по умолчанию и сохраните — после этого загрузка пойдёт штатно.

Подробности см. выше в разделе Движок хранилища файлов.

#Как переключить язык?

В единое решение уже включена локализация на 20+ языков (пространство имён nb_demo). После восстановления по умолчанию установлен китайский; для переключения зайдите в Системные настройки и включите нужный язык.

#Как делать инкрементальные обновления?

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