如何在Docker Compose中通过环境变量条件配置extra_hosts？

方法1：多Compose文件组合（推荐） #

把基础配置和可选配置拆分到两个文件，通过环境变量自动控制是否加载可选配置：

1. 主配置文件docker-compose.yml：

services:
  my_service:
    build: .
    ports:
      - "3000:3000"
    extra_hosts:
      - "example.com:10.1.1.1"

2. 可选配置文件docker-compose.optional.yml：

services:
  my_service:
    extra_hosts:
      - "${MY_OPTIONAL_HOSTNAME}"

3. 运行命令（自动适配环境变量状态）：

docker compose up ${MY_OPTIONAL_HOSTNAME:+-f docker-compose.optional.yml}

• 未设置MY_OPTIONAL_HOSTNAME时，仅加载主配置文件
• 已设置变量时，自动合并加载两个文件的配置

方法2：利用变量替换动态生成列表项 #

通过${VAR:+...}语法，仅当环境变量存在且非空时，才插入对应的extra_hosts条目：

services:
  my_service:
    build: .
    ports:
      - "3000:3000"
    extra_hosts:
      - "example.com:10.1.1.1"
      ${MY_OPTIONAL_HOSTNAME:+"- ${MY_OPTIONAL_HOSTNAME}"}

说明：此方法依赖Docker Compose的变量替换逻辑，未设置变量时会生成空行，YAML解析器会自动忽略无效的空列表项（建议在Compose 2.0+版本测试使用）。

方法3：使用Compose Profiles #

通过Profiles功能将可选配置隔离，通过环境变量控制是否启用对应profile：

services:
  my_service:
    build: .
    ports:
      - "3000:3000"
    extra_hosts:
      - "example.com:10.1.1.1"

  my_service_with_host:
    extends: my_service
    profiles: [optional_host]
    extra_hosts:
      - "${MY_OPTIONAL_HOSTNAME}"

运行时：

# 未设置变量时，启动基础服务
docker compose up

# 设置变量并启用对应profile
export MY_OPTIONAL_HOSTNAME="custom.host:192.168.1.1"
docker compose --profile optional_host up my_service_with_host

内容的提问来源于stack exchange，提问作者AndreFeijo