immich-app/immich

项目定位

Immich 是一套自托管的照片和视频管理平台：服务端跑在自己的机器上，手机 App 和网页端连到它，获得接近云相册的体验，同时媒体库留在自己手里。它面向的是想从 iCloud、Google Photos 这类服务迁走，但不愿放弃手机自动备份、相册、分享、元数据浏览和搜索的人。

Web 与移动端的功能覆盖都比较完整：上传和查看照片视频、App 打开时自动备份、去重、按相册选择性备份、相册与共享相册、RAW 格式、EXIF 与地图元数据、按元数据/物体/人脸/CLIP 搜索、LivePhoto 与 MotionPhoto、Web 端 360 度图片显示、Partner Sharing、人脸识别与聚类、回忆（往年今日）、移动端离线支持，以及仅 Web 提供的管理功能和 API Key。README 中有一张完整的移动端与 Web 功能对照表 Immich 功能表。

技术栈为服务端 NestJS + TypeScript、移动端 Flutter、Web 端 SvelteKit，以 AGPL-3.0 发布 AGPL-3.0 许可证。

先看演示

官方提供带公开账号的在线演示，可以在部署之前先评估界面和流程：

• 打开 Immich 演示站。
• 使用 demo@immich.app / demo 登录。
• 移动端 App 把 Server Endpoint URL 填为 https://demo.immich.app 演示说明。

自托管快速上手

README 本身不含部署命令，安装步骤和软硬件要求都在官方文档里 安装要求、主文档。实际流程大致如下：

1. 查看要求页，确认 CPU、内存、磁盘和 Docker 前提条件。
2. 按文档中对应平台的 Docker Compose 步骤完成安装。
3. 通过部署地址打开 Web 界面，创建第一个管理员账号。
4. 在手机上安装 App，把服务端地址指向自己的实例。
5. 开启备份，等首次上传完成后检查相册、缩略图和搜索是否正常。

具体的 compose 文件、环境变量和升级步骤随版本变化，以文档为准，不要自行拼凑。

使用约束

• 这是需要自己运维的服务：存储、备份、升级和可用性都由你负责。README 明确建议按 3-2-1 策略做备份，不要把它当作唯一副本 3-2-1 备份策略。
• 服务端搜索和机器学习功能（人脸、CLIP、物体搜索）对硬件有要求，选机器前先看要求页。
• 手机自动备份在 App 打开时运行，不是常驻后台进程。
• 管理功能和 API Key 仅 Web 提供；360 度图片显示也仅 Web，离线支持仅移动端。
• 如果修改后对外提供网络服务或再分发，AGPL-3.0 的条款适用。

HotRepo 点评

仓库目前约 11.8 万 Star、7.5 千 Fork。2026 年 7 月初连续三天出现在全语言日榜，当日新增分别为 198、475、470；8 月中下旬再次出现，单日新增在 128 到 175 之间；2026-11-03 在 TypeScript 日榜记录到 112 个新增、当日第 11 名。这些是彼此独立的快照，不能拼成一条连续曲线，只说明项目保持稳定活跃，而不是某次爆发。

更有参考价值的是 HN 讨论记录：2023 年的发布帖、2025 年 10 月的 v2.0.0 稳定版帖、2026 年 7 月的 3.0 帖都积累了数百条评论。其中反复出现的一点是入门说明不够清楚——3.0 帖里有评论者认为这个开源项目很出色，但「完全没能向新用户说清它是什么」HN 评论；而描述自己部署经验的用户则提到，是在用完付费云存储额度后迁移到自托管，并把 Immich 和其他服务一起挂在 VPN 后面日常使用 HN 评论。如果你打算推荐给非技术家人使用，这种「采用广但定位表达弱」的组合值得提前考虑。