无需预处理：如何将环境变量转为Docker Compose的YAML列表

你的问题出在Docker Compose默认会把环境变量值当作字符串解析，你原来.env里的方括号格式会被当成完整字符串，而不是YAML列表，因此触发must be a list错误。以下是无需外部工具的纯Compose解决方案：

方案一：空格分隔别名（推荐） #

修改.env文件 #

把别名改成空格分隔的形式，去掉方括号和引号：

# .env
ALIASES=app1.example.com app2.example.com app3.example.com

修改docker-compose.yml #

将aliases字段写成列表结构，直接引用变量：

# docker-compose.yml
version: "3.9"
services:
  web:
    image: nginx:alpine
    networks:
      proxy:
        aliases:
          ${ALIASES}
networks:
  proxy:
    driver: bridge

运行docker compose config验证，会生成你期望的YAML列表结构。

方案二：逗号分隔别名（兼容习惯写法） #

如果你偏好逗号分隔的格式，可以通过Compose的变量替换语法将逗号转为空格：

修改.env文件 #

# .env
ALIASES=app1.example.com,app2.example.com,app3.example.com

修改docker-compose.yml #

使用${ALIASES//,/ }将逗号替换为空格，Compose会自动拆分为列表项：

# docker-compose.yml
version: "3.9"
services:
  web:
    image: nginx:alpine
    networks:
      proxy:
        aliases:
          ${ALIASES//,/ }
networks:
  proxy:
    driver: bridge

两种方案都不需要额外脚本或工具，直接执行docker compose up -d即可运行。

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