安全升级

升级会自动运行兼容数据库迁移，但这不是跳过备份的理由。配置 schema、容器挂载、Desktop 资源和派生工具也可能变化。

升级前

1. 阅读目标版本发布说明和已知问题。
2. 创建数据库快照，并在宿主机层把 .sqlite3 与配套 manifest 一起复制到独立位置；界面下载的单个 SQLite 只作补充副本。
3. 确认近期媒体备份可读。
4. 记录当前版本、配置、镜像标签、挂载和 Lumen 版本。
5. 等待关键导入和恢复操作完成。

Desktop

使用与稳定或 beta 更新频道一致的构建。更新后先检查 Desktop 主机、Server 和存储位置状态，再打开全部自动任务。

Docker

下载并验证目标 Release 的 Server bundle。它通过 .env 固定 OCI image digest；升级时保留上一份 bundle、旧 digest 和升级前数据库快照，并确认 Compose、挂载与完整配置仍兼容。不要把 latest 的变化当作可审计升级计划。

升级后

验证登录、资源库在线、少量媒体播放、队列、数据库快照和可选能力。发现问题时停止新写入并按回退处理。