威联通nas安装使用immich相册详细教程

一、准备工作

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/