备份与恢复
跟着示例在 Manager 中完成一次备份和恢复。
入口：Manager → 集群 → 备份。不需要修改 wukongim.toml。
备份实操
先不要开启“自动备份”，填写下面的示例值：
| 设置 | 示例值 |
|---|---|
| 备份频率 | 每天凌晨 1:00 |
| 时区 | Asia/Shanghai |
| 存储位置 | 共享文件存储 |
| 保留备份数 | 7 |
| 每节点工作数 | 1 |
| 超时 | 12 小时 |
多节点必须共享备份目录
所有节点的 data_dir/backup-repository 必须指向同一个共享存储。没有共享存储时，请选择 OSS、COS 或 S3。
- 点击“保存设置”，看到“备份设置已保存”。
- 点击“测试存储”，等“存储验证”变成“已验证”。
- 点击“立即备份”，在“当前任务”等待
256/256 Hash Slots。 - 在“最近任务”确认结果为“成功”。
- 在“备份文件”中点击“验证”；成功后点击“保护”。
完成标准： 归档状态为 healthy，页面提示“备份文件验证成功”。需要定时执行时，再开启“自动备份”并保存。
恢复实操
恢复会覆盖当前数据
归档完成时间之后的消息和变更会丢失，客户端也会断开。只在维护窗口执行。
开始前确认：所有节点 /readyz 返回 200、没有其他管理任务、归档刚刚验证成功，并且每个节点有“当前数据 + 归档逻辑大小 × 2 + 1 GiB”的可用空间。
- 在目标归档右侧点击“恢复”。
- 核对页面显示的集群、归档时间和大小。
- 输入当前管理员密码。
- 按提示输入
RESTORE <归档 ID>，点击“开始恢复”。 - 等任务完成；期间不要关闭节点或执行其他变更。
- 重新登录 Manager，确认“最近任务”为“成功”，且每个节点
/readyz返回 200。 - 检查历史消息，再测试登录、消息收发、重连、Webhook 和插件；全部正常后恢复流量。
不能恢复到另一个集群
归档只能恢复到创建它的同一个集群，不能用于新集群导入或 v2 到 v3 迁移。
失败时保留任务和错误信息，不要反复点击恢复。备份需要 cluster.backup:w；恢复必须单独授予 cluster.restore:w。WuKongIM 不加密归档内容，请开启存储侧加密。