Docker-Immich

**相关链接：**
---
- 官网：https://immich.app/
- GitHub：https://github.com/immich-app/immich
- 文档：https://immich.app/docs/overview/introduction
- 中文版：https://github.com/uparrows/immich_cn
- App：
	- Google Play：https://play.google.com/store/apps/details?id=app.alextran.immich
	- App Store：https://apps.apple.com/sg/app/immich/id1613945652

## docker-compose 版
```bash
mkdir {library,cache,postgres}  # 创建所需文件
nano docker-compose.yml
nano .env
docker-compose up -d  # 部署服务
```
部署后访问 `http://{服务器域名或IP}:{服务器端口}`

`docker-compose.yml`
```ymal
# 警告：确保使用当前版本的 docker-compose.yml：
# https://github.com/immich-app/immich/releases/latest/download/docker-compose.yml
# main 上的 compose 文件可能与最新版本不兼容

name: immich
services:
  immich-server:  # 服务端
    container_name: immich_server  # 容器名称
    image: ghcr.io/immich-app/immich-server:${IMMICH_VERSION:-release}  # 镜像名称(调用.env中设定版本,未指定则使用release)
    command: ['start.sh', 'immich']  # 启动命令
    volumes:
      - ${UPLOAD_LOCATION}:/usr/src/app/upload  # 指定上传文件夹(在.env中设定)
      - /etc/localtime:/etc/localtime:ro  # 同步系统时间
    env_file:
      - .env  # 引用.env文件
    # environment:
      # HOST: 0.0.0.0  # 指定主机(默认 0.0.0.0)
      # SERVER_PORT: 3001  # 指定端口(默认 3001)
    ports:
      - 2283:3001  # 暴露端口
    depends_on:
      - redis
      - database
    restart: always  # 重启策略, always表示总是重启

immich-microservices:  # 微服务
    container_name: immich_microservices  # 容器名称
    image: ghcr.io/immich-app/immich-server:${IMMICH_VERSION:-release}  # 镜像名称(调用.env中设定版本,未指定则使用release)
    # extends: # 取消注释此部分以进行硬件加速 - 请参阅 https://immich.app/docs/features/hardware-transcoding
    #   file: hwaccel.transcoding.yml
    #   service: cpu # 设置为 [nvenc、quicksync、rkmpp、vaapi、vaapi-wsl] 之一以加速转码
    command: ['start.sh', 'microservices']  # 启动命令
    volumes:
      - ${UPLOAD_LOCATION}:/usr/src/app/upload  # 指定上传文件夹(在.env中设定)
      - /etc/localtime:/etc/localtime:ro  # 同步系统时间
    env_file:
      - .env  # 引用.env文件
    environment:
      TZ: Asia/Shanghai  # 指定时区
      # HOST: 0.0.0.0  # 指定主机(默认 0.0.0.0)
      # MICROSERVICES_PORT: 3002  # 指定端口(默认 3002)
    # ports:
    #   - 3002:3002  # 暴露端口
    depends_on:
      - redis
      - database
    restart: always  # 重启策略, always表示总是重启

immich-machine-learning:  # 机器学习
    container_name: immich_machine_learning  # 容器名称
    # 对于硬件加速，将 -[armnn, cuda, openvino] 之一添加到图像标签
    # 示例标签：${IMMICH_VERSION:-release}-cuda
    image: ghcr.io/immich-app/immich-machine-learning:${IMMICH_VERSION:-release}  # 镜像名称(调用.env中设定版本,未指定则使用release)
    # extends: # 取消注释此部分以获取硬件加速 - 请参阅 https://immich.app/docs/features/ml-hardware-acceleration
    #   file: hwaccel.ml.yml
    #   service: cpu # 设置为 [armnn、cuda、openvino、openvino-wsl] 之一以加速推理 - 在适用的情况下使用 WSL2 的“-wsl”版本
    volumes:
      - ./cache:/cache  # 指定模型缓存文件夹
    env_file:
      - .env  # 引用.env文件
    # environment:
      # MACHINE_LEARNING_HOST: 0.0.0.0  # 指定主机(默认 0.0.0.0)
      # MACHINE_LEARNING_PORT: 3003  # 指定端口(默认 3003)
    restart: always  # 重启策略, always表示总是重启

redis:  # Redis
    container_name: immich_redis  # 容器名称
    image: registry.hub.docker.com/library/redis:6.2-alpine@sha256:84882e87b54734154586e5f8abd4dce69fe7311315e2fc6d67c29614c8de2672  # 镜像名称
    restart: always  # 重启策略, always表示总是重启

database:  # 数据库
    container_name: immich_postgres  # 容器名称
    image: registry.hub.docker.com/tensorchord/pgvecto-rs:pg14-v0.2.0@sha256:90724186f0a3517cf6914295b5ab410db9ce23190a2d9d0b9dd6463e3fa298f0  # 镜像名称
    environment:
      POSTGRES_PASSWORD: ${DB_PASSWORD}  # 数据库密码(在.env中设定)
      POSTGRES_USER: ${DB_USERNAME}  # 数据库用户名(在.env中设定)
      POSTGRES_DB: ${DB_DATABASE_NAME}  # 数据库名称(在.env中设定)
    volumes:
      - ./postgres:/var/lib/postgresql/data    # 指定数据库文件夹
    restart: always  # 重启策略, always表示总是重启
```
`.env`
```bash
# 要更改环境变量，必须重新创建 Immich 容器。 只是重新启动容器并不能替换容器内的环境！
# 您可以在 https://immich.app/docs/install/environment-variables 找到所有支持的环境变量的文档

# 常见配置
###################################################################################
UPLOAD_LOCATION=./library  # 媒体位置(服务器、微服务 有效)
IMMICH_VERSION=release  # Immich对应版本,推荐使用固定版本(服务器、微服务、机器学习 有效)

# 数据库相关(前4个加 _FILE 可以作为敏感数据运行Docker)
###################################################################################
DB_HOSTNAME=immich_postgres  # 数据库主机名(服务器、微服务 有效)
DB_USERNAME=postgres  # 数据库用户名(服务器、微服务 有效)
DB_PASSWORD=postgres  # 数据库密码(服务器、微服务 有效)
DB_DATABASE_NAME=immich  # 数据库名称(服务器、微服务 有效)

DB_SKIP_MIGRATIONS=false  # 是否跳过迁移true/false(服务器、微服务 有效)

# 缓存相关
###################################################################################
REDIS_HOSTNAME=immich_redis  # Redis 主机名(服务器、微服务 有效)
# REDIS_PORT=6379  # Redis 端口,默认6379(服务器、微服务 有效)

# 其他配置
###################################################################################
# LOG_LEVEL=log  # 日志级别(verbose, debug, log, warn, error)(服务器、微服务、机器学习 有效)
# IMMICH_MEDIA_LOCATION=./upload  # 媒体位置(服务器、微服务 有效)
# IMMICH_CONFIG_FILE=  # 配置文件位置(服务器、微服务 有效)
# IMMICH_WEB_ROOT=/usr/src/app/www  # 根index.html的路径(服务器 有效)
# IMMICH_REVERSE_GEOCODING_ROOT=/usr/src/resources  # 反向地理编码转储目录的路径(微服务 有效)
```