#生产环境备份说明

#一、功能入口

管理员登录系统后，进入：

系统设置 → 备份管理器 → 备份列表

具备相应管理权限的账号可以：

• 手动创建备份
• 查看备份时间、文件大小和执行状态
• 下载或删除备份文件
• 使用历史备份还原系统
• 上传本地备份文件进行还原
• 配置自动备份策略

#二、备份范围

系统采用应用级全量备份，范围如下：

补充说明：

• 外部 MySQL、PostgreSQL、MongoDB 等数据源需要采用对应数据库的备份方案单独保护。
• 云存储文件由云存储平台负责持久化，系统备份仅保留相关文件记录。
• 本地文件备份只包含已经登记在系统文件表中的有效文件。

#三、备份文件保存位置

备份完成后会生成 .nbdata 格式的文件，例如：

backup_20260721_000621_7907.nbdata

生产环境默认保存在应用服务器的持久化存储卷中：

storage/backups/main/

Docker 容器内对应位置为：

/app/nocobase/storage/backups/main/

宿主机上的具体绝对路径取决于生产环境部署目录，通常为：

<系统部署目录>/storage/backups/main/

管理员也可以在“备份列表”中下载备份文件，并将其保存至其他服务器或存储介质。

如配置了云存储同步，系统会在本地备份成功后，将备份文件同步到指定云存储。

#四、生产环境备份策略

建议采用以下备份策略：

仅将备份保存在应用服务器本机存在一定风险。服务器磁盘损坏时，业务数据和备份文件可能同时丢失，因此生产环境应至少保留一份异地副本。

#五、恢复说明

系统支持两种恢复方式：

1. 在备份列表中选择历史备份进行还原。
2. 上传本地 .nbdata 文件进行还原。

恢复属于全量覆盖操作，会将当前主数据库替换为备份时的数据状态。执行前应确认：

• 已对当前生产数据创建新备份。
• 备份文件来源可靠、备份时间符合要求。
• 当前系统版本与备份版本兼容。
• 数据库类型、Schema、表名前缀等配置一致。
• 已提前安排维护窗口。
• 已取得正确的还原密码。

恢复期间系统可能暂时不可用。若设置了还原密码，密码遗失后将无法使用该备份恢复。

#六、责任边界

系统内置备份功能负责保护主数据库和已配置纳入备份的本地文件。以下内容需要运维团队另行制定备份方案：

• 外部业务数据库
• MongoDB 等独立数据库
• 对象存储或云存储文件
• 服务器配置和环境变量
• SSL 证书、域名及反向代理配置
• 应用镜像、插件安装包和定制代码

建议定期检查备份文件，并进行恢复演练，确保备份数据能够正常使用。