> 规范网页：https://docs.tensuu.com/功能模块详解/07_云端设置.html ｜ Markdown：/功能模块详解/07_云端设置.md ｜ 文档修订：2026.10.26

# 数据备份与校验

这篇帮你做什么：理解并使用群管家的**数据备份**——备份了什么、存在哪里、保留多久、怎样验证一份备份可用，以及为什么当前产品没有"一键恢复"。备份是误操作、升级失败或数据损坏后唯一的本地退路，**建议完成首次配置后立即手动备份一次并验证**。

操作入口在 **应用设置 → 高级设置** 的"数据备份"区域；本页是该功能的完整说明。高级设置页的其余运行参数（限速、队列、缓存、调试日志等）见[应用设置](16_应用设置.md)。

## 备份覆盖什么、不覆盖什么

| 内容 | 是否在备份里 |
| --- | --- |
| 应用数据库（群配置、名单、方案、规则、审计记录等业务数据） | 是 |
| 部署配置文件（端口、连接配置文件、backup.dir 等启动参数） | 否 |
| 程序文件与日志 | 否 |
| 群内图片等媒体文件 | 否 |
| QQ 等外部平台上的数据（群消息本体、成员关系） | 否，由平台持有 |

数据库中保存的凭据原文可能随数据一起进入备份文件，请保护备份目录的访问权限，不要公开分享备份文件。

## 备份是怎么产生的

- 备份是把应用数据库导出并压缩成一个 `.gz` 归档，附带 SHA-256 校验摘要，文件名形如 `backup_20260930_030000_xxxxxxxx.gz`。
- **手动备份**：点 **立即备份**，提示"备份已触发，正在后台执行"，到 **查看历史** 里等状态变"成功"。
- **自动备份**：由 **数据备份频率** 控制（每天 / 每周 / 每月 / 手动，默认每天）。改为"手动"后不再定时备份、也不补跑，只能用按钮触发。
- 手动与定时**互斥**：一个在执行时另一个会被拒绝（提示冲突，HTTP 409）。
- 服务停机错过定时周期后，默认每个周期最多**补跑 1 次**；持续关机则不会追补历史周期。
- 旧备份按保留天数自动清理；清理只删备份文件，不影响业务数据。

## 怎样验证一份备份可用

历史记录里状态为"成功"的备份可点 **验证**：

1. 校验通过提示"备份完整性校验通过"，"可恢复性"显示"可恢复（时间）"。
2. 校验内容包括归档能否解压、SHA-256 摘要是否一致、内容是否是本系统支持的数据库格式；"可恢复性"显示 **可恢复 / 不可恢复 / 不支持** 三种结果。
3. 这是**只读校验**：只检查备份文件本身，不会替换或还原正在使用的数据库。

验证通过的备份也不等于业务验收：它证明"文件本身完整可读"，不证明恢复后的数据满足你的需要。重要备份请复制到其他盘或设备——**备份只保存在本机**，磁盘损坏会同时损失数据和备份。

## 恢复备份：当前没有恢复入口 {#当前没有数据恢复入口}

备份恢复当前不能从控制台执行。控制台只提供备份、历史记录和完整性校验；"可恢复"是文件层面的判断，不是一键还原，也不证明已完成过恢复。

**本手册不提供经过验证的数据恢复、升级或迁移操作步骤。** 需要恢复时，请保留原程序、部署配置、数据库及自定义路径中的文件，把现有备份另存到安全位置，并联系维护者确认适用的恢复方案。不要自行解压覆盖数据库，不要把 **恢复默认** 当作数据恢复。

升级、迁移或大批量修改前应先备份并验证，但这只是准备工作；尚未明确恢复方案和版本兼容要求时，不要因为校验通过就覆盖原目录。

## 设置项参考

| 设置项 | 取值与默认 | 说明 |
| --- | --- | --- |
| 数据备份频率 | 每天（默认）/ 每周 / 每月 / 手动 | 在高级设置页修改，点 **保存** 后生效；"手动"＝不注册定时任务、不补跑 |
| 立即备份 | 按钮 | 后台执行，与定时备份互斥（409） |
| 查看历史 / 验证 | 按钮 | 历史默认显示最近 20 条；**验证** 只读 |

以下参数不在界面修改，由部署配置决定；改过配置时以实际值为准：

| 部署配置项 | 默认值 | 含义 |
| --- | --- | --- |
| 执行时间 | 本地时间 03:00 | 定时备份在一天中的执行时刻 |
| 保留天数 | 30 天 | 超过的 `.gz` 备份自动清理 |
| 停机补跑 | 1 次 | 错过周期后每个周期最多补跑一次 |
| 备份目录 `backup.dir` | 程序运行目录下 `backups\` | 程序需有创建目录和写入文件的权限；不要把默认值当成自定义后的实际位置 |

## 没成功先检查什么

- 备份失败或没有记录：稍等几秒刷新历史（备份在后台执行）；确认程序目录可写、磁盘有空间。
- 一直"执行中"：到历史里看错误信息列；备份写盘需要备份目录可用。
- 手动触发被拒：已有备份正在执行（409），等当前备份结束再试。
- 验证显示"不可恢复"或"不支持"：文件可能损坏或不是本系统格式；重新备份一份，不要依赖该文件做恢复准备。

## 和其他页面的关系

- 备份频率、立即备份、历史与验证按钮所在的运行参数页见[应用设置](16_应用设置.md)。
- 应用运行日志、审计日志的查询见[应用日志](17_应用日志.md)。
- [使用指南](../快速入门指南/使用指南.md)是功能入口地图，不提供升级、迁移或恢复操作步骤；相关准备与限制见上方[恢复备份](#当前没有数据恢复入口)。