升级与维护

标准升级流程

Windows Linux

• service install 是幂等的，可安全重复执行 —— 它本身就是「升级」动作。
• 升级后必须重置自检基线（新二进制与旧基线必然不一致），否则持续触发篡改告警。
• 数据（SQLite / 证书 / 日志 / 备份）在数据目录中，升级不影响。

三层保活说明

层级	机制	覆盖场景
模块级	进程内 panic 捕获 + 指数退避自动重启（连续 5 次才停用）	单个功能 goroutine 崩溃
进程级	main / guard 每 2 秒互探，3 次失联自动拉起对方	任一进程被杀 / 假死
系统级	Windows SCM 故障恢复（5s/10s/30s）；systemd Restart=always	进程退出 / 开机自启

面板内的「保存端口 / 手动重启」走优雅重启：先拉新进程成功再停旧进程（HTTP 优雅关闭 + WAL checkpoint），失败则保持旧进程，无空窗。

日常维护清单

周期	动作
每日	查看总览页告警卡与看门狗上报记录（或接好 Webhook 后看推送）
每周	检查「系统日志 → 上报记录」失败率；核对封禁列表是否有误封；MySQL 备份记录是否全部成功
每月	检查磁盘使用趋势（系统指标）；核对证书有效期 qidun cert info；回顾审计日志中的敏感操作
按需	缓存目录清理；FIM 合法变更后重置指纹；升级后重置自检基线

应急手册

忘记 admin 密码

面板被爆破软锁 / IP 被封（包括蜜罐误触）

证书体系异常 / 需要全部重来

面板完全不可用

• 检查双服务状态：qidun service status；不通则 sc start / systemctl start 或直接 qidun service install 修复。
• 看日志：<数据目录>/logs/qidun-main.log。
• 确认客户端证书：qidun cert check（Windows 会逐项给出 ✅ / ❌）。
• 端口冲突：改用 run --port 531 临时拉起排查。

想彻底停用守护

WebUI「系统设置 → 守护服务」关闭双进程守护开关；受控重启请同时停止两个进程（或关闭守护开关），避免一方把另一方拉起。

磁盘被日志 / 备份占满

• 日志按角色单文件追加，必要时轮转归档（手动剪切旧内容）。
• MySQL 备份超限会自动按保留份数清理；紧急时直接删除 mysql-backups/ 下旧文件。
• 缓存类目录交给缓存目录模块按天数清理。

数据备份与迁移

• 整机备份：停止两个服务后打包数据目录即可（SQLite + certs + mysql-backups + logs）。
• 仅数据库：备份 qidun.db（建议先停服务保证 WAL 完整 checkpoint；运行中拷贝需连同 -wal / -shm 文件）。
• 迁移到新机器：新机安装同版本 → 停服务 → 覆盖数据目录 → service install → 客户端证书不变（CA 随数据目录迁移，老证书继续可用）。
• 数据库文件：保留期清理只释放空闲页供复用，库文件不会自动变小；可在「系统设置 → 数据保留」点压缩数据库 (VACUUM) 按需物理收缩（会短暂锁库、需临时磁盘空间，建议低峰执行）。WAL 由自动 checkpoint 与清理后 wal_checkpoint(TRUNCATE) 回收。
• 数据保留默认 90 天（可在「系统设置 → 数据保留」调整 7–3650 天），后台每日分批清理超期数据，历史数据无需人工瘦身。