飞牛NAS安装Immich应用笔记（更新篇）

Choc · 2025-1-27 19:51:20

飞牛NAS安装Immich应用笔记

Immich 是一款开源的私有化照片备份与管理工具，支持手机自动上传、相册分类、人脸识别等功能。本教程演示如何在飞牛NAS系统中通过Docker部署Immich。

环境准备

飞牛NAS要求
- 系统版本：FN OS 2.0 或更新
- 已安装 Docker 管理器 应用（通过应用中心安装）
- 建议预留至少10GB存储空间
SSH访问（可选）
- 如习惯命令行操作，可在飞牛控制台启用SSH服务并登录

安装步骤

方法一：通过Docker命令行部署

创建存储目录
- 在飞牛NAS文件管理器中新建文件夹，例如：/vol1/1000/docker
- 在此目录下创建子文件夹：
```
/vol1/1000/docker/immich 
/vol1/1000/docker/immich/db
```

创建docker-compose.yml .evn&yml 文件：附件：docker-compose.yml等2个文件.zip

#
# WARNING: Make sure to use the docker-compose.yml of the current release:
#
# https://github.com/immich-app/immich/releases/latest/download/docker-compose.yml
#
# The compose file on main may not be compatible with the latest release.
#

name: immich

services:
  immich-server:
    container_name: immich_server
    image: ghcr.io/immich-app/immich-server:${IMMICH_VERSION:-release}
    # extends:
    #   file: hwaccel.transcoding.yml
    #   service: cpu # set to one of [nvenc, quicksync, rkmpp, vaapi, vaapi-wsl] for accelerated transcoding
    volumes:
      # Do not edit the next line. If you want to change the media storage location on your system, edit the value of UPLOAD_LOCATION in the .env file
      - ${UPLOAD_LOCATION}:/usr/src/app/upload
      - /etc/localtime:/etc/localtime:ro
      - /vol02/1000-4-fab18964/Photo/Photos/PhotoLibrary:/mnt/media/choc #安装路径
    env_file:
      - .env
    ports:
      - '2283:2283'
    depends_on:
      - redis
      - database
    restart: always
    healthcheck:
      disable: false

  immich-machine-learning:
    container_name: immich_machine_learning
    # For hardware acceleration, add one of -[armnn, cuda, openvino] to the image tag.
    # Example tag: ${IMMICH_VERSION:-release}-cuda
    image: ghcr.io/immich-app/immich-machine-learning:${IMMICH_VERSION:-release}
    # extends: # uncomment this section for hardware acceleration - see https://immich.app/docs/features/ml-hardware-acceleration
    #   file: hwaccel.ml.yml
    #   service: cpu # set to one of [armnn, cuda, openvino, openvino-wsl] for accelerated inference - use the `-wsl` version for WSL2 where applicable
    volumes:
      - model-cache:/cache
    env_file:
      - .env
    restart: always
    healthcheck:
      disable: false

  redis:
    container_name: immich_redis
    image: docker.io/redis:6.2-alpine@sha256:eaba718fecd1196d88533de7ba49bf903ad33664a92debb24660a922ecd9cac8
    healthcheck:
      test: redis-cli ping || exit 1
    restart: always

  database:
    container_name: immich_postgres
    image: docker.io/tensorchord/pgvecto-rs:pg14-v0.2.0@sha256:90724186f0a3517cf6914295b5ab410db9ce23190a2d9d0b9dd6463e3fa298f0
    environment:
      POSTGRES_PASSWORD: ${DB_PASSWORD}
      POSTGRES_USER: ${DB_USERNAME}
      POSTGRES_DB: ${DB_DATABASE_NAME}
      POSTGRES_INITDB_ARGS: '--data-checksums'
    volumes:
      # Do not edit the next line. If you want to change the database storage location on your system, edit the value of DB_DATA_LOCATION in the .env file
      - ${DB_DATA_LOCATION}:/var/lib/postgresql/data
    healthcheck:
      test: >-
        pg_isready --dbname="$${POSTGRES_DB}" --username="$${POSTGRES_USER}" || exit 1;
        Chksum="$$(psql --dbname="$${POSTGRES_DB}" --username="$${POSTGRES_USER}" --tuples-only --no-align
        --command='SELECT COALESCE(SUM(checksum_failures), 0) FROM pg_stat_database')";
        echo "checksum failure count is $$Chksum";
        [ "$$Chksum" = '0' ] || exit 1
      interval: 5m
      start_interval: 30s
      start_period: 5m
    command: >-
      postgres
      -c shared_preload_libraries=vectors.so
      -c 'search_path="$$user", public, vectors'
      -c logging_collector=on
      -c max_wal_size=2GB
      -c shared_buffers=512MB
      -c wal_compression=on
    restart: always

volumes:
  model-cache:

创建环境变量文件

# You can find documentation for all the supported env variables at https://immich.app/docs/install/environment-variables

# The location where your uploaded files are stored
UPLOAD_LOCATION=/vol02/1000-4-fab18964/Photo/immich
# The location where your database files are stored
DB_DATA_LOCATION=/vol1/1000/docker/immich/db

# To set a timezone, uncomment the next line and change Etc/UTC to a TZ identifier from this list: https://en.**.org/wiki/List_of_tz_database_time_zones#List
# TZ=Asia/Shanghai

# The Immich version to use. You can pin this to a specific version like "v1.71.0"
IMMICH_VERSION=release

# Connection secret for postgres. You should change it to a random password
# Please use only the characters `A-Za-z0-9`, without special characters or spaces
DB_PASSWORD=postgres

# The values below this line do not need to be changed
###################################################################################
DB_USERNAME=postgres
DB_DATABASE_NAME=immich

启动容器

cd /sharedata/AppData/immich
docker compose up -d

方法二：通过Docker图形界面部署

下载镜像
- 拉取以下镜像：
  - ghcr.io/immich-app/immich-server:release
  - ghcr.io/immich-app/immich-machine-learning:release
  - redis:6.2-alpine
  - postgres:14-alpine
部署PostgreSQL容器
- 卷映射：/sharedata/AppData/immich/database → /var/lib/postgresql/data
- 环境变量：与 .env文件一致
部署Redis容器
- 使用默认配置，网络选择与PostgreSQL相同
部署Immich核心服务
- 按 docker-compose.yml配置映射卷和环境变量

初始化配置

访问Web界面
- 浏览器打开：http://NAS_IP:2283
- 首次运行自动创建管理员账户
手机端配置
- 安装Immich APP（iOS/Android）
- 输入服务器地址：http://NAS_IP:2283
- 开启自动备份

常见问题

端口冲突
- 修改 docker-compose.yml中 2283:3000的左侧端口号
存储权限错误
- 检查 /app/uploads目录是否赋予Docker写入权限
版本更新
- 停止容器 → 删除旧容器 → 重新拉取最新镜像 → 重新部署

进阶配置

域名访问：通过反向代理配置HTTPS（推荐Nginx Proxy Manager）
定时备份：在飞牛任务计划中添加数据库备份任务
硬件加速：配置GPU直通（需飞牛支持）

通过以上步骤，即可在飞牛NAS上搭建私有化的Google Photos替代方案。建议定期检查Immich GitHub仓库获取更新。

༺༼࿅࿆࿄ · 2025-2-10 21:08:14

请问现有照片的目录怎么添加？路径填什么？是在.evn里提前添加，还是在后面设置外部相册里设置路径？特别是路径怎么填写？我一直都报路径错误，谢谢

		自动登录	找回密码
密码			立即注册