#如何安装

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

为了让您能够快速、顺畅地将工单方案部署到您自己的 NocoBase 环境中，我们提供了两种还原方式。请根据您的用户版本和技术背景选择最适合您的一种。

在开始之前，请确保：

• 您已经有了一个基础的 NocoBase 运行环境。关于主系统的安装，请参考更详细的官方安装文档。
• NocoBase 版本 2.0.0-beta.5 及以上
• 您已经下载了工单系统的相应文件：
  • 备份文件：nocobase_tts_alpha_backup_260107_01.nbdata - 适用于方法一
  • SQL文件：nocobase_tts_alpha_sql_inserts_260107_01.zip - 适用于方法二

重要说明：

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

#方法一：使用备份管理器还原（推荐专业/企业版用户）

这种方式通过 NocoBase 内置的"备份管理器"（专业/企业版）插件进行一键还原，操作最简单。但它对环境和用户版本有一定要求。

#核心特点

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

#操作步骤

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

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

拉取镜像的指令示例：

docker pull nocobase/nocobase:beta-full

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

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

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

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

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

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

#注意事项

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

#方法二：直接导入 SQL 文件（通用，更适合社区版）

这种方式通过直接操作数据库来还原数据，绕过了"备份管理器"插件，因此没有专业/企业版插件的限制。

#核心特点

• 优点：
  1. 无版本限制：适用于所有 NocoBase 用户，包括社区版。
  2. 高兼容性：不依赖应用内的 dump 工具，只要能连接数据库即可操作。
  3. 高容错性：如果方案包含您没有的商业插件，相关功能将不会被启用，但不会影响其他功能的正常使用，应用可成功启动。
• 局限：
  1. 需要数据库操作能力：需要用户具备基础的数据库操作能力，例如如何执行一个 .sql 文件。
  2. 系统文件丢失：此方法会丢失所有系统文件，包括模板打印文件、表中文件字段上传的文件等。

#操作步骤

第 1 步：准备一个干净的数据库

为您即将导入的数据准备一个全新的、空的数据库。

第 2 步：将 .sql 文件导入数据库

获取下载的数据库文件（通常是 .sql 格式），并将其内容导入到您上一步准备好的数据库中。执行方式有多种，取决于您的环境：

• 选项 A：通过服务器命令行（以 Docker 为例） 如果您使用 Docker 安装 NocoBase 和数据库，可以将 .sql 文件上传到服务器，然后使用 docker exec 命令来执行导入。假设您的 PostgreSQL 容器名为 my-nocobase-db，文件名为 ticket_system.sql：

  # 将 sql 文件复制到容器内
  docker cp ticket_system.sql my-nocobase-db:/tmp/
  # 进入容器执行导入指令
  docker exec -it my-nocobase-db psql -U your_username -d your_database_name -f /tmp/ticket_system.sql

• 选项 B：通过远程数据库客户端 如果您的数据库暴露了端口，可以使用任何图形化数据库客户端（如 DBeaver, Navicat, pgAdmin 等）连接到数据库，新建一个查询窗口，将 .sql 文件的全部内容粘贴进去，然后执行即可。

第 3 步：连接数据库并启动应用

配置您的 NocoBase 启动参数（如环境变量 DB_HOST, DB_PORT, DB_DATABASE, DB_USER, DB_PASSWORD 等），使其指向您刚刚导入了数据的数据库。然后，正常启动 NocoBase 服务。

#注意事项

• 数据库权限：此方法要求您拥有可以直接操作数据库的账号和密码。
• 插件状态：导入成功后，系统中包含的商业插件数据虽然存在，但如果您本地未安装并启用对应插件，相关功能将无法显示和使用，但这不会导致应用崩溃。

#总结与对比

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