117k Star 的开源相册，正在把 Google Photos 搬回你自己的硬盘

手机相册大概是当代人最矛盾的数字资产：它增长得最快，却最不受自己控制。Google Photos 免费容量早已成为历史，iCloud 的订阅费年复一年地扣，而你甚至不确定那些照片到底存放在哪台服务器上。自托管相册的想法因此一直有人尝试，但过去的结果多半是“能用，不好用”——直到 Immich 出现在 GitHub Trending 上，并且停在了那里。

截至 2026 年 10 月，immich-app/immich 在 GitHub 上已经积累了超过 117,000 颗 Star 和 7,000 余次 Fork，使用 TypeScript 编写，以 AGPL-3.0 协议开源。它不是又一个“整理本地文件夹”的工具，而是一个目标明确的自托管照片与视频管理平台：把手机自动备份、时间线浏览、人脸识别、语义搜索、相册共享这些原本属于商业云相册的能力，整套搬到一台你自己控制的服务器或 NAS 上。

它到底能做什么

Immich 的功能列表长得不像一个早期开源项目。从官方 README 的对照表来看，移动端和 Web 端共同覆盖了自动备份、重复文件检测、多用户支持、共享相册、RAW 格式支持、EXIF/地图元数据、按对象/人脸/CLIP 搜索、OAuth、LivePhoto 备份与回放、360 度图片显示、公共分享、归档与收藏、全局地图、Partner 共享、人脸识别与聚类、Memories（往年今日）、离线支持、只读相册、照片堆叠、标签、文件夹视图等条目。

其中最有“云相册感”的几个能力值得单独拿出来说。时间线视图按年、月、日组织媒体，滚动条可以像实体相册一样拖动 scrub，背后是虚拟滚动在撑大图库的性能。人脸识别与聚类在本地运行，自动把同一个人物的照片归入 “People”，也支持手动标注修正。CLIP 语义搜索则允许你用自然语言描述来找图，比如“海边穿黄泳衣的小孩”，而不需要依赖精确的文件名或标签。共享层面，Immich 同时支持传统的共享相册和 Partner 共享——后者适合家庭成员之间把各自的图库以只读或可交互的方式“合流”，而不需要把照片混进同一个账户。

多容器架构，Docker Compose 是主路径

Immich 不是一个单体应用。官方架构文档把它拆成四块：Immich Server 提供 REST API 与核心业务逻辑，immich-machine-learning 作为独立微服务执行人脸识别、目标检测和 CLIP 向量推理，PostgreSQL（带 pgvector 扩展）负责持久化与向量检索，Redis 通过 BullMQ 管理后台任务队列。前端使用 TypeScript 与 React，后端基于 NestJS。这种拆分让机器学习可以按需启停，也意味着部署时需要的不是一行命令，而是一份编排文件。

官方推荐的生产部署方式正是 Docker Compose。步骤本身不复杂：建一个目录，拉取最新的 docker-compose.yml 和 example.env，把 example.env 改名为 .env，填入 UPLOAD_LOCATION（照片和视频的存储路径）、DB_DATA_LOCATION（PostgreSQL 数据路径）和自定义的 DB_PASSWORD，然后 docker compose up -d。浏览器打开 http://服务器IP:2283 即可进入初始化页面。

但“能跑起来”和“跑得舒服”之间有一段距离。社区实践文章给出了更贴近真实的配置门槛：如果只做备份和时间线浏览，2 核 4 GB 可以稳住；一旦要用人脸识别和语义搜索，机器学习容器在首次批量导入时会成为内存黑洞，建议 8 GB 内存起步，否则容器被 OOM 终止几乎不可避免。存储方面，Immich 除了原始文件还会生成缩略图和预览图，通常需要额外预留 20%–30% 的空间；一个五年积累的手机相册多数在 150–300 GB 之间，家庭共享库超过 500 GB 也很常见。数据库目录所在的文件系统必须是 ext4、xfs、btrfs 这类支持 Unix 权限的本地文件系统，指向网络共享或 NTFS 会出问题。这些细节在官方文档里不是每一条都放在最显眼的位置，但恰恰决定了部署之后是“稳定运行”还是“隔三差五修容器”。

隐私优先的另一面

Immich 的定位非常清楚：它不碰端到端加密。官方在多次评测中被提及的一个取舍是，本地机器学习、人脸聚类和语义搜索要求服务器能够读取媒体内容进行推理，端到端加密与这些能力在架构上并不兼容。这意味着 Immich 的“隐私”来自于数据所有权和控制权，而不是密码学意义上的“服务端不可见”。如果你追求的是“连服务器管理员都看不到照片内容”，Immich 不是答案；但如果你在意的是“照片不再存放在一家按月收费的公司的机房里，备份、访问和删除都由自己决定”，它几乎是目前开源选项里完成度最高的那一个。

另一个常被拿来和 Google Photos 对比的短板是智能相册的缺失。有用户明确指出 Immich 尚不支持类似 Google Photos 那种基于人物、地点、时间条件自动聚合的“智能相册”，其组织能力更多依赖手动相册、标签和搜索。Memories 功能可以按“往年今日”回溯，但它和 Google Photos 那套主动策展式的回忆生成仍有体验上的差距。换言之，Immich 在备份、浏览、检索、共享这四个核心链路上已经能覆盖大多数人的日常需求，但在“让算法替你整理回忆”这件事上，它还处在追赶的位置。

谁该现在上车

Immich 不适合所有人。如果你期望的是“装完就再也不管”的零维护云服务，它大概率会让你在第一次调 .env 或第一次 OOM 时感到挫败。它的正确用户画像是：有一台常开的 NAS、家庭服务器或 VPS，愿意接受 Docker 的基本操作，并且照片对你来说是“值得花一个周末去接管”的数据。一旦跑通，你会得到一个跨 iOS/Android/Web 的相册系统：手机端自动备份，浏览器里按时间线和地图浏览，家人通过 Partner 共享看到彼此更新，人脸和语义搜索在本地完成，不再有月度订阅账单。

117k Star 本身不构成推荐理由，但它说明了一件事：有足够多的人愿意为“照片回到自己手里”这件事投出一票。Immich 不是完美的 Google Photos 替代品，但它是目前把“自托管相册”从极客玩具推向可用产品的那一个。如果你手里正好有一块闲置硬盘和一台不关机的机器，它值得成为你下一个 docker compose up 的项目。