自建相册真正难的不是做一个能看图的网页,而是把云相册那套体验完整搬回自己的机器:手机要在后台自动备份、同一张照片不能重复上传、几万张照片要能按人、按地点、按一句话搜出来,还得保留原文件、EXIF、动态照片和共享关系。Immich 把这些凑齐了,并且全部塞进一份 Docker Compose 里。项目 2022 年 2 月建仓,采用 AGPL-3.0,主语言 TypeScript,仓库目前约 11.87 万星、7548 个 fork、669 个未关闭 issue,文件数 4299,2026 年 11 月 10 日仍有提交。
这篇除了讲它做什么,还要专门回答一个搜索时特别容易被误导的问题:Immich 的「收费版」和「免费版」到底差在哪。先把结论摆出来——官方没有任何功能付费墙,所谓收费版只是一枚可选的产品密钥,买的是支持者身份,不解锁任何功能。下面把官方公告、结算页、文档与 FAQ 的原文依据逐条列清楚,顺带说明真正要花钱的地方在哪里。
一、它把云相册的哪几块搬了回来
README 的功能表按移动端和 Web 端分开列,能看出两端并不是简单复刻:
| 能力 | Mobile | Web | 说明 |
|---|---|---|---|
| 照片与视频上传、浏览、下载 | 支持 | 支持 | 含 RAW、LivePhoto / MotionPhoto、360 度图片(仅 Web 显示) |
| 自动备份 | 支持 | 不适用 | 打开或恢复 App 时触发,另有后台周期备份;可选相册、可排除相册 |
| 去重 | 支持 | 支持 | 按文件内容算校验和,服务端已有的资产直接跳过 |
| 搜索 | 支持 | 支持 | 元数据、对象、人脸与 CLIP 语义检索 |
| 人脸聚类、回忆、全局地图 | 支持 | 支持 | 服务端机器学习容器负责推理 |
| 共享相册、伙伴共享、公开链接 | 支持 | 支持 | 多用户各自独立账号 |
| 用户管理、OAuth、API Keys | 部分 | 支持 | 管理功能与 API Keys 只在 Web 端 |
| 标签、文件夹视图、堆叠照片 | 文件夹视图支持 | 支持 | 标签目前仅 Web 端;移动端有离线支持 |
几个细节比功能表更值得看。移动备份默认只在 Wi-Fi 下上传,可以在设置里改;相册同步是单向的(设备到服务器),能在任何时候开启,并用「Reorganize into album」把已上传的旧照片回填进对应相册。首次选择备份相册时,客户端会为每个文件算内容校验和,所以同一张照片无论之前是从命令行、网页还是另一台手机传上去的,都不会再传一遍。
人脸识别走的是「检测模型给出人脸框与置信度 → 裁切后送识别模型生成向量 → 服务端做聚类」这条链。文档里把聚类算法讲得很直白:默认至少要有 3 张足够相似的人脸(含当前这张)才构成核心点并新建一个「人物」,其余相似人脸再归入这个人物;官方不建议把最低检测分数调到 0.5 以下(误报难清理),也不建议把最大识别距离调到 0.3 以下或 0.7 以上。参数都暴露在管理后台的机器学习设置里,模型也可换成更轻的。
外部库是另一个容易被低估的能力:把 NAS 上已有的照片目录以只读方式挂进容器,Immich 扫描后在时间线里当作普通资产展示,也能上地图、进相册;支持 glob 排除规则(大小写不敏感,例如排除 RAW 文件)、多导入路径、定时重扫。但它的边界也写得很清楚:在 Immich 里加的相册、描述等元数据只存在 Immich 数据库里,不会写回原文件;文件在库内移动后会被当成新资产,原有元数据丢失;源目录里的文件被删,重扫后资产进回收站,30 天后彻底移除。自动监视文件系统仍标注为实验性,网络盘基本不生效,启用后遇到 ENOSPC 需要调高 fs.inotify.max_user_watches。
二、「收费版」与「免费版」的区别:其实没有功能区别
网上搜 Immich 价格,会看到各种「Free / Pro / Premium」套餐表,甚至写着 100GB 存储、50 个席位、优先支持、年付打折。这些基本是 AI 批量生成的定价站编出来的,和官方没有任何关系。官方只有两档一次性产品密钥,而且明确说了它不解锁功能。
证据链有四处,时间跨度从 2024 年到 2026 年,口径始终一致:
- 2024 年 7 月 18 日官方公告《Immich introduces product keys》的 FAQ:「不付费会怎样?」答「你可以不受任何限制地继续使用」;「会有付费墙功能吗?」答「不会,永远不会有」。
- 官方文档 Support The Project 页:「所有功能永远免费,不会有任何东西被放进付费墙。」
- 2026 年 6 月 1 日官方复盘《FUTO — 2 years later》逐条核对当年承诺:许可仍是 AGPL,「仍然没有任何功能需要付费」;两年间免费交付了 OCR、范围受限的 API Key、Google Cast、HDR 视频、新版编辑器、标签、文件夹视图等一长串功能。
- 当前结算页 buy.immich.app 只列两项:Family 100 美元、Single 25 美元,均标注「Lifetime purchase」「Supporter status」,页面还专门提示「这是纯软件购买,仍然需要硬件」。
把两边并排放,差异就一目了然:
| 对比项 | 免费使用(不买密钥) | 购买产品密钥 |
|---|---|---|
| 价格 | 0 元 | Single 25 美元 / Family 100 美元,终身一次,非订阅 |
| 覆盖范围 | 无此概念 | Single 绑定单个用户、可用于该用户连接的任意服务器;Family 绑定整台服务器、覆盖其上所有用户 |
| 功能清单 | 全部开放 | 完全相同,没有一项功能需要付费 |
| 软件许可 | AGPL-3.0,可自建、可修改 | 同样是 AGPL-3.0;密钥不是运行许可,不买也能合法部署 |
| 用户数与容量 | 不设上限,取决于自己的硬件 | 同样不设上限 |
| 人脸聚类、语义搜索、地图、OCR、API、移动 App | 全开 | 全开 |
| 版本更新 | 正常获取 | 完全一样,没有抢先通道或专属版本 |
| 界面上的差别 | 会看到购买入口提示 | 显示支持者身份与徽章(Supporter status) |
| 技术支持 | 官方文档与社区 | 不包含优先支持、SLA 或专属客服 |
| 托管、存储、备份 | 不含 | 同样不含,结算页明写仍需自备硬件 |
两档怎么选,官方 FAQ 给了明确的算法式建议:管理员本人是唯一用户、或实例用户少于 4 人时,按人买 Single 更划算;超过 4 人则买覆盖整台服务器的 Family。产品密钥从 v1.109.0 起可直接在应用内激活;前端源码里的激活逻辑也印证了这个区分——带 IMSV 前缀的服务器密钥只有管理员能走服务器激活,否则一律落到用户级激活。
还有个历史遗留的措辞坑值得说明:2024 年最初用的是「license key」,界面出现过类似「unlicensed / unlimited trial」的字样,在自托管社区里引起过很大反弹,官方随后统一改称 product key、按钮改成 Buy Immich,结算页写的是 Supporter status 而不是 Pro / Premium 会员。所以在旧版界面的截图里看到购买提示,不代表没付费就不能用——这也正是本文配图主动弃用带购买入口那两张官方截图的原因。
商业化边界也别误读。FUTO 目前养着约 10 人的全职团队,还免费运营每月处理数千万请求的地图瓦片服务;官方 FAQ 明确不接受功能赞助或悬赏,理由是不想让钱影响路线图,也不承诺合并外部出资开发的功能。团队确实在做一个加密备份产品,但那是独立的新产品,不是把现有功能上锁。Immich 名称和 Logo 已注册商标,FAQ 对转售商的要求相当直接:不得在自己的网站和宣传材料上使用其商标、不得宣称与官方有关联或获官方背书,若想支持开发,应引导客户直接向官方购买密钥。市面上有第三方用「Immich Cloud」这类名字卖托管套餐(免费 30GB、150GB、2TB 之类),那不是官方服务,看到时对照上面这份规范判断即可。
那钱到底花在哪?官方 FAQ 有一问很坦率:「Immich 能帮我省钱吗?大概不能。」一次性密钥之外,真正的成本全在自建这件事本身:
| 成本项 | 官方给出的具体数字 |
|---|---|
| 硬件 | 内存最低 6GB、推荐 8GB;CPU 最低 2 核、推荐 4 核;只有 4GB 时需关掉机器学习功能 |
| 存储 | 缩略图与转码视频平均让照片库再增加 10–20% 占用;Postgres 数据文件通常 1–3GB,建议放本地 SSD,切勿放网络共享 |
| 备份 | 上传目录里的原文件与数据库要各备一份,按 3-2-1 再留一份异地;系统自动把数据库备份写到上传目录的 backups 子目录 |
| 运维 | 云主机或 NAS、电费、域名、版本升级与故障排查的时间 |
换句话说,免费的是软件,不是相册。自建的理由是照片留在自己手里、容量自己说了算、不被平台政策牵着走,而不是比云相册便宜。
三、部署实际长什么样
官方主推 Docker Compose,仓库里的编排文件是四个服务:immich-server(对外 2283 端口,挂上传目录)、immich-machine-learning(独立模型缓存卷)、redis(Valkey 9)与 database(Postgres 14,带 VectorChord 0.4.3 与 pgvectors 0.2.0,用于向量检索)。Compose 文件顶部有一行容易被忽略的警告:安装时要用发布版附带的编排文件,main 分支上的那份可能与最新 release 不兼容。
环境要求同样不客气:推荐 64 位 Linux,官方明确说非 Linux 系统的 Docker 体验较差且「强烈不推荐」,Windows 需走 Docker Desktop 或 WSL2,macOS 用 Docker Desktop;支持 amd64 与 arm64,但自 v3 起 amd64 上的机器学习容器要求 x86-64-v2 指令集(约 2012 年之后的 CPU 基本都支持),老 CPU 能用的最后一版是 v2.7.5。命令必须是带 Compose 插件的 docker compose,已废弃的独立 docker-compose 不受支持。
机器学习是可选加速项:推理侧支持 CUDA(算力 5.2 以上、驱动不低于 545)、ROCm、OpenVINO、ARM NN(仅 Mali GPU)与 RKNN,文档直言 CUDA 兼容性最可靠;视频转码侧另有 nvenc、quicksync、rkmpp、vaapi 等预设。不上 GPU 也能跑,只是大库首次建索引更慢。
四、别踩的几处坑
README 最顶上就是一条加粗警告:务必按 3-2-1 备份珍贵的照片和视频,不要把 Immich 当成唯一副本。官方的备份与恢复文档也照这个思路写:数据库与上传目录里的媒体文件要各备一份;界面里可以管理自动备份,恢复操作会先清空当前数据库并在开始前自动建还原点,失败时自动回滚;跨版本恢复可能触发数据库迁移,尽量回到兼容版本。若用了外部库,恢复时新编排文件的挂载结构必须和原来一致,否则文件对不上。
另外几件需要提前有心理准备的事:项目迭代快,大版本升级历史上出现过破坏性变更与迁移问题,升级前先看发布说明;外部库的元数据不落原文件,移动文件会丢元数据,自动监视仍属实验功能;非 Linux 平台排障能拿到的官方帮助很有限;AGPL-3.0 与已注册的品牌商标,对二次分发、改名和商用宣传都有约束,做商业产品前值得先读 FAQ 的 Commercial Guidelines。
五、适合谁
如果你有一台 NAS 或小主机,想把家庭照片从云相册迁出来,又要保留后台自动备份、人脸聚类和「搜一句话找照片」的体验,还愿意认真做双份备份,Immich 目前几乎是默认答案。如果你要的是开箱即用、存储由别人负责的托管服务,或者打算把全部照片只存这一份,那它并不合适——官方自己也是这么说的。
至于「收费版」,一句话收尾:它不存在,只有愿不愿意花 25 或 100 美元支持开发的区别。产品密钥给的是一枚支持者徽章,功能、许可、更新和容量,免费用户一个不少。
本文整理自公开资料并重写:项目仓库 README、文档站的 Requirements / Backup and Restore / Mobile Backup / Facial Recognition / External Libraries / Hardware-Accelerated Machine Learning / Support The Project / FAQ,仓库内 Docker Compose 编排文件与前端激活逻辑源码,以及官方 2024 年产品密钥公告、2026 年 6 月《FUTO — 2 years later》复盘与 buy.immich.app 当前结算页。数据截至 2026 年 11 月,价格与功能以官方页面为准。配图取自仓库官方演示与文档截图,另含一张依据官方资料自绘的对比信息图;仅做格式统一、去元数据与尺寸压缩,未改动任何像素。版本徽章、社群入口、应用商店徽章、外部图床图片一律未收录;两张右上角叠有购买入口的官方截图已主动弃用。文中提到的第三方托管站点与所谓「套餐表」仅作辨识提示,不构成推荐。
本文整理自公开资料并做重写,原始出处:https://github.com/immich-app/immich。文中配图已去除站点叠加水印与推广信息;版权归原作者所有。




