Docker Compose：使用 .env 文件更高效管理环境变量

欢迎大家来到IT世界,在知识的湖畔探索吧!

在使用 Docker Compose 管理容器时，环境变量是一个重要的配置方式，而 .env 文件可以让变量管理更加高效、安全。

1. .env 文件的作用

.env 文件用于存储环境变量，避免在 docker-compose.yml 里直接写死变量，使配置更加灵活、可维护，同时也可以避免敏感信息泄露。

2. 基础用法

定义环境变量

在 .env 文件中，按 KEY=VALUE 格式定义变量，例如：

APP_PORT=8080 APP_ENV=production DB_PASSWORD=secret 

欢迎大家来到IT世界,在知识的湖畔探索吧!

在 docker-compose.yml 中使用

在 docker-compose.yml 文件中，可以使用 ${VARIABLE_NAME} 语法引用 .env 变量：

欢迎大家来到IT世界,在知识的湖畔探索吧!version: "3.9" services: app: image: my-app-image ports: - "${APP_PORT}:80" environment: - ENV=${APP_ENV} - DB_PASSWORD=${DB_PASSWORD} 

3. .env 文件的加载规则

默认加载行为

Docker Compose 会自动加载 docker-compose.yml 同级目录下的 .env 文件。

自定义 .env 文件路径

如果 .env 文件不在默认目录，可以使用 –env-file 指定：

docker-compose --env-file custom.env up 

或者在 docker-compose.yml 里使用 env_file 指定：

欢迎大家来到IT世界,在知识的湖畔探索吧!services: app: env_file: - custom.env 

4. 变量优先级规则

当相同的环境变量在多个地方定义时，Docker Compose 会按照以下优先级解析（从高到低）：

1. Docker 运行时环境变量（export VAR=value）
2. docker-compose.yml 里的 environment 字段
3. –env-file 指定的 .env 文件
4. 默认加载的 .env 文件

例如，以下命令：

export APP_PORT=9090 docker-compose up 

即使 .env 文件中定义了 APP_PORT=8080，最终 APP_PORT 仍然会使用 9090。

5. .env 变量的默认值

如果变量可能为空，可以使用默认值：

欢迎大家来到IT世界,在知识的湖畔探索吧!environment: # 若 APP_PORT 为空，则使用 3000 - APP_PORT=${APP_PORT:-3000} 

6. 安全性最佳实践

• 避免直接在 docker-compose.yml 写入敏感信息，建议使用 .env 文件管理。
• 在 .gitignore 中忽略 .env 文件，防止敏感数据泄露：echo “.env” >> .gitignore

7. 总结

• .env 文件可以提高配置的灵活性、安全性和可维护性。
• Docker Compose 会自动加载 .env，但可以通过 –env-file 指定其他文件。
• 变量的解析优先级遵循 系统环境变量 > docker-compose.yml > .env 文件。
• 务必使用 .gitignore 忽略 .env 文件，以防敏感信息泄露。