93
33
极空间NAS部署Immich照片备份——完整操作步骤，替代iCloud
2026-02-28 15:50:33
0点赞
0收藏
0评论
Immich是开源免费的照片备份工具，支持人脸识别、自然语言搜索。下面是在极空间NAS上的部署步骤。
一、环境要求
极空间NAS，已开启Docker功能
至少4GB内存（Immich需要postgres和redis）
Docker引擎20.10以上
二、配置镜像加速
国内拉Docker Hub镜像容易超时，需先配加速器。
操作路径：极空间Docker管理界面 → 镜像仓库 → 加速器配置
加速地址填：https://docker.xuanyuan.me
保存后等Docker服务重启。
三、获取Immich的Compose配置
访问Immich官方文档（github.com/immich-app/immich），找到docker-compose.yml示例文件。
或直接使用以下简化版配置（需根据实际情况调整路径）：
version: "3.8"
services:
immich-server:
container_name: immich_server
image: ghcr.io/immich-app/immich-server:release
volumes:
- /极空间上传文件夹路径:/usr/src/app/upload
env_file:
- .env
ports:
- 2283:3001
depends_on:
- redis
- database
restart: always
immich-machine-learning:
container_name: immich_machine_learning
image: ghcr.io/immich-app/immich-machine-learning:release
volumes:
- /极空间缓存路径:/cache
env_file:
- .env
restart: always
redis:
container_name: immich_redis
image: redis:6.2-alpine
restart: always
database:
container_name: immich_postgres
image: tensorchord/pgvecto-rs:pg14-v0.2.0
env_file:
- .env
environment:
POSTGRES_PASSWORD: postgres
POSTGRES_USER: postgres
POSTGRES_DB: immich
volumes:
- /极空间数据库路径:/var/lib/postgresql/data
restart: always
四、创建.env配置文件
在compose文件同目录创建.env文件，填入以下内容：
DB_HOSTNAME=database
DB_USERNAME=postgres
DB_PASSWORD=postgres
DB_DATABASE_NAME=immich
REDIS_HOSTNAME=redis
五、部署Immich
操作路径：极空间Docker管理界面 → Compose部署 → 新建项目
项目名：immich
粘贴上述compose配置，点击部署。等待所有容器状态变为"运行中"。
首次部署需拉取多个镜像（immich-server、immich-machine-learning、postgres、redis），耗时较长，约5-10分钟。
六、首次设置
浏览器访问 http://极空间IP:2283
首次打开会要求创建管理员账号，填入邮箱和密码。
登录后进入设置，配置存储路径、备份策略等。
七、手机端配置
iPhone/Android： 应用商店搜索"Immich"，安装App。
App里填入服务器地址（http://极空间IP:2283），登录刚才创建的账号。
进入设置，开启自动备份，选择要备份的相册，设置仅WiFi备份或允许移动数据。
八、常见问题
部署后打不开2283端口： 检查容器是否全部正常运行，查看immich-server容器日志排查。
照片上传失败： 检查极空间上的上传文件夹路径是否正确、权限是否足够。
机器学习容器启动失败： 极空间内存不足时，immich-machine-learning容器可能启动失败。可以暂时不启动这个容器，人脸识别等AI功能会不可用，但基础备份功能正常。
外网访问： Immich默认只能局域网访问。需要外网访问时，可配合内网穿透工具（如星空组网，免费版支持约20台设备，P2P直连，缺点是每台设备要装客户端）或各品牌NAS的官方远程访问功能。
九、和iCloud对比
容量： iCloud 50GB年费68元，200GB年费198元。NAS容量取决于硬盘大小，一次性投入。
速度： 局域网内备份速度远快于iCloud，外网取决于网络环境。
隐私： NAS数据完全自己掌控，iCloud存在云端。
便利性： iCloud无需配置，Immich需要自己部署和维护。
Immich适合有NAS、愿意折腾、在意数据隐私的用户。只想简单备份、不想折腾的，直接用iCloud或各品牌NAS自带相册更省心。
作者声明本文无利益相关，欢迎值友理性交流，和谐讨论~
