immich-app/immich —— 高性能自托管照片与视频管理解决方案

这是什么

Immich 是一个开源自托管的照片与视频管理解决方案，代码库托管在 GitHub（immich-app/immich），主语言为 TypeScript，目前已获得超过 105,000 颗星。它提供完整的 Web 与移动端（iOS/Android）应用，允许用户在自己的服务器上存储、备份、浏览、搜索和分享照片与视频，同时保留对数据的完全控制权。

Immich 支持多语言界面（包括简体中文、繁体中文、日语、韩语、法语、德语等 20 多种语言），并提供了公开的 Demo 实例供试用。项目文档与安装指南位于 https://immich.app。

解决的问题

传统上，用户依赖 Google Photos、Apple iCloud、OneDrive 等云服务管理照片，但这些方案存在几个核心痛点：

• 隐私与数据所有权：照片和视频存储在第三方服务器上，用户无法完全掌控数据，且服务商可能通过用户内容训练模型或推送广告。
• 成本不可控：免费额度有限，大量原片或 4K 视频存储需按月付费，长期累积成本高昂。
• 功能缺失：很多云服务不支持 RAW 格式、LivePhoto 备份、OAuth 企业认证、用户自定义存储结构等高级需求。
• 迁移与锁定：从一个云服务迁移到另一个非常麻烦，缺乏自托管方案的灵活性。

Immich 提供了一套与主流云服务功能对等的自托管替代方案，让用户在自己的硬件上享受类似 Google Photos 的体验，同时彻底解决上述问题。

核心功能

Immich 的功能覆盖了照片管理全链路，以下按移动端和 Web 端列出关键能力（基于项目 README 中的表格）：

| 功能 | 移动端 | Web | |------|--------|-----| | 照片/视频上传与查看 | ✅ | ✅ | | 应用打开时自动备份 | ✅ | N/A | | 去重资产 | ✅ | ✅ | | 选择性相册备份 | ✅ | N/A | | 下载到本地设备 | ✅ | ✅ | | 多用户支持 | ✅ | ✅ | | 相册与共享相册 | ✅ | ✅ | | 可拖动的滚动条 | ✅ | ✅ | | RAW 格式支持 | ✅ | ✅ | | 元数据查看（EXIF、地图） | ✅ | ✅ | | 按元数据、物体、人脸、CLIP 搜索 | ✅ | ✅ | | 管理员功能（用户管理） | ❌ | ✅ | | 后台备份 | ✅ | N/A | | 虚拟滚动 | ✅ | ✅ | | OAuth 登录支持 | ✅ | ✅ | | API Keys | N/A | ✅ | | LivePhoto/MotionPhoto 备份与播放 | ✅ | ✅ | | 360 度图片显示 | ❌ | ✅ | | 用户自定义存储结构 | ✅ | ✅ | | 公开分享 | ✅ | ✅ | | 归档与收藏 | ✅ | ✅ | | 全球地图 | ✅ | ✅ | | 合作伙伴共享 | ✅ | ✅ | | 人脸识别与聚类 | ✅ | ✅ | | 回忆（x 年前） | ✅ | ✅ | | 离线支持 | ✅ | ❌ | | 只读画廊 | ✅ | ✅ | | 堆叠照片 | ✅ | ✅ | | 标签 | ❌ | ✅ | | 文件夹视图 | ✅ | ✅ |

此外，Immich 还支持 OAuth 集成、API 密钥（适合自动化脚本与第三方工具），以及完整的后台备份能力（移动端）。

亮点 / 与同类相比

市面上已有多个自托管照片管理方案，如 Nextcloud（带 Memories 插件）、PhotoPrism、LibrePhotos、Piwigo 等。Immich 的核心差异化优势在于：

1. 功能完备度接近商业产品：自动备份、人脸识别、CLIP 语义搜索、LivePhoto 支持、RAW 预览、回忆功能等，几乎对标 Google Photos 功能集，且更新活跃。
2. 移动端体验优先：Immich 的原生移动应用（而非 PWA）支持后台自动备份、离线查看、手指滑动浏览，流畅度优于多数竞品。
3. 性能与可扩展性：后端采用 TypeScript（NestJS）与 PostgreSQL，搜索基于 CLIP 模型，能高效处理大量照片。用户可自定义存储目录结构，不依赖数据库路径。
4. 社区活跃与开发速度：GitHub 上 10 万+ 星，提交频繁（几乎每日合并 PR），文档完善，并提供 Docker 一键部署。
5. 多用户与共享：原生支持多用户隔离、共享相册、合作伙伴共享（类似 iCloud 家庭共享），适合家庭或小团队使用。
6. 隐私优先：无遥测、无外部依赖（除 ML 模型本身），数据完全不出用户服务器。

与 PhotoPrism 相比，Immich 更侧重移动端自动备份和 Google Photos 式的“回忆”体验；与 Nextcloud Memories 相比，Immich 部署更轻量，移动端更原生。

适合谁用 / 上手

适合人群：

• 有自建服务器或 NAS 的隐私敏感用户，希望替代 Google Photos / iCloud。
• 家庭或团队需要共享照片库，并希望每个成员有独立账户和备份策略。
• 摄影爱好者需要 RAW 格式支持、元数据浏览与地图整合。
• 技术人员希望使用 API 集成自动化工作流（如通过 API Keys 上传照片）。
• 希望获得“照片管理即服务”体验但不想支付订阅费的用户。

上手建议：

• 快速部署：推荐使用 Docker Compose，官方提供 docker-compose.yml 和详细配置指南。最低要求：一台有 Docker 环境的 Linux 主机（或 Windows/macOS 虚拟机），以及至少 2GB RAM（推荐 4GB+）和足够存储空间。
• 初始化：部署后通过 Web 界面创建管理员账户，然后安装移动端应用（iOS/Android 均可从商店下载），输入服务器地址即可开始自动备份。
• 校验备份策略：项目文档明确提醒“始终遵循 3-2-1 备份计划”，建议对 Immich 数据库和存储目录进行定期快照或同步。
• 性能调优：如果照片库较大（>10 万张），可调整 PostgreSQL 参数、为 CLIP 模型分配更多内存，或将 ML 推理任务卸载到 GPU。
• 进阶功能：配置 OAuth（支持 Authentik、Keycloak、Authelia 等）、设置用户自定义存储路径、开启人脸识别与聚类、启用公开分享链接。

Immich 的持续更新和高质量社区使其成为当前最值得关注的自托管照片管理方案之一。如果你能接受自运维的初期投入，它将带来长期的数据自主权与功能自主权。