容器与云原生 / 系统课时

密码应该放进 .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:

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 文件并运行服务:

bash
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

预期输出

text
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 管理链路。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

密码应该放进 .env 吗

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通