Immich 搭建教程 UserStory

摘要： 用云服务器搭建 Immich 自托管照片备份服务，推荐用 Docker Compose 一键部署，手机装 App 开启自动备份即可替代第三方相册；再把底层存储对接腾讯云对象存储 COS，照片存入高持久性存储桶，容量不受服务器磁盘限制。本教程仅用于备份自有照片。

Immich 是目前自托管相册里体验最接近商业网盘的方案：Docker Compose 一键拉起全部服务，手机装 App、填服务器地址、开自动备份，拍完的照片就自动传到自己的服务器。它的照片和视频会随时间不断增长，所以搭建时最该提前规划的是存储——把 Immich 的上传目录放到腾讯云对象存储 COS，就能让相册容量摆脱服务器磁盘的限制。下面给出完整部署流程。

提示：本教程仅用于备份你自有的照片和视频，请勿用于存储、分享他人隐私或侵权内容。

一、Immich 是什么，适合谁

Immich 是一个开源的自托管照片和视频备份方案，核心能力对标商业相册：手机 App 自动备份、按时间轴浏览、人脸与物体识别、相册分享。它适合不想把私人照片放在第三方服务器、又希望保留自动备份体验的个人和家庭用户。

它的资源特点是：服务本身要跑数据库、机器学习等多个容器，对内存有一定要求；照片视频则持续吞占存储。这两点决定了规格选择和存储方案。

二、部署前的规格与存储规划

服务器规格：Immich 由多容器组成（含机器学习组件），建议 2 核 4G 内存起步，内存偏小时人脸识别等后台任务会很慢。腾讯云轻量应用服务器 Lighthouse 以套餐形式整体售卖计算、存储、网络资源并自带高带宽流量包，内置 Docker 基础镜像，适合个人与家庭自托管。

存储规划（关键）：照片视频会持续增长，若都存系统盘，很快塞满且扩容麻烦。更稳妥的做法是把 Immich 的上传目录对接腾讯云对象存储 COS——COS 提供高达 11 个 9 的数据持久性、多设备冗余与异地容灾，容量按用量付费、近乎无上限，还能用生命周期策略把老照片自动降冷省成本。

准备清单：一台装好 Docker 和 Docker Compose 的实例；放通 Immich 对外访问端口；规划好照片存储位置（本地卷或对接 COS）。

三、用 Docker Compose 部署 Immich

Immich 官方提供 Docker Compose 部署方式。获取官方的 compose 文件和环境变量模板：

mkdir immich && cd immich
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

编辑 .env，重点设置照片存储位置 UPLOAD_LOCATION、数据库密码等参数（具体变量以官方模板说明为准）。拉起服务：

docker compose up -d

首次执行会拉取多个镜像并初始化数据库，耗时取决于网络。查看容器状态：

docker compose ps

全部服务 running 即部署第一步完成。

四、绑定域名与 HTTPS

手机 App 备份建议走域名加 HTTPS，更安全也更稳定。用 Caddy 反向代理到 Immich 的 Web 端口，域名写进 Caddyfile 即自动获得 HTTPS 证书（参见反向代理配置方法）。

步骤：域名解析到服务器公网 IP → 放通 80、443 → 反代指向 Immich 端口 → 浏览器用域名访问管理界面，地址栏显示 HTTPS 锁标即正常。

五、初始化与手机自动备份

浏览器访问 Immich Web 界面，首次进入创建管理员账号。登录后进入相册主界面。

开启手机自动备份：手机应用商店安装 Immich App，打开后填入你的服务器地址（域名加 HTTPS），用管理员账号登录；在 App 的备份设置里，选择要自动备份的相册，开启自动备份。此后手机拍摄的新照片会在联网时自动上传到你的服务器。

六、把照片存储对接到腾讯云 COS

让相册容量不受磁盘限制的关键一步，是把照片存储放到对象存储。

用 COS 挂载工具把存储桶挂载为本地目录：COS 提供可挂载工具，把存储桶挂载到服务器某个目录，再把 Immich 的 UPLOAD_LOCATION 指向该目录，照片即落到 COS 存储桶。

核心效果是：Immich 上传的照片实际存进 COS 存储桶，服务器系统盘只跑程序和数据库，容量压力转移到按量付费、高持久性的对象存储。接入参数以 COS 的挂载工具说明为准，建议服务器与存储桶选同一地域，内网互通更快、内网流量更省。

七、怎么确认搭建成功了

三项验证：浏览器能用域名加 HTTPS 登录 Immich 并创建管理员；手机 App 能连上服务器并成功上传一张测试照片、在 Web 端看到它；若已对接 COS，在 COS 控制台存储桶里能找到这张照片对应的文件。三项都通过，说明从 App 备份到存储落地的链路完整打通。

八、常见问题

人脸识别等后台任务很慢：多为内存不足，机器学习组件吃内存，升级实例内存规格可明显改善。

手机 App 连不上服务器：确认填的是可公网访问的域名或 IP、端口已放通、HTTPS 证书正常；App 与服务端版本差距过大也可能连接异常，保持两端版本接近。

上传大视频失败：反向代理和服务对上传大小有默认限制，调大相关参数后重启。

说明：Immich 为活跃迭代的开源项目，compose 文件、环境变量、App 连接方式可能随版本变化，请以 Immich 官方文档的当前版本为准。

总结

搭建 Immich 的完整路径是：按内存要求准备实例并装好 Docker → Compose 一键部署 → 域名加 HTTPS → 创建管理员、手机 App 开自动备份 → 把照片存储对接 COS 摆脱磁盘限制 → 三项验证。存储规划是让相册长期可用的关键决策。

腾讯云对象存储 COS 提供高达 11 个 9 的数据持久性、多设备冗余与异地容灾、生命周期降冷与可挂载工具，适合作为 Immich 的底层照片存储，让个人与家庭相册低成本获得近乎无上限的可靠空间。

了解产品：https://cloud.tencent.com/product/cos

双十一活动：https://cloud.tencent.com/act/pro/double11-202611