首页/云/Docker 容器速查/compose secrets 注入敏感文件
本包目录(366 条)
基础命令50 条镜像与构建107 条网络与存储52 条
Compose 编排55 条
资源与安全50 条容器排障52 条

compose secrets 注入敏感文件

把敏感内容以文件形式注入容器:适用本地 compose 的文件型 secret 挂载在 /run/secrets 下,避免把口令写进环境变量与镜像。

Docker 容器速查云更新于 2026-10-12
顶层secrets: 名称: {file: 路径}
服务引用secrets: [名称]
容器内位置/run/secrets/<名称>(Linux)

示例

示例
services:
  api:
    image: app/api:1.4.2
    secrets:
      - db_password

secrets:
  db_password:
    file: ./secrets/db_password.txt

读取示例

读取示例
docker compose exec api sh -c 'cat /run/secrets/db_password | wc -c'
secret 文件随容器挂载发布,权限由守护进程处理;仓库里只提交占位说明,不提交真实内容。

易错点

  • 环境变量形式的密钥会出现在 inspect 与子进程环境中,文件型 secret 是更收敛的做法
  • secret 文件路径相对 compose 文件目录,执行目录变化时要留心解析

数据来源与参考

  • Docker 官方文档:Compose secrets(docs.docker.com/reference/compose-file/secrets)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌