备份与恢复
适用读者：生产环境运维人员
需要备份的对象
| 对象 | 内容 | 恢复价值 |
|---|---|---|
| Halo 数据库/Extension Store | 文章、自定义 Extension、配置对象 | 必须 |
ai-suite-configmap | AI 智能套件业务配置 | 必须 |
ai-suite-usage-YYYY-MM-DD | 最近 30 天模型用量与调用明细 | 按审计需要 |
| AI Foundation 配置 | 模型供应商、模型资源与密钥 | 必须，按 AI Foundation 策略备份 |
| Halo 数据目录 | Lucene 索引、插件运行数据 | 建议 |
| 插件 JAR | 可回滚版本 | 建议 |
| Nginx/CDN 配置 | SSE 和真实 IP 设置 | 建议 |
ChatLog、EvaluationDataset、EvaluationRunRecord、IntentRoute 和 AgentTaskRecord 都属于 Halo 自定义 Extension，应随 Halo 数据一起备份。ai-suite-configmap 和按日期保存的用量 ConfigMap 同样由 Halo Extension Store 持久化；单独列出是为了恢复时便于核对，不代表需要绕过 Halo 数据库另做一份孤立副本。
索引是否必须备份
Lucene 索引可以从文章重新生成，因此不是唯一事实源。但文章多、Embedding 昂贵或恢复时间要求严格时，应备份数据目录以缩短恢复时间。
恢复顺序
- 恢复 Halo 数据库和数据目录。
- 安装匹配版本的插件 JAR。
- 恢复 AI 智能套件配置、需要保留的用量 ConfigMap 与 AI Foundation 模型配置。
- 启用插件并确认
STARTED。 - 检查自定义 Extension 和索引统计。
- 若索引不可读或不一致，执行全量重建。
- 验证匿名权限、SSE、问答和后台页面。
安全
- 包含模型密钥的 AI Foundation 备份必须加密，限制访问并记录恢复操作。
- 不要把 API Key 放进 Git、普通工单或未脱敏截图。
- 定期执行恢复演练；只有成功恢复过的备份才算可靠。