Immich 恢复数据库：从网页界面把照片库救回来的两条路径

恢复数据库听起来吓人，实际是全程网页界面的引导式操作。Immich 提供两条路径，取决于你的出发点：现有安装坏了要修，或新装机器要从旧库起步。

路径一：在现有安装里恢复

适用：数据库损坏、误操作、升级翻车，但服务器还活着。

1. Administration（管理）→ Maintenance（维护）；
2. 展开 Restore database backup（恢复数据库备份）；
3. 列表里会显示可用的备份（带版本号和创建时间——所以 数据库备份 的保留策略很重要）；
4. 选中一份，点 Restore，确认。

执行时 Immich 会进入维护模式：先清空当前数据库，再灌入备份内容。听起来危险，但有两道保险——恢复前自动创建一个还原点，恢复失败可以回滚；恢复界面同时显示各存储目录的完整性检查（library、thumbs、upload 是否可读写、文件数量是否对得上），正式恢复前先看一眼。

版本兼容提示：备份列表会标注该转储是否与当前版本兼容。跨大版本恢复（比如拿 v2 时代的备份救 v3 的库）前，先看官方文档的兼容说明。

路径二：全新部署从备份起步

适用：换机器、重装系统、迁移到 NAS。

1. 新机器按标准流程 装好 Immich，但先不要注册账号；
2. 把旧实例 UPLOAD_LOCATION 下的数据目录整体搬过来：backups、library、profile、thumbs、upload、encoded-video（用了 外部库 的还要对齐挂载结构）；
3. docker compose up -d 启动，欢迎页上选择 Restore from backup（从备份恢复）；
4. 系统进入维护模式，完成完整性检查后选择备份（或直接上传一个 .sql.gz 文件——上传的会带 uploaded- 前缀出现在列表里）；
5. 恢复完成后，老库的用户、照片、相册、人脸原样回归。

恢复完成后的检查单

• 登录原账号，确认照片数量对得上（统计页看总量）；
• 抽查时间线日期分组、人物页命名是否健在——这些都在数据库里，恢复成功即回归；
• 若有 外部库，确认挂载路径一致；
• 跑一遍 任务队列 看有没有遗留的失败任务。

恢复演练：低成本高回报

官方 FAQ 式的忠告，也是灾难恢复的通用常识：没演练过的备份不算备份。找个周末，拿一台旧机器或虚拟机，用路径二完整走一遍「新装 + 恢复」，你会同时验证三件事：备份真的在生成、文件真的搬得动、恢复流程真的会操作。两小时的投入，换来事故之夜的从容。

恢复是数据的最后防线；防线的上游还有一层——平时到底该备份哪些东西，见 3-2-1 备份清单。