| 用途 | 从文件读取容器环境变量 |
|---|---|
| 语法 | env_file: 路径 或列表 |
| 文件格式 | KEY=value 每行一条 |
示例
示例
services:
api:
image: app/api:1.4.2
env_file:
- .env.common
- .env.api同名变量以靠后的 env_file 为准；environment 中显式写的变量再覆盖其上。
本包目录（366 条）
基础命令50 条镜像与构建107 条网络与存储52 条
Compose 编排55 条
- docker compose up 拉起服务
- Docker Compose 概览与 v1/v2 差异
- compose 文件顶层结构
- compose ports 字段写法
- docker compose logs 聚合日志
- services 定义与容器命名规则
- compose environment 字段两种形式
- docker compose ps 查看服务状态
- compose volumes 字段写法
- compose depends_on 启动依赖
- docker compose down 停止并清理
- image 与 build 字段的配合
- compose restart 策略字段
- docker compose exec 进入服务容器
- docker compose config 校验与展开
- compose healthcheck 字段
- docker compose run 一次性任务
- compose networks 字段与网络别名
- compose 顶层 volumes 与驱动配置
- 项目级 .env 文件与变量来源优先级
- compose 资源限制字段
- docker compose build 构建服务镜像
- compose 多文件合并与 override 约定
- compose start/stop/restart/pause 语义
- compose env_file 字段
- compose command 与 entrypoint 覆盖
- compose logging 日志驱动与截断
- docker compose up --wait 等待健康
- compose 变量插值语法与转义
- compose 文件的 version 字段已废弃
- docker compose pull / push 镜像流转
- compose 扩容 --scale 与副本数
- compose 项目名与资源命名
- docker-compose v1 到 compose v2 对照
- compose profiles 分组启动
- compose labels 与自动标签
- compose 默认文件名与查找顺序
- compose container_name 固定容器名
- docker compose ls 列出项目
- compose 停服信号与宽限期
- compose secrets 注入敏感文件
- compose 项目资源清理核对
- docker compose port 查询端口映射
- docker compose images 列出服务镜像
- compose shm_size 调整共享内存
- compose extra_hosts 注入 hosts 记录
- compose 网络的 internal 与 external
- docker compose cp 与容器互拷文件
- docker compose watch 开发热更新
- compose init 字段启用 init 进程
- compose ulimits 调整进程资源限制
- compose configs 挂载配置文件
- compose config --hash 检测配置变化
- compose include 复用其他文件
- docker compose top 查看服务进程
compose env_file 字段
把变量文件注入容器：适合为数据库连接等成组配置集中取值，可指定多个文件，后面的文件优先级更高。
易错点
- env_file 与项目级 .env 不是一回事：前者进容器，后者供 Compose 插值使用，别互相替代
- 把密钥文件提交进 git 是常见事故，env_file 引用真实文件并加入忽略清单
数据来源与参考
- Docker 官方文档：Compose env_file 参考（docs.docker.com/reference/compose-file/services）