Immich：照片与视频自托管管理工具

摘要

1) 一句话总结 Immich 是一款基于 AGPL-3.0 协议开源的高性能自托管照片与视频管理解决方案，作为 Google Photos 的替代品，提供跨平台自动备份、AI 智能搜索及多用户共享功能。

2) 核心要点

项目状态：当前 GitHub Stars 为 93134，Forks 为 4942，最新版本为 v2.5.6。
技术栈：采用全栈式开源架构，主要语言为 TypeScript，结合 Flutter（移动端）、NestJS（服务端）、Svelte（Web 端）以及独立的机器学习模块。
部署与体验：支持通过 Docker 进行自托管部署，官方提供 Web 端和移动端的 Demo 演示环境。
跨平台备份：移动端支持打开应用时备份、后台无感自动备份、选择性相册备份以及离线查看。
AI 与智能搜索：内置机器学习组件，支持人脸识别与聚类；支持基于元数据（EXIF、位置）、对象、人脸及 CLIP 模型的高级内容搜索。
媒体与浏览体验：支持 Raw 格式及 LivePhoto/MotionPhoto；提供全局地图视图、回忆（“那年今日”）、照片堆叠功能，并采用虚拟滚动优化海量照片浏览。
多用户与安全：支持多用户独立使用、伴侣共享（Partner Sharing）及公开链接分享；支持 OAuth 认证登录，内置防重复上传机制并允许自定义存储结构。

3) 风险与不足

数据安全风险：官方明确警告，不应将 Immich 作为唯一的数据存储和备份手段，对于珍贵影像必须始终遵循 3-2-1 备份策略。
平台功能限制：部分功能存在端侧限制（如：后台备份和离线支持仅限移动端；标签管理、API Keys 生成、360 度全景图片显示及管理员功能仅限 Web 端）。

Immich 是一款高性能的自托管照片和视频管理解决方案，被定位为 Google Photos 的开源替代品。它提供了完整的跨平台体验，包含服务端、Web 端以及移动端应用，旨在帮助用户在私有服务器上安全地备份、管理和浏览个人多媒体资产。

跨平台访问与备份：提供 Web 端和移动端。移动端支持打开应用时自动备份、后台备份、选择性相册备份以及离线查看。
智能识别与搜索：内置机器学习组件，支持人脸识别与聚类；支持通过元数据（EXIF、地图位置）、对象、人脸以及 CLIP 模型进行高级搜索。
丰富的媒体格式支持：支持 Raw 格式图像、LivePhoto/MotionPhoto 的备份与播放；Web 端额外支持 360 度全景图像显示。
照片组织与浏览：提供全局地图视图、回忆功能（如“那年今日”）、照片堆叠、文件夹视图、归档与收藏。支持虚拟滚动和可拖动滚动条以优化海量照片的浏览体验。
多用户与共享机制：支持多用户独立使用，提供相册共享、伴侣共享（Partner Sharing）以及生成公开分享链接的功能。
系统与安全管理：支持 OAuth 认证登录；Web 端提供 API Keys 生成及管理员（用户管理）功能；系统内置防止资产重复上传的机制，并允许用户自定义存储结构。

全栈式开源架构：项目结构完整，涵盖了 mobile（移动端）、server（服务端）、web（网页端）以及 machine-learning（机器学习）模块。
高度对标商业产品：在功能丰富度上直接对标 Google Photos，不仅提供基础的存储和浏览，还实现了基于 AI 的高级搜索和人脸聚类等复杂特性。
端侧功能差异化：合理分配各端能力，例如移动端专注备份与离线体验，Web 端则提供更全面的管理功能（如标签管理、API 密钥、系统管理等）。

数据安全警告：官方在文档中明确警告，对于珍贵的照片和视频，必须始终遵循 3-2-1 备份策略，不应将 Immich 作为唯一的数据存储和备份手段。
功能平台限制：部分功能仅在特定平台可用。例如，后台备份和离线支持仅限移动端；而标签管理、API Keys、360 度图片显示及管理员功能仅限 Web 端。