Docker运行imgproxy镜像时的环境变量配置及文件缺失问题

针对你遇到的docker run命令过长、环境变量不易维护的问题，这里提供两种实用的优化方案：

1. 使用环境变量文件（.env） #

把所有环境变量集中存储在一个.env文件中，避免在命令行逐个指定：

步骤1：创建.env文件 #

在本地目录下创建.env文件，填入你的环境变量：

IMGPROXY_KEY=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
IMGPROXY_SALT=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
IMGPROXY_MAX_ANIMATION_FRAMES=2
IMGPROXY_ENABLE_AVIF_DETECTION=true
IMGPROXY_ENABLE_WEBP_DETECTION=true
IMGPROXY_PREFERRED_FORMATS=avif

步骤2：简化docker run命令 #

使用--env-file参数加载配置文件，命令会大幅精简：

docker run --name imgproxy -p 8080:8080 --env-file .env -d darthsim/imgproxy

这种方式的核心优势是配置集中管理，修改变量只需编辑.env文件，无需改动启动命令。

2. 使用Docker Compose（自定义配置文件） #

如果需要更灵活的扩展（比如后续挂载本地目录、添加服务依赖），可以自行编写docker-compose.yml：

步骤1：编写docker-compose.yml #

version: '3.8'
services:
  imgproxy:
    image: darthsim/imgproxy
    container_name: imgproxy
    ports:
      - "8080:8080"
    environment:
      - IMGPROXY_KEY=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
      - IMGPROXY_SALT=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx
      - IMGPROXY_MAX_ANIMATION_FRAMES=2
      - IMGPROXY_ENABLE_AVIF_DETECTION=true
      - IMGPROXY_ENABLE_WEBP_DETECTION=true
      - IMGPROXY_PREFERRED_FORMATS=avif
    restart: unless-stopped

可选优化：结合.env文件进一步简化配置，修改environment部分为：

environment:
  - IMGPROXY_KEY=${IMGPROXY_KEY}
  - IMGPROXY_SALT=${IMGPROXY_SALT}
  - IMGPROXY_MAX_ANIMATION_FRAMES=${IMGPROXY_MAX_ANIMATION_FRAMES}
  - IMGPROXY_ENABLE_AVIF_DETECTION=${IMGPROXY_ENABLE_AVIF_DETECTION}
  - IMGPROXY_ENABLE_WEBP_DETECTION=${IMGPROXY_ENABLE_WEBP_DETECTION}
  - IMGPROXY_PREFERRED_FORMATS=${IMGPROXY_PREFERRED_FORMATS}

变量值依然放在之前创建的.env文件中即可。

步骤2：启动服务 #

在docker-compose.yml所在目录执行：

docker-compose up -d

后续修改配置后，只需执行docker-compose restart即可生效，非常适合长期维护。

内容的提问来源于stack exchange，提问作者李晓川