如何为Docker Compose服务设置可选择性覆盖的默认环境变量？

你想要的效果是：容器默认使用镜像内置的环境变量值，同时允许通过主机环境变量选择性地覆盖它——这和docker run -e var=xxx的行为完全一致。我们先分析你之前三种尝试的问题，再给出正确的配置方案。

之前三种配置的问题分析 #

• 方案1：手动覆盖才会设置变量

  version: "3.1"
  services:
    hello-teller:
      image: exp:latest
      environment:
        - var
  

  这种写法是告诉Docker Compose从主机环境中读取var并传递给容器，如果主机没设置var，Compose就不会把这个变量传给容器，导致镜像里的默认值被“清空”（容器里var未定义），不符合你的需求。

• 方案2：固定值无法覆盖

  version: "3.1"
  services:
    hello-teller:
      image: exp:latest
      environment:
        - var=lala
  

  这里直接硬编码了var的值，不管主机环境有没有设置var，容器里都会用lala，完全失去了可覆盖的灵活性。

• 方案3：配置无效果

  version: "3.1"
  services:
    hello-teller:
      image: exp:latest
      environment:
        - ${var:-lala}
  

  这个语法是Docker Compose的变量替换，意思是“如果主机有var就用它的值，否则用lala”，但它会强制给容器设置var的值——要么是主机的var，要么是lala，完全忽略了镜像里的默认hello，所以达不到保留镜像默认值的目的。

正确的配置方案 #

要实现“默认用镜像值，有主机变量则覆盖”的效果，我们可以利用Shell的参数扩展语法${var:+var=$var}，它的作用是：如果主机环境存在var且不为空，就生成var=xxx的环境变量条目；否则什么都不生成。这样容器就会在没有外部变量时使用镜像默认值，有外部变量时则覆盖。

配置如下：

version: "3.1"
services:
  hello-teller:
    image: exp:latest
    environment:
      - ${var:+var=$var}

验证效果 #

1. 未设置主机环境变量时：
   直接执行docker-compose up，容器会使用镜像内置的var=hello。
2. 设置主机环境变量后：
   先执行export var=huhu（Linux/macOS）或set var=huhu（Windows命令行），再执行docker-compose up，容器里的var会被覆盖为huhu。

另一种可选方案（使用字典形式） #

如果你更习惯字典式的environment写法，也可以用类似的参数扩展：

version: "3.1"
services:
  hello-teller:
    image: exp:latest
    environment:
      ${var:+var: "${var}"}

效果和上面的列表形式完全一致，只是写法不同。

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