1. 在线更新是怎么工作的
V5.9.0 起支持后台在线更新，流程是：后台检查新版本 → 按当前操作系统和 CPU 架构匹配升级包 → 下载 → 覆盖文件并完成更新。
支持的组合：Darwin / Linux / Windows，amd64 / arm64。更新包按版本和平台分别发布，所以不会出现下错包但装上去的情况——匹配不上就是没有可用包。
2. 更新前必须满足的两个条件
- 服务器能访问版本发布地址。内网隔离环境拉不到包，需要在能出网的机器上下载后手工替换。
- 进程对程序目录有写权限。用 systemd 以低权限用户运行时尤其容易卡在这里——检查运行用户对程序目录和二进制文件是否有写权限。
3. 更新前必须做的备份（四样）
在线更新只替换程序文件，不会帮你备份数据。更新前请准备：
- 数据库备份（后台导出 JSON，或数据库自身的导出）
uploads 上传目录- 当前使用的主题目录
- 部署配置（数据库连接、反向代理、License 与域名绑定信息）
如果做过自定义改动（模板、接口、扩展字段、前端脚本），先把这些改动单独摘出来。直接覆盖会把自定义逻辑一起冲掉，这是升级丢东西最常见的原因。
4. 更新失败的常见原因
| 现象 | 原因 |
|---|
| 检查更新一直转圈或超时 | 服务器无法访问版本发布地址 |
| 下载中断、更新到一半失败 | 网络不稳，或磁盘空间不足 |
| 提示权限错误 | 运行用户对程序目录无写权限 |
| 找不到适配当前平台的包 | 当前 OS / 架构组合暂无发布包 |
5. 更新后站点异常的处理顺序
先回滚，再排查，不要边查边改把现场搞乱：
- 优先回滚模板和配置。模板异常是更新后最常见的问题——新版本可能调整了字段或废弃了旧写法。
- 再检查数据库迁移。确认迁移是否执行成功，表结构是否符合预期。
- 检查主题是否用了已废弃的字段或函数。旧模板调用新版本已移除的能力会直接报错。
- 清缓存并重新访问。确认前台缓存已刷新、旧页面已失效。
- 看日志里的模板渲染错误。渲染失败通常只在日志体现，页面可能表现为空白或残缺。
6. 验收清单
更新完成后不要直接认为结束，至少确认：
- 首页、栏目页、详情页、单页都能打开
- 导航、面包屑、搜索、下载按钮正常
- 后台各功能页正常
- 前台、接口、静态资源都正常
- 日志里没有新的模板渲染错误
7. 建议
- 不要在业务高峰期做大版本升级。
- 不要跳过数据库备份。
- 生产环境先在测试环境验证一遍，尤其是备份恢复流程。
- 大型数据恢复是同步操作，恢复期间不要同时进行内容编辑。