一、准备工作
1、先创建3个目录
Photos 即外部图库,里面存放NAS上的照片,将以只读权限映射进容器中的/mnt/Photos:ro目录(避免误删或缓存污染,移除:ro可取消只读)
upload 是immich要使用的
geodata 反向地理编码汉化,不解解析出来的经纬度信息是英文的

2、下载geodata 反向地理编码汉化2个包
https://github.com/ZingLix/immich-geodata-cn/releases/tag/auto-release
#我使用的geodata_admin_2_admin_3_admin_4.zip包,定位可以精确到市、县(区)、镇;
#如果只想精确到市,选择geodata.zip(精简包)或geodata_full.zip(增强包,可能显示慢)。
3、在Public下建geodata目录
将geodata.zip和i18n-iso-countries.zip解压后丢进去

4、挂载核显(如下即支持,本步骤可忽略,应该都没问题)

二、通过容器创建应用
1、创建应用

docker.yaml文件
version: "2.1"
services:
immich-server:
image: ghcr.io/immich-app/immich-server:release
container_name: immich_server
environment:
# 基础配置
- PUID=1000
- PGID=1000
- TZ=Asia/Shanghai
# 数据库配置
- DB_HOSTNAME=database
- DB_USERNAME=postgres
- DB_PASSWORD=postgres
- DB_DATABASE_NAME=immich
# Redis配置
- REDIS_HOSTNAME=redis
- DB_PORT=5432
- REDIS_PORT=6379
# 存储配置
- UPLOAD_LOCATION=/usr/src/app/upload # 主存储路径(必须与下方挂载路径一致)
- IMMICH_WATCH_FOLDERS=/mnt/photos # 外部库监控路径
volumes:
# 主存储目录,即手动上传的照片目录(Immich可读写)
- /share/Public/upload:/usr/src/app/upload:z
# 外部照片库,即Nas上的照片目录(只读模式)
- /share/Public/Photos:/mnt/Photos:ro
# 系统时区
- /etc/localtime:/etc/localtime:ro
# 反向地理编码汉化
- /share/Public/geodata:/build/geodata
- /share/Public/geodata/i18n-iso-countries/langs:/usr/src/app/node_modules/i18n-iso-countries/langs
# 开启核显转码加速
- /dev/dri:/dev/dri
ports:
- "2283:2283" # Web访问端口
networks:
- immich
depends_on:
- redis
- database
restart: unless-stopped
immich-machine-learning:
image: ghcr.io/immich-app/immich-machine-learning:release
container_name: immich_machine_learning
environment:
- DB_HOSTNAME=database
- DB_USERNAME=postgres
- DB_PASSWORD=postgres
- DB_DATABASE_NAME=immich
volumes:
- /share/Container/immich/model-cache:/cache # 直接路径挂载(威联通兼容)
networks:
- immich
restart: unless-stopped
redis:
image: redis:6.2-alpine
container_name: immich_redis
ports:
- "6379:6379"
networks:
- immich
restart: unless-stopped
database:
image: tensorchord/pgvecto-rs:pg14-v0.2.0
container_name: immich_postgres
environment:
- POSTGRES_USER=postgres
- POSTGRES_PASSWORD=postgres
- POSTGRES_DB=immich
volumes:
- /share/Container/immich/postgres:/var/lib/postgresql/data
ports:
- "5432:5432"
networks:
- immich
restart: unless-stopped
networks:
immich:
driver: bridge
2、查看日志,如果没报错,完成后即可登录

如果2283端口无法访问,检查日志中是否有红色报错,排查挂载的路径,删除容器应用及目录(/share/Container/immich/),然后重新创建应用。
三、使用immich
1、登录相册,创建账号【http://本地IP:2283】

2、外部图库管理
将NAS上的图片直接导入immich,无需再手工上传,击右上角的个人图像,选择“管理”,
然后“创建图库”,填写“路径”



3、打开硬件加速
来到【设置】-【视频转码设置】,打开【硬件加速】-【加速器API】-【快速同步(Quick Sync)】就ok了,记得保存哦

4、部分功能展示



参考:
immich 人脸识别/中文搜索/AI大模型使用:https://post.smzdm.com/p/am3ozgx4/
immich 反向地理编码汉化-将地图显示为国家、省份、城市: https://post.smzdm.com/p/aoql5z86/
immich 相册地图模块设置为中文地图: https://post.smzdm.com/p/akl59689/