Immich 中文文档:自托管照片备份从部署到日常使用的完整指南
关于本站:第三方整理的中文文档站,非官方页面;内容来自公开资料整理,功能与界面以官方最新版为准。
Immich 做的事一句话就能说清:让你在自己的服务器上,拥有一套体验接近主流云相册的照片备份、浏览和搜索系统。手机里的照片自动传到家里那台机器上,原始文件永远在自己手里,不需要把几十 GB 的私人影像托付给任何第三方。
但它和普通手机应用有个根本区别:手机上的 Immich App 只是一个入口,背后必须有一台跑着 Immich 服务的机器。所以本站的行文顺序不是「装了就能用」,而是按真实的部署动线走完一整圈:
- 先弄明白它是什么——和云相册到底差在哪,要不要折腾(认识组);
- 把服务器装起来——Docker Compose 五分钟拉起服务,注册第一个管理员账号(服务器准备组);
- 手机连上开始备份——装 App、填服务器地址、选相册、开启自动备份(手机 App 组);
- 照片进来之后——语义搜索、人脸聚类、地图、标签、编辑,把几万张照片理顺(照片整理组);
- 一家人一起用——共享相册、伴侣共享、公开链接、给家人开账号(分享协作组);
- 保住这些数据——数据库备份、恢复演练、硬件转码、从谷歌相册搬家(运维进阶组)。
产品档案速览
| 项目 | 说明 |
|---|---|
| 软件形态 | 服务器端(Docker 部署)+ 网页端 + 手机 App 三件套 |
| 功能定位 | 自托管照片/视频自动备份、浏览、搜索、分享 |
| 最新版本 | v3.3.0(2026 年 10 月 7 日发布,以官方发布页为准) |
| 开源许可 | GNU AGPL v3,代码托管在 GitHub |
| 开发背景 | 2024 年 5 月起由 FUTO 支持全职团队开发 |
| 部署门槛 | 建议 2 核 CPU、6GB 内存起步,需安装 Docker |
| 服务端口 | 默认 2283 |
| 手机端渠道 | 安卓 APK、Google Play、App Store、F-Droid |
| 机器学习 | 本地运行 CLIP 语义搜索与人脸识别,可整体关闭 |
| 安卓安装包 | 本站顶部「下载」按钮提供网盘转存入口 |
从这里开始读
- 完全没接触过自托管?先看 Immich 是什么:自托管照片备份方案入门,再读 和云相册对比:照片放在自己服务器意味着什么。
- 已经决定折腾?直接进 硬件要求:什么配置的机器能跑得动,然后跟着 Docker Compose 部署完整流程 走。
- 服务器已经装好?手机端从 安卓安装包从哪里下载最可靠 开始。
- 顺手收藏:数据库备份与恢复 是自托管用户迟早要用的一页。