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

# 定義項(xiàng)目的名稱為immich
name: immich

# 定義多個(gè)服務(wù)
services:
  # 定義一個(gè)服務(wù)名為immich-server
  immich-server:
    # 設(shè)置容器的名稱為immich_server
    container_name: immich_server
    # 從GitHub Container Registry拉取immich-server的鏡像，版本由IMMICH_VERSION環(huán)境變量指定，默認(rèn)為release
    image: ghcr.io/immich-app/immich-server:${IMMICH_VERSION:-release}
    # 容器啟動后執(zhí)行的命令
    command: [ "start.sh", "immich" ]
    # 指定掛載的卷
    volumes:
      # 將宿主機(jī)的UPLOAD_LOCATION目錄掛載到容器的/usr/src/app/upload
      - ${UPLOAD_LOCATION}:/usr/src/app/upload
      # 將宿主機(jī)的/etc/localtime掛載到容器中，以只讀方式同步時(shí)間
      - /etc/localtime:/etc/localtime:ro
    # 指定環(huán)境變量文件
    env_file:
      # 使用當(dāng)前目錄下的.env文件
      - .env
    # 指定端口映射
    ports:
      # 將容器的3001端口映射到宿主機(jī)的2283端口
      - 2283:3001
    # 定義服務(wù)依賴
    depends_on:
      # immich-server依賴于redis和database服務(wù)
      - redis
      - database
    # 設(shè)置容器的重啟策略為始終重啟
    restart: always

  # 定義另一個(gè)服務(wù)名為immich-microservices
  immich-microservices:
    # 設(shè)置容器的名稱為immich_microservices
    container_name: immich_microservices
    # 使用相同的鏡像和版本控制策略
    image: ghcr.io/immich-app/immich-server:${IMMICH_VERSION:-release}
    # 啟動微服務(wù)的命令
    command: [ "start.sh", "microservices" ]
    # 同樣指定掛載的卷
    volumes:
      - ${UPLOAD_LOCATION}:/usr/src/app/upload
      - /etc/localtime:/etc/localtime:ro
    # 使用相同的環(huán)境變量文件
    env_file:
      - .env
    # 同樣依賴于redis和database服務(wù)
    depends_on:
      - redis
      - database
    # 也設(shè)置為始終重啟
    restart: always

# 以下是定義volumes的部分，用于指定所需的Docker卷
volumes:
  # 定義一個(gè)卷名為pgdata，用于持久化PostgreSQL數(shù)據(jù)庫數(shù)據(jù)
  pgdata:
  # 定義一個(gè)卷名為model-cache，用于緩存機(jī)器學(xué)習(xí)模型數(shù)據(jù)
  model-cache:

# 你可以在這個(gè)URL找到所有支持的環(huán)境變量的文檔：https://immich.app/docs/install/environment-variables
# 上面這一行是注釋，說明了如何找到關(guān)于所有支持的環(huán)境變量的官方文檔。

# 你上傳的文件將被存儲在這個(gè)位置
UPLOAD_LOCATION=./library
# 設(shè)置`UPLOAD_LOCATION`環(huán)境變量，定義了上傳文件的存儲位置。這里設(shè)置為當(dāng)前目錄下的`library`文件夾。

# 使用的Immich版本。你可以將其固定在特定版本，比如 "v1.71.0"
IMMICH_VERSION=release
# 設(shè)置`IMMICH_VERSION`環(huán)境變量，指定Immich使用的版本。這里設(shè)置為`release`，意味著將使用最新的發(fā)布版本。

# 用于Postgres的連接密碼。你應(yīng)該將其更改為一個(gè)隨機(jī)密碼
DB_PASSWORD=postgres
# 設(shè)置`DB_PASSWORD`環(huán)境變量，定義連接PostgreSQL數(shù)據(jù)庫的密碼。默認(rèn)設(shè)置為`postgres`，建議更改為更安全的密碼。

# 以下這行不需要更改
###################################################################################
# 上面這行是注釋，表示以下的環(huán)境變量通常不需要修改。

DB_HOSTNAME=immich_postgres
# 設(shè)置`DB_HOSTNAME`環(huán)境變量，指定PostgreSQL數(shù)據(jù)庫服務(wù)的主機(jī)名。這里使用的是`docker-compose.yml`文件中定義的服務(wù)名稱`immich_postgres`。

DB_USERNAME=postgres
# 設(shè)置`DB_USERNAME`環(huán)境變量，定義連接PostgreSQL數(shù)據(jù)庫的用戶名。默認(rèn)設(shè)置為`postgres`。

DB_DATABASE_NAME=immich
# 設(shè)置`DB_DATABASE_NAME`環(huán)境變量，指定PostgreSQL數(shù)據(jù)庫的名稱。這里設(shè)置為`immich`。

REDIS_HOSTNAME=immich_redis
# 設(shè)置`REDIS_HOSTNAME`環(huán)境變量，指定Redis服務(wù)的主機(jī)名。這里使用的是`docker-compose.yml`文件中定義的服務(wù)名稱`immich_redis`。