手机相册这件事,我从 iCloud 搬出来已经两年了。现在照片全在 Mac mini M1 上,Immich 管界面和索引,备份走异地。这套东西平时安静得像不存在,只有升级的时候才会让人心跳加速。这次大版本升级踩了三个坑,值得写下来。
为什么是 OrbStack 而不是 Docker Desktop
Docker Desktop 在 M1 上一直有几个我不喜欢的地方:后台常驻一个不小的虚拟机,内存回收不积极,跑久了风扇会响。换到 OrbStack 之后,容器启动快了,内存占用也正常了,compose 文件几乎不用改。
对 Immich 这种"7×24 挂着、偶尔才用"的服务,资源占用是长期成本。Mac mini 还要同时跑别的容器,能省一点是一点。
升级前必须先备份
Immich 的升级说明里反复强调一句:不要跳版本。我这次是从一个比较老的版本直接跨了两个大版本,所以走的是"先升到中间版本、再升到目标版本"的路。
真正救命的其实是备份。我做了三件事:
pg_dumpall导出一份数据库- 整个
upload目录用 rsync 同步一份到外置盘(增量,很快) - 把
.env和 compose 文件一起存一份
第 3 条经常被忽略。数据库和照片都在,但忘了当时用的 IMMICH_VERSION 和环境变量,回滚时会很难受。
坑一:向量库换了
Immich 早期用 pgvecto-rs 做图像向量检索,后来换成了 pgvector。如果你手里还是旧版本的 compose 文件,升级时会发现镜像拉不下来,或者数据库初始化直接失败。
我的处理是把 compose 里的数据库镜像换成官方新版 compose 提供的那一个,然后重建数据库容器。注意这里要先备份再重建,因为数据目录的初始化逻辑变了,直接原地换镜像有概率起不来。
重建过程不长,但从 pg_dumpall 恢复完之后要重新跑一次索引任务,人脸和智能搜索的结果才会回来。这一步花了一个多小时,属于正常。
坑二:升级期间不要开客户端
这条是血的教训。升级到一半,iPhone 上的 Immich App 还在后台跑,触发了上传任务,往一个正在迁移的数据库里写数据。结果有几张照片的缩略图生成了两次,元数据对不上。
后来我是这么处理的:升级前在路由器上把 Immich 的域名解析临时指到黑洞(或者直接停容器),等全部完成后恢复。客户端只能在服务完全起来之后连上。
坑三:硬件转码不是默认开的
Mac mini 有 VideoToolbox,Immich 在容器里能不能用,取决于 OrbStack 有没有把设备透进去。默认配置下,视频缩略图是 CPU 软解,一部 4K 视频能跑几分钟。
我在 compose 里加了设备映射,重启之后视频处理速度明显下来了。具体参数每个版本写法略有不同,以官方文档为准——但方向就是让容器能看到宿主机的媒体引擎。
和 Alist、Emby 共存
Mac mini 上不只跑 Immich。Alist 挂几个网盘做统一入口,Emby 负责把老片库播到电视上。
三套东西共存的要点只有一条:端口和卷不要重叠。Immich 用 2283,Emby 用 8096,Alist 用 5244,各自的数据目录分开挂。OrbStack 的网络模式用默认的 bridge,需要局域网访问的再单独映射。
内存上,Immich 的机器学习容器是最能吃的一个。如果机器只有 16G,建议把 ML 的并发调低,不然同时跑 Emby 转码会一起卡。
备份策略
现在是这样:
- 数据库:每天凌晨
pg_dump到本地目录,保留 14 天 - 照片:每晚 rsync 到外置盘,每周同步一份到异地
- 配置:跟站点代码一起进 git(去掉密钥)
异地那份用的是另一台机器,走 WireGuard 过去。慢一点无所谓,关键是要有第二份。
一点感受
自建相册最大的成本不是搭起来那两天,是后面每一次升级。升级会让人紧张,但紧张的原因是"没有把握能回滚"。
只要备份是真的、回滚路径是演练过的,升级就没那么可怕。这次升完,我特意做了一次演练:拿备份在另一个目录起一套,确认能恢复,再删掉。这个动作比读十遍文档有用。
照片和别的数据不一样,它是不可再生的。为它多花一点时间做备份,值得。