Immich 是什么?
Immich 是一个自托管应用,用于把手机中的照片和视频备份到你掌控的服务器上,并在其中浏览和搜索。GitHub 的 README 称它是“高性能的自托管照片和视频管理方案”;代码以 AGPL-3.0 许可证开源。
App Store 将 FUTO Holdings, Inc. 列为销售方。应用会把手机相册备份到你的服务器,网页界面则提供相册、分享、地图和管理功能。文档把 AI 部分描述为独立的机器学习服务,服务器会把图片发送给它处理。
获取方式
Immich 是需要你自己安装的服务器,文档推荐的方式是 Docker Compose;iPhone 和 Android 应用则是普通的商店安装,用来连接该服务器。
选项 | 获取方式 |
|---|---|
| 服务器(Docker Compose) | 安装指南:下载两个文件、修改一个、执行一条命令 |
| iPhone 和 iPad | App Store(免费,需要 iOS 15.0 或更高版本) |
| Android | Google Play,或 GitHub 发布页中的 APK |
| 浏览器 | 据文档,在任意浏览器中访问服务器地址的 2283 端口(port 2283) |
| 官网 | immich.app |
| 隐私政策 | immich.app/privacy-policy(最后更新于 2026 年 4 月 6 日) |
| 源代码 | github.com/immich-app/immich |
| 演示 | demo.immich.app,登录信息见 README |
评测版本:v3.3.5,据 GitHub 发布页面和 App Store 记录于 2026 年 10 月 21 日发布;Google Play 页面显示更新于 2026 年 10 月 20 日。安装需要终端和 Docker,因此这是面向开发者风格的部署,而不是双击即可安装。文档要求手机应用与服务器保持相同的主版本号和次版本号。
运行要求
文档要求至少 6 GB 内存和 2 个 CPU 核心,推荐 8 GB 内存和 4 核。
内存
- 来源说明:
- 最低 6 GB,推荐 8 GB;只有 4 GB 时,可在关闭机器学习的情况下运行
CPU
- 来源说明:
- 最低 2 核,推荐 4 核;支持 amd64 和 arm64;自 v3 起,机器学习容器需要 x86-64-v2 级别
操作系统
- 来源说明:
- 推荐 64 位 Linux;通过 Docker Desktop 在 macOS 和 Windows 上运行也可行,但不建议,支持有限
存储
- 来源说明:
- 兼容 Unix 的文件系统;缩略图和转码文件会额外增加 10-20%;数据库应放在本地 SSD 上,而不是网络共享
Docker
- 来源说明:
- 带 Compose 插件的 Docker;不支持旧版 docker-compose 命令
GPU
- 来源说明:
- 对机器学习容器是可选项;文档称该加速功能为实验性
手机
- 来源说明:
- 据 App Store,需要 iOS 15.0 或更高版本;据应用的构建文件,Android 需要 8.0(API 级别 26)或更高版本
这些最低要求来自项目文档;PromptQuorum 没有在任何硬件上测量索引耗时或内存占用。
上手步骤
以下步骤依据项目的 Docker Compose 指南,PromptQuorum 没有执行过。
- 1下载 compose 文件
Why it matters: 新建一个文件夹,然后从最新发布中把 docker-compose.yml 和 example.env 模板下载到该文件夹。 - 2编辑环境文件
Why it matters: 把 UPLOAD_LOCATION 设为空间充足的文件夹,并把 DB_PASSWORD 改为仅包含字母和数字的新值。 - 3启动容器
Why it matters: 在该文件夹中运行 docker compose up -d,在浏览器中打开服务器并注册;第一个注册的用户成为管理员。 - 4连接你的手机
Why it matters: 安装应用,输入服务器地址,选择要备份的相册,并在 Job Queues 标签页中查看进度。
主要功能
以下各项均来自项目的 README 或文档;PromptQuorum 均未测试。
- 备份。手机端自动后台备份、可选择相册、防止重复,另有命令行上传工具。
- 照片库。相册、共享相册、伴侣共享、公开链接、地图、回忆、堆叠、标签、文件夹视图和 RAW 支持。
- 搜索。上下文(CLIP)搜索,外加人物、地点、文件名、描述、标签、相机、日期和星级筛选;文档把图片中的文字(OCR)列为一种搜索类型。
- 账户。多用户、OAuth 登录和 API 密钥;第一个注册的用户是管理员。
- 导入。immich-go 用于 Google Takeout,External Libraries 用于磁盘上已有的归档。
AI 功能及运行位置
这里的 AI 基于图像:智能搜索使用 CLIP 模型,另有人脸检测和识别模型,全部由机器学习容器运行;不涉及语言模型。
- 智能搜索。自由文本查询会与通过 VectorChord 扩展存放在 Postgres 中的 CLIP 嵌入向量进行匹配;你在“管理”中选择模型,默认是最快的那个。
- 语言。文档称,nllb 模型期望查询使用用户设置中指定的语言,而 xlm 和 siglip2 模型可处理任意语言的文本。
- 人脸。检测在预览图上进行,识别模型生成嵌入向量,再由 DBSCAN 聚类把它们归为可命名的人物。
- 托管。内置的机器学习服务默认已配置,常见问题称它也可以改为运行在性能更强的机器上。
- GPU。支持 CUDA、ROCm、OpenVINO、ARM NN 和 RKNN 后端;文档称该功能为实验性,其中 CUDA 最可靠,ROCm 较新。
数据流向与隐私
文档称,智能搜索模型下载完成后,除非启用版本检查,Immich 无需网络连接;反向地理编码则在你自己的服务器上,基于 GeoNames 数据运行。因此,除非你主动分享,照片和数据库都会留在你的硬件上。
来源中提到的对外请求有:从 Hugging Face 下载模型、可选的版本检查(据服务器源码,它发往 Immich 自己的版本服务,而不是 GitHub),以及地图瓦片。隐私政策(最后更新于 2026 年 4 月 6 日)列出了瓦片服务器(Tile Server)和版本服务(Version Service),它们会记录请求元数据(请求的瓦片或 user agent、IP 地址和时间);政策称瓦片服务器是可选的,可以关闭。服务器端的电子邮件通过你自己配置的 SMTP 服务器发送。Google Play 页面声明:不与第三方共享数据,可能收集照片和视频以及设备或其他 ID,数据在传输中加密。
📌注: 这些是项目的声明,不是审计结果。文档称版本检查指向 GitHub,而服务器源码和隐私政策指向 Immich 自己的 Version Service;PromptQuorum 没有检查网络流量,也没有阅读其余源码。
适合哪些人
- 拥有 Docker 服务器或 NAS 的自托管用户,想要云端照片服务的私密替代方案。
- 家庭和小团体,希望共用一个照片库,同时拥有各自的账户、共享相册和手机备份。
- 拥有大量手机相册存档的人,需要按内容和按人物搜索。
我们未能核实的内容
- AI 质量。搜索相关性、人脸分组准确度和速度均未测试;文档中的基准数据来自同一套测试系统。
- 备份。文档提醒,数据库只保存元数据,上传文件夹必须由你自己备份,README 还建议采用 3-2-1 备份方案。
- 回收站行为。常见问题称,在 Immich 中清空回收站时,已进入回收站的原始文件会被删除。
- 购买条款。购买页面无法读取,因此未写出价格;文档称购买属于自愿支持。
- 商店声明。Google Play 的数据安全摘要是开发者自己的声明,App Store 的隐私标签未查阅。
竞品与替代方案
目录中还有两款带评测的照片库工具,一款是自托管的,一款是云端的。
PhotoPrism
- 平台:
- 服务器(Docker)、浏览器
- 价格 / 许可证:
- Community 版免费 / AGPL-3.0
- 主要区别:
- 与 Immich 一样可自托管,但只有网页应用;其手机应用来自其他开发者
关于PhotoPrism的文章(1篇)
Ente Photos
- 平台:
- iOS、Android、桌面、网页
- 价格 / 许可证:
- 10 GB 免费,另有付费方案 / AGPL-3.0
- 主要区别:
- 带端侧 AI 的加密云存储;无需自己的服务器
关于Ente Photos的文章(1篇)
请在各应用自己的页面确认当前价格、许可证和平台。
常见问题
Immich 是本地 LLM 吗?
不是。文档描述的是 CLIP 图片搜索和人脸识别,而不是语言模型,已查阅的来源中也没有聊天或图片说明撰写功能。
没有 GPU 也能使用 Immich 吗?
文档把 GPU 加速列为可选且为实验性,最低要求中也只提到内存和 CPU 核心;仅用 CPU 时的速度未经测量。
可以从 Google 相册迁移过来吗?
简介页面推荐用 immich-go 处理 Google Takeout 导出;PromptQuorum 没有尝试迁移。
如何更新 Immich?
安装指南指向单独的升级说明,常见问题则要求手机应用与服务器保持相同的主版本号和次版本号。
我的文件存放在哪里?
存放在设为 UPLOAD_LOCATION 的文件夹中;Postgres 容器里的数据库只保存元数据和用户信息。
结论
Immich 免费且持续更新,可以在你掌控的硬件上保存可搜索、带手机备份的照片库,内容搜索和人脸分组都在你自己的服务器上运行。不足之处在于:安装需要 Docker 和环境文件,GPU 加速被标为实验性,而关于 AI 质量的说法在这里都无法核实。它适合已经在家里或 NAS 上运行各类服务的人;想要双击即用应用或语言模型助手的用户应另寻他选。
来源
- Immich 官网 — 平台、链接和隐私政策,2026 年 10 月 26 日查阅。
- Immich 文档 — 运行要求、安装指南、智能搜索、人脸识别、系统设置和常见问题,2026 年 10 月 26 日查阅。
- Immich 隐私政策 — 本地存储的数据、瓦片服务器和版本服务,最后更新于 2026 年 4 月 6 日。
- GitHub 上的 Immich — README、发布和提交动态,2026 年 10 月 26 日查阅。
- App Store 上的 Immich 和 Google Play — 销售方、版本和更新日期,2026 年 10 月 26 日查阅。
