---
title: "CRM 2.0 如何安装"
description: "CRM 2.0 安装部署：使用已开源的备份管理器插件一键还原，需 PostgreSQL 16，DB_UNDERSCORED 不能为 true。"
keywords: "CRM 安装,备份还原,备份管理器,PostgreSQL,NocoBase"
---

# 如何安装

> 当前版本采用**备份还原**的形式进行部署。在后续版本中，我们可能会更换为**增量迁移**的形式，以便于将解决方案集成到您已有的系统中。

> **备份管理器插件现已开源**：还原方案所需的"[备份管理器](https://docs-cn.nocobase.com/handbook/backups)"插件已经开源，所有版本（含社区版）均可使用。推荐直接通过该插件进行一键还原。

在开始之前，请确保：

- 您已经有了一个基础的 NocoBase 运行环境。关于主系统的安装，请参考更详细的[官方安装文档](https://docs-cn.nocobase.com/welcome/getting-started/installation)。
- NocoBase 版本 **v2.1.0-beta.2 及以上**
- 您已经下载了 CRM 系统的备份文件：[nocobase_crm_v2_backup_260523.nbdata](https://static-docs.nocobase.com/nocobase_crm_v2_backup_260523.nbdata)

**重要说明**：
- 本方案基于 **PostgreSQL 16** 数据库制作，请确保您的环境使用 PostgreSQL 16。
- **DB_UNDERSCORED 不能为 true**：请检查您的 `docker-compose.yml` 文件，确保 `DB_UNDERSCORED` 环境变量未设置为 `true`，否则会与方案备份冲突导致还原失败。

---

## 使用备份管理器还原

这种方式通过 NocoBase 内置的"[备份管理器](https://docs-cn.nocobase.com/handbook/backups)"插件进行一键还原，操作最简单。该插件现已开源，所有版本（含社区版）均可使用。

### 核心特点

* **优点**：
  1. **操作便捷**：在 UI 界面即可完成，可以完整地还原包括插件在内的所有配置。
  2. **完整还原**：**能够还原所有系统文件**，包括模板打印文件、表中文件字段上传的文件等，确保功能完整性。
* **局限**：
  1. **环境要求严格**：要求您的数据库环境（版本、大小写敏感设置等）与我们制作备份时的环境高度兼容。
  2. **插件依赖**：如果方案中包含了您本地环境中没有的商业插件，还原会失败。

### 操作步骤

**第 1 步：【强烈建议】使用 `full` 镜像启动应用**

为了避免因缺少数据库客户端而导致的还原失败，我们强烈建议您使用 `full` 版本的 Docker 镜像。它内置了所有必需的配套程序，让您无需进行额外配置。

拉取镜像的指令示例：

```bash
docker pull nocobase/nocobase:beta-full
```

然后使用此镜像启动您的 NocoBase 服务。

> **注**：若不使用 `full` 镜像，您可能需要在容器内手动安装 `pg_dump` 数据库客户端，过程繁琐且不稳定。

**第 2 步：开启"备份管理器"插件**

1. 登录您的 NocoBase 系统。
2. 进入 **`插件管理`** 。
3. 找到并启用 **`备份管理器`** 插件。

**第 3 步：从本地备份文件还原**

1. 启用插件后，刷新页面。
2. 进入左侧菜单的 **`系统管理`** -> **`备份管理器`**。
3. 点击右上角的 **`从本地备份还原`** 按钮。
4. 将下载的备份文件拖拽到上传区域。
5. 点击 **`提交`**，耐心等待系统完成还原即可，这个过程可能需要几十秒到几分钟不等。

### 注意事项

* **数据库兼容性**：这是此方法最关键的一点。您的 PostgreSQL 数据库**版本、字符集、大小写敏感设置**必须与备份源文件匹配。特别是 `schema` 名称必须一致。
* **商业插件匹配**：请确保您已拥有并开启了方案所需的所有商业插件，否则还原会中断。

---

## 常见问题

### 专业版能用吗？会不会报错？

可以直接用，不会报错。Demo 中使用了部分企业版插件（如邮件管理、审计日志等），专业版缺少这些插件时，对应的功能入口不会显示，但**不影响系统其他功能**。例如邮件入口会消失，但线索、商机、订单等核心模块完全正常。

### 还原后版本应该选哪个？

推荐使用最新的 `beta-full` 版本镜像（如 `nocobase/nocobase:beta-full`）。`full` 镜像内置了数据库客户端等依赖，避免还原时因缺少工具而失败。

### 还原后 Logo 不显示？

官网 Demo 的 Logo 配置了域名限制，本地域名无法加载。进入 **系统设置** 重新上传自己的 Logo 即可。

### 增量升级怎么办？

目前版本升级为全量替换，自定义修改会被覆盖。升级前务必备份。增量迁移方案正在规划中，会优先支持专业/企业版。社区版由于缺少迁移管理插件，暂时较难支持。

希望本教程能帮助您顺利部署 CRM 2.0 系统。如果您在操作过程中遇到任何问题，欢迎随时与我们联系！

---

*Last updated: 2026-04-02*
