Immich 自托管照片管理 5 分钟上手：自动备份并整理手机照片
【免费下载链接】immichHigh performance self-hosted photo and video management solution.项目地址: https://gitcode.com/GitHub_Trending/im/immich
去年家庭旅行的照片，翻了手机十几个相册还是没找到——Immich 就是为解决这类问题做的：它是一个自托管的照片和视频管理方案，部署在自己服务器上后，手机里的照片会自动备份进去，再由 AI 自动识别人物、场景和地点，让你按条件把照片搜出来。
Immich 和云相册服务差在哪
商业云相册把媒体文件放在厂商的服务器上，而 Immich 把所有东西都放在你自己的硬盘里——家用服务器、NAS 或一台便宜的 VPS 都行。带来的差别很直接：
- 数据在自己手里：文件存在自己的存储上，谁能看、能不能下载都由你定，不用担心中途停服或隐私外泄；
- 多端一致：Web、移动应用和命令行工具连的是同一个服务器，相册数据处处相同；
- 开源免费：AGPLv3 许可，功能由社区持续维护。
它能替你干成的三件事
手机照片备份：自动上传，不占流量
移动应用里开启备份后，新拍的照片和视频会在后台自动传到服务器，只上传新文件（增量备份），可以限制仅 Wi-Fi 下传输，应用切到后台也能继续。多台设备同步到同一个图库，相册也能双向同步回手机，相当于给手机相册做了一份不在手机上的副本。
找照片：停止翻相册，开始搜
服务器侧的机器学习服务（源码在 machine-learning/ 目录）会对每份上传的照片做分析：
- 人脸识别：自动把画面中的人聚类成"人物"，想找"谁"的时候直接按人翻；
- 场景与物体识别，以及 OCR 提取图片里的文字；
- 叠加时间、地点、相机型号、自定义标签做多维筛选；
- 也可以自己打标签，慢慢搭出一套只属于你的分类体系。
分享：给家人一个共享图库
伙伴共享（Partner Sharing）让两个账号互相开放媒体库，适合伴侣或家庭共用一个相册；不想开放全部库时，也可以只选几张图生成公开链接分享出去，权限范围由你控制。
5 分钟上手：用 Docker Compose 启动 Immich
前提：一台装好 Docker 与 Docker Compose 的机器。
- 拿到部署文件：仓库里的 docker/docker-compose.yml 是标准入口，可先克隆仓库（
git clone https://gitcode.com/GitHub_Trending/im/immich）； - 按 docker/example.env 建好
.env，把UPLOAD_LOCATION指到你想存放照片的目录； - 在 compose 文件所在目录执行：
docker compose up -d- 浏览器打开
http://localhost:2283，创建第一个管理员账号，再用移动应用登录绑定即可。
compose 文件一次拉起 4 个容器：服务器、机器学习、Redis 和 PostgreSQL，细节见 Docker Compose 安装文档。
进阶与调优：规模化部署要注意什么
官方给出的硬件参考：
- 小型（家庭照片）：2 核 / 4GB / 100GB
- 中型（数 TB 视频）：4 核 / 8GB / 1TB
- 大型：8 核 / 16GB / 10TB 以上
几个值得花时间的点：
- 数据库放 SSD 上速度明显更好；若确实只能用 HDD，可在环境里设置
DB_STORAGE_TYPE: HDD； - 暴露到公网时，前面挂反向代理并启用 HTTPS，用户权限按人配置；
- 管理面板的 Server Stats 能看到每个用户的存储占用，方便规划容量；
- 定期备份数据库与媒体目录，数据安全的底线永远是 3-2-1 策略：至少一份异地副本。
Immich 适合谁
- 个人与家庭用户：手机自动备份 + 家人共享一个图库；
- 小团队：工作素材集中存储、按需分享；
- NAS / 家庭实验室用户：想要一个自托管的云相册替代方案；
- 在意隐私的人：不想把个人照片视频放到第三方云端。
文档与资源入口
- 官方文档：安装、配置与功能说明
- 服务器源码：API 与业务逻辑
- AI 功能源码：人脸识别、场景分类等模型
- OpenAPI 规范：对接第三方工具
- FAQ 与 开发者指南
Immich 把"备份照片"和"整理照片"变成了两件可以自动同时发生的事：前者保证数据在，后者保证找得到。
💡 上手小建议：部署完成后，先按 3-2-1 策略给数据库和媒体目录配一份异地备份，再开始批量导入照片。
【免费下载链接】immichHigh performance self-hosted photo and video management solution.项目地址: https://gitcode.com/GitHub_Trending/im/immich
创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
