备份与恢复

概述

平台内置「备份恢复」功能，把配置库中的业务数据与关键文件目录，按同一时间点打成一个 zip 备份包，并支持在页面上预检、恢复。仅管理员可用。

备份包只覆盖平台数据。程序本身（jar）、数据库连接配置、JDBC 驱动、插件等不在包内，需要另行备份，见下文「需要自行备份的对象」。

功能入口

「系统 > 智能运维 > 备份恢复」。Sight Wall 中入口同名。页面顶部的按钮：「立即备份」「上传备份包」「备份设置」「刷新」。列表列：时间、类型（手动、自动、恢复前、上传、已发现）、备份包、大小、版本、schema、状态、操作人；行操作：下载、恢复、删除。

备份包内容

包含

不包含

注意：备份包内含数据源凭据、AI 配置的密钥等敏感信息，拿到备份包基本等于拿到系统。下载前会弹出确认，下载操作会写入审计日志。请按机密文件保管。

操作步骤

手动备份

1. 打开「备份恢复」页，点击「立即备份」。
2. 页面显示任务进度，依次为「导出配置库」「打包文件资产」「写清单」。
3. 完成后备份包出现在列表中，存放在备份目录（默认 <程序目录>/data/backups）。

备份先写入 .tmp 文件，完成后改名，因此列表中不会出现不完整的包。同一时间只能运行一个备份或恢复任务。

自动备份

系统内置一个名为「自动备份」的系统任务，属于分组「系统任务」，默认每天凌晨 1 点运行（Cron 表达式 0 0 1 * * ?），创建时启用。在「系统 > 定时调度」页可以查看它、切换「启用」状态或点击「执行」立即运行；系统任务不能编辑，也不能删除。

集群下该任务只会在一个节点执行。如果备份或恢复任务正在运行，本次自动备份会被跳过。自动备份产生的包在列表中类型显示为「自动」。

备份设置（保留策略）

点击「备份设置」：

三项中任一项超限就删除最早的包。保存后立即执行一次清理。恢复前自动生成的兜底包单独保留 3 份，不占上述配额。类型为「上传」和「已发现」的包是人主动放入的，不受保留策略自动清理。

备份包会增长到很大，系统盘放不下时，把 app.backup-dir 指向单独的数据盘，见 配置项参考。

下载与上传备份包

• 「下载」：确认提示「备份包含系统凭据，请按机密文件保管。确认下载？」后下载 zip。
• 「上传备份包」：选择 zip 文件上传。上传只是把包收进列表，不会执行恢复。文件校验清单后入账，缺少清单的 zip 会被拒绝，提示这不是本产品的备份包。备份包以原始数据流上传，不受表单上传大小限制，但会先检查备份目录剩余空间。

恢复

1. 在列表中找到状态成功的备份包，点击「恢复」。
2. 弹出「恢复备份」对话框，程序对该包做预检，逐项显示结果，见下表。
3. 有「阻断」项时无法继续；有「警告」项时需要勾选「我已知晓，仍要继续」。
4. 输入备份文件名以确认，点击「确认恢复」。预检令牌有效期 30 分钟，超时需要重新预检。
5. 恢复期间页面显示任务进度。系统进入维护模式，普通用户暂时无法访问。
6. 恢复完成后，阅读「恢复完成」对话框中的提示，重启服务（必须），再验证数据。

恢复流程依次为：恢复前自动备份当前状态（生成兜底包）、进入维护模式、恢复配置库、恢复文件资产、收尾。文件目录采用改名换入：原目录被改名为 .bak-<时间戳> 后再解包，失败时会改回。

恢复完成后必须重启服务，因为字体、驱动、插件、AI 配置与缓存都还在内存中。

注意：恢复会用备份包整体覆盖当前的配置库业务数据与文件资产，不可撤销。开始前自动生成的兜底包可用于回退。

恢复预检项

退出维护模式

恢复成功后系统自动退出维护模式。恢复失败时系统会保持在维护模式，因为此时库的状态不确定。页面顶部会显示「系统处于维护模式」提示，确认数据无误后点击「退出维护模式」。维护模式下管理员仍能登录并使用备份恢复页。

需要自行备份的对象

换机重建清单

1. 在新机器上安装同一版本的产品，JDK 21+，准备好配置库（新库或还原后的库）。
2. 设置与源机一致的加密密钥环境变量。
3. 通过初始化向导创建配置库结构与管理员，见 初始化向导与数据库准备。
4. 在「备份恢复」页点击「上传备份包」，把备份包收进列表，再执行恢复。备份目录里手工拷入的包，只有在一次恢复收尾时才会被自动对账补进列表，因此请优先使用上传。
5. 复制 data/drivers/ 与 data/plugins/，重启服务。
6. 授权因环境变化会失效，按 授权与许可 重新获取环境信息并导入新授权。

注意事项

提示：定期演练恢复流程，确认备份包可用且预检能通过。

注意：跨版本恢复要求迁移链一致。用旧版本生成的包恢复到升级后的系统，会在预检阶段被阻断。

相关文档

• 升级与变更管理
• 配置项参考
• 集群与高可用
• 授权与许可