主机资讯与使用指南

Immich 部署教程：Docker Compose、照片上传与持久化

按 Immich 当前官方 Compose 安装方式部署相册，配置文件库、数据库、域名入口和客户端上传。

配置先满足当前要求

官方目前列出至少 6GB 内存、2 核 CPU，建议 8GB、4 核。机器学习容器在 amd64 的 v3 环境还要求 x86-64-v2；虚拟机需要提供相应 CPU 指令集。

数据库放本地 SSD，照片文件库另留足够容量。缩略图和转码会增加空间，不能只按原图大小选择磁盘。以下采用 Linux、Docker Engine 与 Compose 插件，已经有环境可继续操作。

下载同一发布版本的配置

mkdir -p "$HOME/immich-app"
cd "$HOME/immich-app"
curl -fL https://github.com/immich-app/immich/releases/latest/download/docker-compose.yml -o docker-compose.yml
curl -fL https://github.com/immich-app/immich/releases/latest/download/example.env -o .env
chmod 600 .env

两份文件来自同一版本发布资产。长期使用时保存这次下载的文件和版本记录；升级时按对应发布说明更新，配置文件与镜像版本应保持匹配。

修改存储目录与数据库密码

编辑 .env，将 UPLOAD_LOCATION 指向有足够空间的文件库目录，DB_DATA_LOCATION 指向本地数据库目录。两个目录承担不同数据，数据库目录不要放在网络共享中。

DB_PASSWORD 使用随机的字母或数字串，例如执行 openssl rand -hex 24 生成。按该发布文件保留数据库镜像和必需扩展，不把它随意替换成普通 PostgreSQL。

在 docker-compose.yml 中检查 immich-server 的端口映射。准备使用宿主机 Caddy 时，将原映射改为 127.0.0.1:2283:2283，保留文件中的其他设置。

启动并绑定域名

docker compose config --quiet
docker compose up -d
docker compose ps
docker compose logs --tail=100 immich-server

使用 photos.example.com 域名指向服务器，并在宿主机 Caddy 建立入口；域名需改成自己的。

photos.example.com {
    reverse_proxy 127.0.0.1:2283
}

确认域名 HTTPS 能打开初始化页，再创建第一个管理员。未出现页面时查看数据库、服务状态和代理日志，不反复重置数据目录。

上传、客户端和备份

先上传少量照片，确认原图、缩略图和下载正常，再导入整份相册。在手机客户端填写同一个 HTTPS 服务地址，登录后选择需要备份的相册。

备份同时保存照片文件库、数据库备份以及配置。数据库记录文件、相册和用户关系，仅保留图片目录不能恢复全部功能；应用升级前保存可恢复的副本。