首页/云/Docker 容器速查/compose environment 字段两种形式
Compose 编排55 条

compose environment 字段两种形式

为服务设置环境变量:列表形式(含仅写键名从宿主透传)与映射形式;它优先于 env_file 中的同名变量。

Docker 容器速查云更新于 2026-10-12
列表形式- KEY=value / - KEY(从宿主环境取值)
映射形式KEY: value
优先级environment 高于 env_file

示例

示例
services:
  api:
    image: app/api:1.4.2
    environment:
      - LOG_LEVEL=info
      - TZ
      - DB_HOST=db
      - DB_PORT: "5432"
值里的 $ 需要写 $$ 转义,否则会被 Compose 当变量插值处理;数字类值建议加引号避免类型歧义。

易错点

  • 列表里只写键名表示从当前 shell 透传,CI 里该变量没导出会得到空值而不是报错
  • 改环境变量后必须重建容器(up)才生效,restart 沿用旧的环境

数据来源与参考

  • Docker 官方文档:Compose environment 参考(docs.docker.com/reference/compose-file/services)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌