容器与云原生 / 系统课时
密码和密钥适合直接写环境变量吗
密码和密钥适合直接写环境变量吗
环境变量很适合传递普通运行参数,但密码、API Key、私钥等秘密一旦直接放进去,可能被容器配置、调试命令或应用日志暴露。本节用一个可控示例确认风险,并给出更稳妥的 Secret 使用边界。
学习目标
- 判断哪些值属于普通配置,哪些值应按 Secret 管理
- 验证运行时环境变量为什么可能被 Docker 管理接口查看
- 为生产环境选择更合适的秘密注入方式
先区分配置和秘密
环境变量本身不是“危险功能”。像 APP_ENV=production、LOG_LEVEL=info、功能开关和普通服务地址,都很适合用环境变量注入,因为它们需要随部署环境变化,又不应写死在镜像里。
密码、长期 API Token、数据库凭据、TLS 私钥则不同:它们的安全目标不仅是“不要写进源码”,还包括限制谁能读取、减少暴露面、支持轮换和审计。把这类值直接作为容器环境变量,只解决了“配置外置”,并没有自动获得秘密管理能力。
| 数据 | 典型例子 | 更合适的做法 |
|---|---|---|
| 普通配置 | 日志级别、端口、功能开关 | 环境变量 |
| 敏感凭据 | 数据库密码、长期 Token | Secret 文件、编排平台 Secret 或外部密钥系统 |
| 私钥材料 | TLS 私钥、签名私钥 | 受控文件挂载或专用 Secret 管理 |
为什么环境变量会暴露
Docker 创建容器时,会把为容器设置的环境变量记录到容器配置中。拥有 Docker 守护进程访问权限的人通常可以通过 docker inspect 查看这些配置;容器内的进程也能读取自己的环境。若应用在错误报告、调试页面或启动日志中打印环境变量,秘密还可能进一步进入日志系统。
下面只使用演示值,不要替换成真实密码:
docker run -d --name env-secret-demo -e DB_PASSWORD=demo-only-value alpine:3.20 sleep 300
docker inspect --format '{{json .Config.Env}}' env-secret-demo | grep -o 'DB_PASSWORD=[^"]*'
docker rm -f env-secret-demo预期输出
<ID>
DB_PASSWORD=demo-only-value
env-secret-demo其中 <ID> 是本次创建容器的实际 ID,每次运行都会不同。这个实验说明:只要把敏感值作为运行时环境变量交给容器,它就可能出现在 Docker 可查询的容器配置里。
更稳妥的注入方式
生产环境更适合把秘密作为受控文件提供给应用,例如 Docker Compose secrets、Swarm secrets、Kubernetes Secret 挂载,或由外部 Secret Manager 在运行时下发。应用只读取自己被授权的秘密文件,能减少“所有环境变量被统一枚举”带来的暴露面。
这并不意味着“文件一定安全”。如果源文件本身以明文放在代码仓库、共享目录或宽权限磁盘上,同样会泄露。Secret 方案的价值在于把存储、授权、挂载、轮换和审计从普通配置中分离出来,而不是简单把变量换成另一个文件名。
.env 文件也不等同于 Secret 管理器。它适合本地开发和配置整理,但如果里面有真实密码,仍需避免提交到版本库,并控制文件权限和备份范围。
什么时候还能用环境变量
在本地开发、短生命周期测试环境,或系统暂时没有 Secret 基础设施时,可以把环境变量作为权衡方案,但应满足最小权限、短有效期、禁止打印、及时轮换等条件。生产中的长期高价值凭据则不应默认直接放在环境变量里。
判断时可以问三个问题:这个值泄露后的影响有多大;哪些人或系统能够读取容器配置;凭据是否需要独立轮换和审计。只要其中任何一项要求较高,就应该把它从普通环境变量配置中分离出来。