TimeAmber
剪藏#KuaiZApp#剪藏

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

2026 年 5 月 30 日 约 1 分钟
分享Twitter / XTelegram微博
10万+ Star！这个开源项目让你拥有自己的私有云相册 封面

🔥 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

相关文章