关于immich docker-compose.yml配置文件详解

# 指定Docker Compose文件的版本为3.8
version: "3.8"

# 定义项目的名称为immich
name: immich

# 定义多个服务
services:
  # 定义一个服务名为immich-server
  immich-server:
    # 设置容器的名称为immich_server
    container_name: immich_server
    # 从GitHub Container Registry拉取immich-server的镜像，版本由IMMICH_VERSION环境变量指定，默认为release
    image: ghcr.io/immich-app/immich-server:${IMMICH_VERSION:-release}
    # 容器启动后执行的命令
    command: [ "start.sh", "immich" ]
    # 指定挂载的卷
    volumes:
      # 将宿主机的UPLOAD_LOCATION目录挂载到容器的/usr/src/app/upload
      - ${UPLOAD_LOCATION}:/usr/src/app/upload
      # 将宿主机的/etc/localtime挂载到容器中，以只读方式同步时间
      - /etc/localtime:/etc/localtime:ro
    # 指定环境变量文件
    env_file:
      # 使用当前目录下的.env文件
      - .env
    # 指定端口映射
    ports:
      # 将容器的3001端口映射到宿主机的2283端口
      - 2283:3001
    # 定义服务依赖
    depends_on:
      # immich-server依赖于redis和database服务
      - redis
      - database
    # 设置容器的重启策略为始终重启
    restart: always

  # 定义另一个服务名为immich-microservices
  immich-microservices:
    # 设置容器的名称为immich_microservices
    container_name: immich_microservices
    # 使用相同的镜像和版本控制策略
    image: ghcr.io/immich-app/immich-server:${IMMICH_VERSION:-release}
    # 启动微服务的命令
    command: [ "start.sh", "microservices" ]
    # 同样指定挂载的卷
    volumes:
      - ${UPLOAD_LOCATION}:/usr/src/app/upload
      - /etc/localtime:/etc/localtime:ro
    # 使用相同的环境变量文件
    env_file:
      - .env
    # 同样依赖于redis和database服务
    depends_on:
      - redis
      - database
    # 也设置为始终重启
    restart: always

# 以下是定义volumes的部分，用于指定所需的Docker卷
volumes:
  # 定义一个卷名为pgdata，用于持久化PostgreSQL数据库数据
  pgdata:
  # 定义一个卷名为model-cache，用于缓存机器学习模型数据
  model-cache:

# 你可以在这个URL找到所有支持的环境变量的文档：https://immich.app/docs/install/environment-variables
# 上面这一行是注释，说明了如何找到关于所有支持的环境变量的官方文档。

# 你上传的文件将被存储在这个位置
UPLOAD_LOCATION=./library
# 设置`UPLOAD_LOCATION`环境变量，定义了上传文件的存储位置。这里设置为当前目录下的`library`文件夹。

# 使用的Immich版本。你可以将其固定在特定版本，比如 "v1.71.0"
IMMICH_VERSION=release
# 设置`IMMICH_VERSION`环境变量，指定Immich使用的版本。这里设置为`release`，意味着将使用最新的发布版本。

# 用于Postgres的连接密码。你应该将其更改为一个随机密码
DB_PASSWORD=postgres
# 设置`DB_PASSWORD`环境变量，定义连接PostgreSQL数据库的密码。默认设置为`postgres`，建议更改为更安全的密码。

# 以下这行不需要更改
###################################################################################
# 上面这行是注释，表示以下的环境变量通常不需要修改。

DB_HOSTNAME=immich_postgres
# 设置`DB_HOSTNAME`环境变量，指定PostgreSQL数据库服务的主机名。这里使用的是`docker-compose.yml`文件中定义的服务名称`immich_postgres`。

DB_USERNAME=postgres
# 设置`DB_USERNAME`环境变量，定义连接PostgreSQL数据库的用户名。默认设置为`postgres`。

DB_DATABASE_NAME=immich
# 设置`DB_DATABASE_NAME`环境变量，指定PostgreSQL数据库的名称。这里设置为`immich`。

REDIS_HOSTNAME=immich_redis
# 设置`REDIS_HOSTNAME`环境变量，指定Redis服务的主机名。这里使用的是`docker-compose.yml`文件中定义的服务名称`immich_redis`。