Immich

Immich 是一款高性能的自托管照片和视频备份与管理系统,以成为 Google Photos 的开源替代为目标,提供自动备份、AI 人脸识别、场景分类、地图视图、相册共享等现代照片管理功能。项目以 MIT 许可证(服务端)发布,移动端 App(iOS/Android)完全免费,由个人开发者 Alex Tran 于 2022 年发起并迅速成长为最受关注的自托管照片解决方案之一。

项目背景

Google Photos 于 2021 年 6 月终止了无限量免费存储政策,促使大量用户开始寻找自托管替代方案。Immich 在此背景下于 2022 年初发布,凭借接近商业产品的 UI 体验和持续快速的迭代速度,在短时间内积累了大量 GitHub 星标和活跃用户社区。项目维护者明确将 Immich 定位为功能完整的 Google Photos 替代品,而非仅仅是文件备份工具。由于迭代速度极快,Immich 官方明确警告用户不应将其视为完全稳定的生产级软件,升级可能包含破坏性 schema 变更,建议始终维护独立备份。

核心功能

• 自动备份:iOS/Android App 在充电或 Wi-Fi 连接时自动将相机胶卷上传到服务器,支持选择备份的相册和媒体类型,后台静默上传不打扰使用。
• AI 人脸识别与聚类:服务端自动检测照片中的人脸并提取特征向量,将同一人的照片聚合为人物相册,用户可为识别出的人物命名;底层使用 InsightFace 的 buffalo_l 模型。
• 智能语义搜索:通过 CLIP 模型将照片内容转为语义向量并存入 pgvector,支持自然语言搜索(如搜索「海边日落」即可找到对应场景照片),无需手动打标签。
• 地图视图:读取照片 EXIF 中的 GPS 坐标,在地图上展示拍摄地点分布,支持按地理位置聚合浏览照片。
• 共享相册与公共链接:可将相册共享给其他 Immich 用户,或生成有效期内的公开访问链接供无账号者查看。
• 多用户支持:管理员创建多个用户账号,每位用户独立管理媒体库,可设置存储配额上限。
• 原始文件保留:上传后保留原始文件(含 RAW 格式及 HEIC),不进行有损压缩,确保照片质量完整。
• 外部库:支持将服务器上已有的照片目录作为只读外部库导入,方便从 Nextcloud Photos 等方案迁移而无需移动文件。

技术架构

Immich 采用微服务架构,主要组件包括:基于 NestJS(Node.js/TypeScript)的 API 服务器处理 HTTP 请求和业务逻辑;Redis 消息队列(BullMQ)调度缩略图生成、机器学习推理、EXIF 提取等异步任务;PostgreSQL 作为主数据库存储元数据;pgvector 扩展为 PostgreSQL 提供高效的向量相似度搜索,支撑 CLIP 语义搜索和人脸聚类;独立的 Machine Learning 微服务(Python/FastAPI)加载并运行模型,通过 HTTP 接口供 API 服务调用;Nginx 作为网关负责反向代理和大文件上传分块处理。

机器学习模型方面,Immich 默认使用 ViT-B/32 CLIP 模型进行图像语义嵌入,支持切换到 ViT-L/14 等更大模型以获得更高搜索精度;人脸识别使用 InsightFace buffalo_l 模型提取 512 维特征向量,随后通过 pgvector 的 HNSW 索引进行高效的余弦相似度近邻搜索完成聚类归并。所有向量数据持久化于 PostgreSQL 的 vector 类型列,库的规模增大时 HNSW 索引的构建和维护会带来额外的写入开销。

部署与配置

Immich 官方仅支持 Docker Compose 部署,提供官方 docker-compose.yml 和 .env 模板。标准部署包含 immich-server、immich-microservices、immich-machine-learning、redis 和 postgres(含 pgvector)五个容器。媒体文件和数据库数据均需挂载持久化卷。机器学习服务对首次处理大型库的资源需求较高,支持 CUDA(NVIDIA)和 OpenVINO(Intel)GPU 加速以大幅缩短推理时间,在 docker-compose.yml 中启用对应设备即可。

升级方面,由于版本迭代极快且偶有数据库 schema 变更,官方强烈建议每次升级前执行 pg_dump 备份,并按版本顺序逐步升级而非跨大版本直接跳升,以防止迁移脚本运行失败导致数据库状态不一致。从 Google Photos 迁移时,可使用 Immich 官方的 Google Photos Takeout 导入工具,自动解析 JSON sidecar 文件并还原原始拍摄时间和地理位置信息。

典型使用场景

• 家庭照片库迁移:从 Google Photos 导出后批量导入,保留原始拍摄时间和位置信息,AI 功能重建人物相册和地图分布。
• 多人家庭共享:家庭成员各自备份手机相册,互相共享特定相册,管理员统一管理存储空间和配额。
• 专业摄影师存档:利用外部库功能将已整理的 RAW 文件目录导入 Immich 检索和分享,不改变原有目录结构。

优缺点

• 优点:UI 现代美观接近 Google Photos;AI 语义搜索和人脸识别在开源方案中领先;移动端 App 完善;社区活跃迭代快;原始文件无损保存。
• 缺点:开发阶段活跃、升级破坏性变更风险较高;微服务架构内存建议 4 GB 以上;低功耗设备机器学习推理速度慢;官方明确尚未达到生产就绪状态,建议同时保留独立备份。

在照片管理的实用细节方面,Immich 提供了若干值得关注的功能。时间线视图按拍摄日期将照片分组展示,支持按年月快速跳转,适合浏览多年积累的大型照片库。存储配额管理允许管理员为每位用户设置独立的存储上限,超出后 App 停止上传新照片并在界面提示,防止单一用户耗尽服务器磁盘空间。Immich 的视频处理能力同样完善:上传的视频文件会在后台自动生成缩略图和低分辨率预览流,客户端在浏览时加载预览流而非原始文件,减少带宽消耗;原始视频文件始终完整保留供下载。对于照片的 EXIF 元数据,Immich 提取并展示镜头型号、快门速度、光圈、ISO 感光度等拍摄参数,摄影爱好者可以方便地回溯每张照片的拍摄设置。此外,Immich 支持将相册导出为 ZIP 包下载,方便在平台之间迁移数据或制作本地归档。重复照片检测功能通过比对文件哈希值识别完全相同的副本,避免在服务器上存储冗余文件占用额外空间。整体而言,Immich 在功能丰富度和使用体验上已超越同类开源方案,是目前最接近商业照片管理服务的自托管选择。