如果你在用 NAS 自托管照片，Immich 这个名字应该不陌生。这个开源项目在过去两年里已经成了 Google Photos 自托管替代方案的代名词——GitHub 9 万多 star，迭代快得跟不要钱似的。
6 月 9 日，Immich 团队放出了 v3.0.0 的首个发布候选版本（RC），目前已经迭代到 rc.2。这是 Immich 历史上第一次用 RC 机制，而不是像以前那样直接甩一个正式版然后连修三四天 bug。从 changelog 的长度来看，这个版本也确实值得用 RC——新增功能、破坏性变更、bug 修复加起来有好几百条。
核心新功能
移动端非破坏性编辑
这是 v3 最让人期待的功能。之前 Web 端 v2.5 就有了图片编辑（裁剪、旋转、调色），但手机端只能看不能改。v3 把编辑能力搬到了移动端，而且不修改原始文件——编辑信息存在数据库里，随时可以回溯或撤销。
更实用的是，你在手机上修过的图，打开 Web 端可以继续调整。编辑状态跨平台同步。如果你经常在手机和电脑之间切换管理照片，这个功能会大幅减少重复操作。
工作流（Workflows）——预览版
v3 引入了一个拖拽式工作流构建器，位置在 Web 端 Utilities → Workflows。你可以把触发器、条件过滤器、动作串起来，实现媒体库自动化。
举个例子：
- 当有新照片上传时 → 如果地理位置在某个范围内 → 自动添加到指定相册
- 检测到特定人脸 → 打上标签 → 分享给家庭成员
- 按拍摄日期和评分 → 自动归档旧照片
工作流支持两种编辑模式：可视化拖拽和 JSON 编辑器。JSON 格式可以导出分享，方便别人直接导入你的自动化配置。目前还是预览版，但框架已经搭好了，后续应该会有更多触发器和动作上线。
HLS 实时视频转码
以前的 Immich，上传视频后要等后台慢慢转码才能在浏览器里流畅播放。v3 引入了 HLS 实时转码：打开视频的瞬间就开始转码，不需要提前生成转码文件。
好处很直接：
- 省存储空间（可以不生成离线转码副本）
- 画质可以手动/自动切换
- 转码为客户端支持的最佳编解码器
但也有前提：你的服务器得够强。官方推荐有硬件加速（QSV/VAAPI/NVENC），纯 CPU 转码在高码率视频上会吃力。目前只支持 Web 端，移动端还在开发中。这功能是实验性的，行为可能在后续版本变化。
Android 后台备份大改进
Android 端的后台备份一直是个痛点。v3 用新的周期性任务调度器重写了这块，现在可以后台上传整个媒体库而不只是新拍的照片。之前那种「打开 app 才开始备份」的体验终于改善了。
iOS 端也有改进：后台刷新任务现在并行运行同步和上传，在系统给的短时间窗口内能实际启动上传了。
完整性检查
v3 新增了完整性报告功能。Immich 会扫描你的文件系统目录，跟数据库做对比，发现三类问题：
- 未跟踪文件：磁盘上有但 Immich 不知道的文件
- 缺失文件：数据库引用了但磁盘上不存在的文件
- 校验和不匹配：文件可能损坏或被重命名
这对长期运行、经历过多次升级和迁移的 Immich 实例特别有用。你可以在维护页面手动触发检查。
其他值得关注的功能
- Android 图库查看器：Immich 可以作为 Android 系统默认的图片查看器。在其他 app 里点开照片，选择 Immich 打开，直接看到资产查看器，还能分享或上传。
- 移动端 OCR：资产查看器新增文字识别开关，可以直接从图片中选中并复制识别到的文字。
- 移动端幻灯片：自动播放照片和视频，跟 Web 端的幻灯片体验对齐。
- 最近添加页面：按资产添加到 Immich 的时间排序（而非拍摄时间），方便找新导入的内容。
- 新的 Web 视频播放器：自定义播放器控件，统一所有设备的布局，支持调速播放。
- 分享时选择图片尺寸：手机上分享照片时可以选压缩尺寸或全质量，默认行为可在设置里改。
破坏性变更：大多数用户不用慌
v3 有 30+ 项破坏性变更，但绝大部分是 API 端点的更新，只影响跟 Immich API 集成的第三方工具。对通过 Docker Compose 部署的普通用户来说，升级方式跟以前一样：
# 修改 .env
# IMMICH_VERSION=v2 → IMMICH_VERSION=v3
docker compose pull && docker compose up -d有一项值得注意：v3 放弃了 pgvecto.rs 支持。如果你之前用的是 pgvecto.rs 作为向量数据库，需要迁移到 pgvector。绝大多数用户用的是默认的 pgvector，不受影响。
另外，机器学习容器现在要求 CPU 至少是 x86-64-v2 微架构（大约 2010 年后的 CPU）。arm64 不受影响。如果你在很老的 x86 机器上跑 Immich，可能需要留意——不过团队说后续补丁版本会兼容更老的 CPU。
升级注意事项
- 备份数据库和照片目录。虽然 RC 经过了测试，但毕竟是预发布版本，3-2-1 备份原则不能忘。
- 想尝鲜的话，在 Admin Settings → Version Check 里把发布通道从 “Stable” 改成 “Release candidate”，或者直接改
.env里的IMMICH_VERSION=v3-rc拉取最新的 RC。 - 如果不急，等正式版出来再升。Immich 的 RC 迭代速度很快（rc.0 → rc.2 只用了不到两周），正式版应该不远了。
- 升级后建议跑一下完整性检查，确认数据没有在升级过程中出问题。
小结
Immich v3 是个诚意满满的大版本。移动端编辑、工作流自动化、实时转码这三个功能把 Immich 从「好用的照片备份工具」往「完整的媒体管理平台」又推了一大步。尤其是工作流系统，虽然还是预览版，但框架设计得不错——拖拽式构建器 + JSON 导入导出，看得出团队对可扩展性有认真考虑。
如果你已经在用 Immich，v3 值得关注。如果你还没入坑，现在是个不错的时机——v3 正式版发布后，很多 v2 时代的小毛病应该会被一并解决。
提醒：Immich 处于活跃开发期，不要把它当作照片的唯一存储。3-2-1 备份策略永远适用。
参考链接：