剪藏#KuaiZApp#剪藏

10万+ Star!这个开源项目让你拥有自己的私有云相册

2026 年 5 月 30 日1 分钟
分享Twitter / XTelegram微博

🔥 GITHUB TRENDING

10万+ Star!这个开源项目让你拥有自己的私有云相册

100k ★ | TypeScript + Dart | immich-app/immich

10万+ Star!这个开源项目让你拥有自己的私有云相册

开篇:Google Photos的隐私困境

你有没有这样的焦虑:

• 手机照片视频越来越多,iCloud/Google Photos 空间不够用

• 担心隐私泄露,不想把珍贵回忆上传到科技巨头的服务器

• Google Photos 开始收费,iCloud 空间续费压力大

• 想自己搭建私有云相册,但Nextcloud太重,配置复杂

Immich 就是为了解决这个问题而生的。

它是一个高性能的自托管照片和视频管理解决方案,类似Google Photos,但数据完全在你自己手里。10万+ Star,Docker一键部署,手机App自动备份,人脸识别,地图浏览……该有的功能都有。

GitHub:https://github.com/immich-app/immich

Stars:100,000+(截至2026年5月)

语言:TypeScript + Dart

License:AGPL-3.0

演示地址:https://demo.immich.app

核心功能:媲美Google Photos的体验

功能特性一览

功能 移动端 网页端
上传并查看照片和视频
后台自动备份 N/A
选择需要备份的相册 N/A
下载照片和视频到本地
多用户支持
相册与共享相册
支持RAW格式
元数据视图(EXIF、地图)
通过元数据、对象、人脸和标签搜索
人脸识别与分组
回忆(那年今日)
足迹地图
OAuth支持

技术亮点

  1. 高性能:基于Rust的图像处理引擎,缩略图生成飞快

  2. 机器学习:人脸识别、物体检测、场景分类(可调用本地GPU)

  3. 跨平台:iOS/Android App + Web端,数据实时同步

  4. 存储灵活:支持本地存储、SMB/NFS挂载、S3兼容存储

  5. 多用户:家人朋友共享相册,权限管理完善

安装部署:Docker Compose一键启动

环境要求

• 服务器:2核4G以上(推荐4核8G)

• 存储:根据照片量决定,推荐RAID1冗余

• 系统:支持Docker的任何系统(Linux/macOS/Windows)

• 网络:家庭宽带公网IP,或配合FRP内网穿透

快速部署(Docker Compose)

第一步:下载部署文件

JAVASCRIPT
mkdir -p ./immich
cd ./immich

# 下载 docker-compose.yml 和 .env 文件
wget https://github.com/immich-app/immich/releases/latest/download/docker-compose.yml
wget -O .env https://github.com/immich-app/immich/releases/latest/download/example.env

# 或者手动从 Release 页面下载
# https://github.com/immich-app/immich/releases

第二步:修改配置文件

编辑 .env 文件,关键配置项:

JAVASCRIPT
# 上传文件存储位置(重要!)
UPLOAD_LOCATION=./library

# 数据库存储位置
DB_DATA_LOCATION=./postgres

# 时区设置(改为你的时区)
TZ=Asia/Shanghai

# 数据库连接URL(默认即可)
DB_URL=postgresql://postgres:postgres@database:5432/immich

# Redis连接(默认即可)
REDIS_URL=redis://redis:6379

第三步:启动服务

JAVASCRIPT
docker compose up -d

访问 http://你的服务器IP:2283 即可看到Immich界面。

第四步:创建管理员账号

首次访问会要求注册管理员账号,注册后其他人可以通过"邀请链接"加入。

升级更新

JAVASCRIPT
cd ./immich
docker compose pull
docker compose up -d

使用教程:从备份到智能管理

1. 手机端自动备份

iOS安装:App Store 搜索 "Immich" 下载

Android安装:Google Play 或 F-Droid 搜索 "Immich"

配置备份

  1. 打开App,输入服务器地址(http://你的IP:2283

  2. 登录账号

  3. 进入"设置" → "备份"

  4. 选择要备份的相册(可选择"所有"或指定相册)

  5. 开启"后台备份"

之后,只要手机连接WiFi(可配置是否用流量),新照片就会自动上传到你的服务器。

2. 网页端管理

访问 http://你的IP:2283,登录后可以看到:

时间轴视图:按日期浏览所有照片

相册管理:创建相册,手动或智能分类

搜索功能:按人物、地点、物体搜索照片

地图视图:在地图上查看照片拍摄位置

共享相册:与家人朋友共享特定照片/相册

3. 人脸识别与分组

Immich 使用机器学习模型进行人脸识别(需要CPU/GPU算力):

  1. 进入"设置" → "机器学习"

  2. 开启"人脸识别"

  3. 系统会自动扫描所有人脸并分组

  4. 你可以为每个人脸分组命名(如"张三")

  5. 之后搜索"张三",就能找到所有包含他的照片

4. 外部库(高级功能)

如果你已经有大量照片存储在服务器其他目录,可以通过"外部库"功能挂载:

  1. 修改 docker-compose.yml,添加卷映射

  2. 在管理后台添加"外部库路径"

  3. Immich会扫描该路径下的照片并纳入管理

实战场景:家庭相册、团队共享、隐私保护

场景1:家庭私有云相册

需求:家人手机照片自动备份,不依赖Google Photos/iCloud,数据自己掌控。

方案

  1. 家里放一台NAS或旧电脑,安装Immich

  2. 配置DDNS(如花生壳)或FRP内网穿透,实现外网访问

  3. 全家人的手机都安装Immich App,自动备份

  4. 创建"家庭相册",共享宝宝的成长照片

成本:一台旧笔记本(或树莓派4B)+ 硬盘 = 0元(利用闲置设备)

场景2:摄影爱好者照片管理

需求:摄影师有大量RAW格式照片,需要快速预览、分类、搜索。

方案

  1. 高性能服务器(4核8G + GPU)部署Immich

  2. 开启机器学习功能(物体识别、场景分类)

  3. 上传RAW照片,Immich自动生成缩略图

  4. 通过"外部库"挂载已有照片目录

  5. 利用搜索功能快速找到"海边日落"、"人像"等主题照片

场景3:小团队素材管理

需求:设计团队需要共享素材照片,但不想上传到公共云。

方案

  1. 公司服务器部署Immich

  2. 创建团队账号,设置权限

  3. 设计师上传素材,打标签

  4. 其他人通过搜索/相册快速找到需要的素材

对比其他方案:为什么选Immich?

方案 Star数 自托管 手机App 人脸识别 存储成本 适合场景
Immich 100k+ ✅ 原生 自己硬盘 隐私敏感、大量照片
Google Photos N/A 订阅制 普通用户、不差钱
Nextcloud 25k+ 自己硬盘 全能型(不仅相册)
PhotoPrism 34k+ ⚠️ 第三方 自己硬盘 专业摄影管理
Synology Photos N/A 买NAS 群晖用户

核心优势

  1. 专为照片设计:比Nextcloud更专注,体验更好

  2. 开源免费:AGPL-3.0协议,代码透明

  3. 社区活跃:100k+ Star,问题响应快

  4. 部署简单:Docker Compose一键启动,比PhotoPrism配置简单

  5. 功能完整:该有的都有(人脸识别、地图、共享相册)

踩坑提示:这些地方要注意

⚠️ 注意:

1. 数据库不要用网络存储

PostgreSQL数据库必须存储在本地磁盘或高性能块存储,NFS/SMB挂载会导致性能极差甚至数据损坏。

⚠️ 注意:

2. 机器学习需要算力

人脸识别、物体检测等功能需要CPU/GPU算力,树莓派等低性能设备可能无法开启这些功能。

💡 提示:

3. 外网访问需要配置

如果要在外网访问家里的Immich,需要配置DDNS或FRP内网穿透。推荐方案:

• 有公网IP:配置DDNS(如花生壳、DuckDNS)

• 无公网IP:使用FRP或Tailscale组网

ℹ️ 信息:

4. 存储要提前规划

照片视频很占空间,建议:

• 使用RAID1(镜像)防止硬盘损坏

• 定期备份数据库(PostgreSQL数据)

• 考虑接入S3兼容存储(如MinIO)实现扩容

⚠️ 注意:

5. 升级前一定要备份

虽然Immich升级通常很顺利,但数据库结构可能变化。升级前务必备份:

JAVASCRIPT
# 备份数据库
docker exec immich_postgres pg_dump -U postgres immich > backup.sql

# 备份配置文件
cp -r ./immich ./immich_backup

总结:隐私与便利兼得的开源方案

Immich 解决了摄影爱好者和隐私敏感用户的一个核心痛点:如何在不依赖科技巨头的前提下,拥有媲美Google Photos的相册管理体验

核心价值

  1. 隐私保护:数据完全在自己手里,不怕泄露

  2. 成本可控:一次部署,无限存储(取决于硬盘大小)

  3. 功能完整:自动备份、人脸识别、地图浏览、共享相册一应俱全

  4. 开源活跃:100k+ Star,社区活跃,持续更新

如果你符合以下任一情况,强烈推荐试试Immich:

• 担心Google Photos/iCloud隐私泄露

• 照片视频太多,云存储订阅费用高

• 有闲置服务器/NAS,想充分利用

• 是摄影爱好者,需要专业的管理功能

项目链接

https://github.com/immich-app/immich

官方文档

https://docs.immich.app

Demo体验(无需安装):

https://demo.immich.app

账号:demo@immich.app

密码:demo

相关阅读

• Docker一键部署Immich:自建私有云相册

• 如何快速掌握Immich:从数据备份到智能管理

本文首发于公众号「kuaizapp技术博客」,转载请注明出处。

原文地址: https://mp.weixin.qq.com/s?__biz=MzU4MTgxNTk2Nw==&mid=2247484598&idx=1&sn=73935670739121fc59ce1257957bf1b1&chksm=fc759b42fc17c3988fdb86f239cc079ca1641d35cac022de2bb4295ef5edc13eec26d7b49fe0&mpshare=1&scene=1&srcid=0530E6RC8GapFNCw6tChrloR&sharer_shareinfo=14411a51d67014e68432f49748bcbee4&sharer_shareinfo_first=14411a51d67014e68432f49748bcbee4#rd

相关文章