最近看到 Immich 正式发布了 3.0 版本。作为我 NAS 上最重要的应用之一，自然第一时间关注了一下这次的大版本更新。
在升级之前，我先对比了一下 3.0 与我目前使用的 2.7 版本有哪些值得升级的新功能。
为什么升级？
官方这次 3.0 并不是一次简单的版本更新，而是一次比较大的功能升级。
比较吸引我的几个新特性包括：
- 内置 AI 修图（Image Editing），可以直接在 Immich 中完成简单的照片编辑，而不用再导出到其它软件。
- 更完善的照片管理能力，包括更好的浏览体验和细节优化。
- 搜索和 AI 能力持续增强，后续还有更多基于视觉模型的扩展空间。
- 底层架构升级，数据库向量引擎等组件进行了优化，为后续功能提供基础。
对于我来说，最有价值的还是修图功能。
平时大量照片都是手机自动同步到 NAS，偶尔需要裁剪、调整亮度或者做一些简单编辑，以前都需要下载到手机或电脑处理，再重新上传。现在如果能够直接在 Immich 中完成这些操作，整个照片管理流程会方便很多。
综合评估之后，我决定将家里的群晖 DS218+ 升级到 Immich 3.0。
我的环境
升级前的环境如下：
- NAS：Synology DS218+
- DSM 7
- Docker Compose 部署
- Immich 2.7.x
- PostgreSQL 官方数据库镜像
- 十万余张照片
- AI 人脸识别已完成
由于图库已经比较大，所以升级之前还是决定按照官方建议，先做好完整备份。
升级前检查
首先确认当前的 Docker Compose 配置。
检查发现，我使用的已经是官方新版 Compose 文件，数据库也已经采用了新的 VectorChord 镜像，因此官方升级文档中关于数据库迁移的步骤并不适用于我的环境，不需要再修改数据库配置。
随后备份了几个关键文件：
- PostgreSQL 数据库
docker-compose.yml.env
这样即使升级过程中出现问题，也能够快速恢复。
开始升级
升级过程实际上非常简单，基本按照官方文档执行即可。
首先拉取最新镜像：
docker compose pull随后重新启动容器：
docker compose up -d整个升级过程中唯一遇到的问题，是下载镜像速度比较慢。
Immich 镜像托管在 GitHub Container Registry（GHCR），其中 immich-server 镜像有一个三百多 MB 的 Layer 下载速度非常慢，在我的网络环境下等待了相当长时间才完成。
这一点需要一点耐心，或者提前为 NAS 配置代理。
升级后的第一次启动
镜像更新完成后，我立即访问：
http://NAS_IP:2283结果浏览器一直打不开。
第一反应还以为升级失败了。
随后开始逐步排查。
首先检查容器状态：
docker compose ps发现：
- PostgreSQL 正常
- Redis 正常
- Machine Learning 正常
- Immich Server 已经启动，但状态仍然是 health: starting
继续查看日志：
docker logs immich_server日志显示：
Running migrations同时可以看到系统正在处理十万多张照片对应的人脸索引和向量索引。
这才意识到，并不是升级失败，而是 Immich 3.0 第一次启动正在执行数据库迁移和索引检查。
对于只有两核 CPU 的 DS218+ 来说，这一步需要一定时间。
只要耐心等待，服务完成初始化后，健康状态会从 starting 变成 healthy，网页也会恢复正常访问。
总结
整个升级过程比想象中顺利，没有遇到兼容性问题，也不需要重新导入照片或重新识别人脸。
目前 Immich 已经逐渐从一个优秀的开源相册，发展成了一套功能越来越完整的个人照片管理平台。对于我来说，这次升级最大的期待，就是能够在 NAS 上直接完成一些日常修图操作，进一步减少照片在不同设备之间来回导出的流程。
