
Immich —— 自托管的照片与视频管理方案(来源:immich.app)
如果你在 NAS 上跑过照片管理,大概率听过或正在用 Immich——这个开源 Google Photos 替代品在过去两年迭代速度惊人,从 v1 一路冲到 v2,社区直接给它封了「NAS 上最好用的自建相册」标签。
昨天(6 月 23 日),Immich 团队发布了 v3.0.0-rc.2,这是 v3 大版本的第二个候选版,距离 rc.0 也就一周时间,修复了 11 个 bug,说明团队在冲刺稳定版了。
v3 到底多了什么?
我扒了一下发布说明,挑几个真正值得关注的变化说说。
1. 移动端非破坏编辑
这是呼声最高的功能之一。手机上的 Immich 应用现在可以直接编辑已上传的照片——裁剪、调色、滤镜——完全不修改原始文件。编辑结果作为派生文件存储,随时可以「恢复原图」。对于家庭相册这种场景,这个设计比 Google Photos 还良心。
2. 工作流引擎
Immich v3 新增了 Workflows & Plugins,一个拖拽式的自动化引擎。你可以设定触发器(新照片上传、人脸识别完成等),然后串联动作(自动打标签、转码、移动到特定相册、发送通知等)。如果你用过 Home Assistant 的自动化,对这个概念不会陌生。对于 NAS 用户来说,这意味着可以在相册上跑「上传 RAW 照片 → 自动生成缩略图 → 归档到年度文件夹」之类的自动化流水线。
Immich v3 与 v2 核心功能对比一览
3. HLS 实时转码播放
网页和移动端现在支持 HTTP Live Streaming 实时转码播放。简单说就是:大视频不用等下载完,点开就能看,后台边转码边缓存。这对那些用手机拍 4K 视频、在 NAS 上存了一大堆素材的人来说很实用。
4. 完整性检查和热力图
v3 新增了两个偏运维的功能:完整性检查任务可以扫描缺失文件、校验和异常和未跟踪文件;用户上传热力图能直观看到什么时候上传量最大。前者适合定期巡检,后者纯属好玩。
5. Android 可以当默认图库了
如果你主力机是 Android,v3 让 Immich 可以作为系统的默认图库和图片查看器使用。加上 Android 端新增的 Periodic Work Manager 后台同步,体验已经非常接近原生相册了。
6. OCR 和全路径搜索
移动端新增 OCR 识别,可以搜到图片里的文字;网页端支持按文件路径全路径搜索。这两个都是被用户反复要求的功能,v3 终于加上了。
升级注意事项
先说风险:v3 目前只是 Release Candidate,不是稳定版。如果你在主力使用,建议等稳定版再升。如果跟我一样有测试环境且做好了备份,可以提前尝鲜。
几个必须知道的破坏性变更:
- 旧版移动端 v2.x 很可能与 v3 服务器不兼容——iOS/Android 客户端都需要升级到 beta 版
pgvecto.rs支持已移除,改用pgvector- OAuth 的
issuerUrl现在必填,不安全配置被默认禁止 - PUT 路由全面废弃,改用 PATCH
- 验证框架从
class-validator切到 Zod
升级还是等待?根据你的场景做选择
升级方式很简单:改 .env 里的 IMMICH_VERSION=v3.0.0-rc.2(或 v3-rc),然后 docker compose pull && docker compose up -d 即可。
小结
从 v2 到 v3,Immich 最大的进步不是在修修补补,而是在功能架构上真正走向了「成熟的 NAS 应用」——工作流引擎、非破坏编辑、完整性检查,这些更像是一个基础设施级别产品该有的东西。结合它一贯的高频率迭代,v3 稳定版应该不会等太久。
如果你也在 NAS 上跑 Immich,可以关注一下 rc 系列的进展;等稳定版出来后,这次的升级值得一做。