数据备份与校验
这篇帮你做什么：理解并使用群管家的数据备份——备份了什么、存在哪里、保留多久、怎样验证一份备份可用，以及为什么当前产品没有"一键恢复"。备份是误操作、升级失败或数据损坏后唯一的本地退路，建议完成首次配置后立即手动备份一次并验证。
操作入口在 应用设置 → 高级设置 的"数据备份"区域；本页是该功能的完整说明。高级设置页的其余运行参数（限速、队列、缓存、调试日志等）见应用设置。
备份覆盖什么、不覆盖什么
| 内容 | 是否在备份里 |
|---|---|
| 应用数据库（群配置、名单、方案、规则、审计记录等业务数据） | 是 |
| 部署配置文件（端口、连接配置文件、backup.dir 等启动参数） | 否 |
| 程序文件与日志 | 否 |
| 群内图片等媒体文件 | 否 |
| QQ 等外部平台上的数据（群消息本体、成员关系） | 否，由平台持有 |
数据库中保存的凭据原文可能随数据一起进入备份文件，请保护备份目录的访问权限，不要公开分享备份文件。
备份是怎么产生的
- 备份是把应用数据库导出并压缩成一个
.gz归档，附带 SHA-256 校验摘要，文件名形如backup_20260930_030000_xxxxxxxx.gz。 - 手动备份：点 立即备份，提示"备份已触发，正在后台执行"，到 查看历史 里等状态变"成功"。
- 自动备份：由 数据备份频率 控制（每天 / 每周 / 每月 / 手动，默认每天）。改为"手动"后不再定时备份、也不补跑，只能用按钮触发。
- 手动与定时互斥：一个在执行时另一个会被拒绝（提示冲突，HTTP 409）。
- 服务停机错过定时周期后，默认每个周期最多补跑 1 次；持续关机则不会追补历史周期。
- 旧备份按保留天数自动清理；清理只删备份文件，不影响业务数据。
怎样验证一份备份可用
历史记录里状态为"成功"的备份可点 验证：
- 校验通过提示"备份完整性校验通过"，"可恢复性"显示"可恢复（时间）"。
- 校验内容包括归档能否解压、SHA-256 摘要是否一致、内容是否是本系统支持的数据库格式；"可恢复性"显示 可恢复 / 不可恢复 / 不支持 三种结果。
- 这是只读校验：只检查备份文件本身，不会替换或还原正在使用的数据库。
验证通过的备份也不等于业务验收：它证明"文件本身完整可读"，不证明恢复后的数据满足你的需要。重要备份请复制到其他盘或设备——备份只保存在本机，磁盘损坏会同时损失数据和备份。
恢复备份：当前没有恢复入口
备份恢复当前不能从控制台执行。控制台只提供备份、历史记录和完整性校验；"可恢复"是文件层面的判断，不是一键还原，也不证明已完成过恢复。
本手册不提供经过验证的数据恢复、升级或迁移操作步骤。 需要恢复时，请保留原程序、部署配置、数据库及自定义路径中的文件，把现有备份另存到安全位置，并联系维护者确认适用的恢复方案。不要自行解压覆盖数据库，不要把 恢复默认 当作数据恢复。
升级、迁移或大批量修改前应先备份并验证，但这只是准备工作；尚未明确恢复方案和版本兼容要求时，不要因为校验通过就覆盖原目录。
设置项参考
| 设置项 | 取值与默认 | 说明 |
|---|---|---|
| 数据备份频率 | 每天（默认）/ 每周 / 每月 / 手动 | 在高级设置页修改，点 保存 后生效；"手动"＝不注册定时任务、不补跑 |
| 立即备份 | 按钮 | 后台执行，与定时备份互斥（409） |
| 查看历史 / 验证 | 按钮 | 历史默认显示最近 20 条；验证 只读 |
以下参数不在界面修改，由部署配置决定；改过配置时以实际值为准：
| 部署配置项 | 默认值 | 含义 |
|---|---|---|
| 执行时间 | 本地时间 03:00 | 定时备份在一天中的执行时刻 |
| 保留天数 | 30 天 | 超过的 .gz 备份自动清理 |
| 停机补跑 | 1 次 | 错过周期后每个周期最多补跑一次 |
备份目录 backup.dir | 程序运行目录下 backups\ | 程序需有创建目录和写入文件的权限；不要把默认值当成自定义后的实际位置 |
没成功先检查什么
- 备份失败或没有记录：稍等几秒刷新历史（备份在后台执行）；确认程序目录可写、磁盘有空间。
- 一直"执行中"：到历史里看错误信息列；备份写盘需要备份目录可用。
- 手动触发被拒：已有备份正在执行（409），等当前备份结束再试。
- 验证显示"不可恢复"或"不支持"：文件可能损坏或不是本系统格式；重新备份一份，不要依赖该文件做恢复准备。