容器与云原生 / 系统课时
密码应该放进 .env 吗
密码应该放进 .env 吗
.env 很适合把端口、日志级别、镜像标签等普通参数从 Compose 文件中分离出来,但它本质上仍是明文配置文件。密码、API Key 和私钥需要更严格的访问边界,不能因为写进 .env 就被当成已经安全保存。
学习目标
- 区分普通环境参数与真正的敏感信息。
- 使用 Docker Compose Secrets 将敏感值以文件方式提供给指定服务。
- 识别
.gitignore、文件权限和 Secret 管理各自能解决的问题。
.env 解决配置分离,不解决秘密保护
Compose 可以从项目 .env 读取变量用于插值,也可以通过 env_file 把变量注入容器环境。这些机制解决的是“配置放在哪里、如何按环境替换”,而不是“谁能读取秘密”。Docker 官方文档也明确建议不要用环境变量传递密码等敏感信息,而应优先使用 Secrets。([Docker Documentation][1])
| 数据 | 放 .env 是否合适 |
更合适的方式 |
|---|---|---|
APP_PORT=8080 |
合适 | .env |
LOG_LEVEL=info |
合适 | .env |
| 数据库密码 | 不推荐 | Secret |
| API Key、私钥 | 不推荐 | Secret 或外部 Secret Manager |
.gitignore 能降低误提交概率,但不能加密文件,也不能阻止同一主机上具有相应文件权限的用户读取它。因此“没提交到 Git”与“秘密受到严格访问控制”是两回事。
用 Compose Secrets 做最小替换
本地 Compose 可以从宿主机文件创建 Secret,并只把它挂载给声明需要该 Secret 的服务。Linux 容器中默认路径是 /run/secrets/<secret_name>,应用应从这个文件读取值,而不是把秘密塞进普通环境变量。([Docker Documentation][2])
将下面内容保存为 compose.yaml:
services:
demo:
image: alpine:3.22
command:
- sh
- -c
- test -s /run/secrets/app_password && echo secret-mounted
secrets:
- app_password
secrets:
app_password:
file: ./secrets/app_password.txt然后创建 Secret 文件并运行服务:
mkdir -p secrets
printf '%s' 'change-me-locally' > secrets/app_password.txt
chmod 600 secrets/app_password.txt
docker compose run --rm demo 2>/dev/null预期输出
secret-mounted这个示例只验证 Secret 已挂载且非空,不会把真实内容打印到终端。实际应用需要显式读取 /run/secrets/app_password;某些官方镜像支持 *_FILE 变量,但这是镜像约定,不是所有程序都会自动识别。([Docker Documentation][2])
Secret 仍需要保护宿主机源文件
Compose Secret 减少了秘密通过容器环境变量、调试输出或错误配置意外暴露的机会,并提供按服务授权的边界,但它不是宿主机上的加密保险箱。若 Secret 来源仍是 ./secrets/app_password.txt,这个文件本身依然需要最小权限,并应排除在版本控制与镜像构建上下文之外。
开发机可以使用受权限保护的本地 Secret 文件;生产环境更适合由云平台、Vault、Kubernetes Secret 等专门系统提供秘密,并配合轮换、审计和最小权限。判断原则很简单:普通运行参数放 .env,一旦泄露会造成账户、数据或基础设施风险的值,就进入专门的 Secret 管理链路。