Docker Compose secrets如何安全传递凭据?与环境变量相比有哪些边界

发布人:A5数据发布时间:2026-10-23 15:33阅读量:138

把密码从环境变量改成 Docker Compose secrets,并不等于凭据已经“不可见”。它主要改变了凭据进入容器的路径:环境变量通常进入容器配置和进程环境,secret 则通常以只读文件挂载到 /run/secrets/<名称>。这能减少 docker inspect、进程继承、调试输出等场景中的暴露,但不会阻止容器内有权限的进程读取文件。

先划清 Compose secrets 的边界配图

更准确的判断是:Docker Compose secrets 更适合降低运行时凭据的意外暴露面,而不是替代主机权限控制、容器隔离、日志治理和凭据轮换机制。 在本地 docker compose up 与 Docker Swarm 中,名为 secrets 的功能还可能对应不同的底层实现,不能只看配置写法就推断安全级别。

先划清 Compose secrets 的边界

按照 Compose Specification,顶层 secrets 用于声明敏感数据,服务通过 services.<服务名>.secrets 选择性获得访问权。典型的文件型配置如下:

services:
  api:
    image: example/api:1.4
    secrets:
      - source: db_password
        target: db_password
    environment:
      DB_PASSWORD_FILE: /run/secrets/db_password

  worker:
    image: example/worker:2.1
    secrets:
      - source: payment_token
        target: payment_token
    environment:
      PAYMENT_TOKEN_FILE: /run/secrets/payment_token

secrets:
  db_password:
    file: ./secrets/db_password

  payment_token:
    file: ./secrets/payment_token

启动后,api 通常只能看到:

/run/secrets/db_password

而不会自动看到 payment_token。worker 的情况相反。这种服务级别的授权是 secrets 相比“把所有凭据放进公共 .env 文件”更有价值的地方。

不过,下面几项不能被上述配置自动解决:

  • Compose 不会替应用读取文件。DB_PASSWORD_FILE 只是应用约定的变量名,应用必须主动读取该路径。
  • secret 文件的内容仍然存在于主机上的 ./secrets/db_password。
  • 容器内的 root 用户,或具有相应文件读取权限的进程,仍可能读取 /run/secrets/db_password。
  • 应用把文件内容写入日志、错误信息、诊断接口或子进程环境后,凭据仍会暴露。
  • 只给某个服务挂载 secret,不代表同一容器内的不同进程之间实现了进程级访问控制。

因此,Compose secrets 解决的是“凭据如何交给指定服务”,不是“凭据在任何位置都无法被读取”。

文件型 secrets 实际如何工作

本地 Compose 通常依赖主机文件

使用下面的定义时:

secrets:
  db_password:
    file: ./secrets/db_password

Compose 需要先从主机读取或挂载这个文件,然后让被授权的容器在 /run/secrets/db_password 访问它。文件路径、宿主机权限和 Docker Desktop 的文件共享配置都会影响最终结果。

这意味着本地部署至少存在三个需要分别控制的对象:

  1. Compose 配置文件:不应直接写入密码值,只引用 secret 名称或文件路径。
  2. 主机上的 secret 源文件:应限制宿主机用户访问,并避免进入 Git、备份目录、工单附件和构建上下文。
  3. 容器内的挂载路径:应只授予确实需要该凭据的服务。

.env 和 env_file 不会因为文件名看起来像配置文件就自动变成安全存储。下面的写法仍然是环境变量传递:

services:
  api:
    image: example/api:1.4
    environment:
      DB_PASSWORD: ${DB_PASSWORD}

即使 DB_PASSWORD 的值来自 .env,它仍可能出现在容器的环境配置、进程环境、调试信息或子进程继承链中。将变量改成 DB_PASSWORD_FILE,并让应用读取 /run/secrets/db_password,才真正改变了传递方式。

应用必须支持文件读取

部分镜像提供类似 POSTGRES_PASSWORD_FILE 的约定,但这属于具体镜像或应用的功能,不是 Docker Compose 对所有程序的通用能力。

使用第三方镜像前,应确认以下问题:

  • 应用是否支持 *_FILE 类型变量;
  • 应用是否可以直接配置密码文件路径;
  • 应用读取文件时是否会去除末尾换行;
  • 应用启动后是否会把读取到的值重新写入环境变量;
  • 应用重载配置时是否会重新读取文件。

如果应用只支持 DB_PASSWORD,却不支持文件路径,那么 Compose secrets 仍然可以挂载文件,但应用不会自动使用它。此时不应为了兼容应用而把密码再复制到环境变量中,否则失去了主要收益。更合理的方式是让应用增加文件读取能力,或者在受控入口程序中读取文件后通过管道、标准输入等方式传递,同时检查入口脚本是否会打印参数。

文件权限不是唯一的访问控制

主机源文件可以设置为仅所有者可读,例如常见的 0600 权限,但这只限制主机上的普通用户。拥有 root 权限的主机用户、能够读取 Docker 数据和挂载信息的管理账号,通常仍有机会获取内容。

在容器内,服务的运行用户也很重要。若应用以非 root 用户运行,应验证它确实可以读取 secret;若应用以 root 运行,则挂载路径本身通常不能阻止容器内其他 root 进程读取。

Compose 配置中某些长语法字段可以描述 uid、gid 和 mode,但在本地文件型实现中,底层可能使用 bind mount,相关属性未必能够像编排平台原生 secret 那样被强制执行。不要只检查 YAML 中写了什么,应当进入实际容器,用运行用户验证读取权限和不可写属性。

与环境变量相比,暴露面有什么不同

比较维度环境变量传递Compose secrets 文件传递
容器配置可见性通常会进入容器的 Config.Env,检查容器配置时可能看到值通常只看到挂载目标和源文件路径,内容不直接出现在 Compose 配置中
进程继承子进程默认继承环境变量,脚本和诊断工具容易带出子进程不会自动获得内容,必须主动读取文件
服务选择性通过 environment 或 env_file 配置,容易被多个服务复用每个服务单独声明需要的 secret,便于缩小授权范围
主机持久化可能出现在容器配置元数据、启动脚本或环境文件文件型 secret 明确保存在主机源文件中,通常未加密
应用兼容性大多数应用直接支持应用需要支持文件路径或自行读取
更新方式常需重新创建容器或重新注入环境文件变化是否生效取决于挂载实现和应用读取方式
容器内高权限进程可以读取进程环境或配置可以读取 /run/secrets 中被授权的文件
日志风险启动脚本、诊断命令容易打印变量cat 文件、错误输出或应用日志同样可能泄露
构建阶段风险通过 ARG 或构建环境传递时可能进入镜像历史和缓存运行时 secret 不会自动保护构建阶段,需使用独立的构建 secret 机制

这个比较不代表 secrets 在所有威胁模型下都优于环境变量。例如,攻击者已经取得主机 root 权限时,主机上的 secret 文件和容器配置都不再是可靠边界;攻击者已经控制容器内 root 进程时,挂载文件也不能阻止其读取。

secrets 的实际收益主要体现在以下场景:

  • 运维人员执行容器检查命令时,不容易直接在环境变量列表中看到密码;
  • 应用的普通子进程不会因为环境继承而自动获得凭据;
  • 可以让不同服务只获得各自需要的凭据;
  • 可以避免把密码硬编码到 Compose YAML、镜像构建参数或启动命令中。

影响安全结果的几个条件

不要把 secret 值放进命令行和镜像构建

下面几种方式与运行时 secrets 是不同问题:

ARG DB_PASSWORD
ENV DB_PASSWORD=${DB_PASSWORD}

ARG、ENV、镜像构建缓存、构建日志和镜像历史都有可能留下敏感信息。运行时用 Compose secrets 不能清除已经写入镜像层的密码。

如果凭据只在构建阶段使用,应使用构建工具提供的 build secret 能力,并确认构建命令、缓存和日志不会输出内容。运行时凭据则应在容器启动或应用初始化阶段通过 /run/secrets 读取。

同样,不要把密码放到命令行参数中:

services:
  api:
    command: ["./server", "--password", "${DB_PASSWORD}"]

命令参数可能出现在容器配置、进程列表、部署日志和故障诊断输出中。

服务级授权不等于进程级授权

下面的配置可以限制 worker 不获得数据库密码:

services:
  api:
    secrets:
      - db_password

  worker:
    secrets:
      - payment_token

但如果 api 容器内同时运行 Web 服务、定时任务和调试代理,这些进程通常共享同一个容器文件系统和用户权限。任何能读取 /run/secrets/db_password 的进程都可能获取凭据。

因此,需要凭据隔离时,优先考虑:

  • 将不同职责拆分到不同容器;
  • 不在同一个容器中运行不可信的调试工具;
  • 使用非 root 用户运行应用;
  • 不把 /run/secrets 目录复制到其他目录;
  • 禁止诊断接口直接展示环境变量和文件内容。

更新不会自动等于轮换

环境变量通常在容器创建时注入。修改 .env 或主机上的变量文件,并不代表已经运行的进程会自动获得新值。

文件型 secret 的更新也不能简单理解为“改文件就完成轮换”:

  • 应用可能只在启动时读取一次;
  • 应用可能一直持有旧文件描述符;
  • 本地文件挂载在不同平台上的更新表现可能不同;
  • 替换源文件后,已有容器是否看到新 inode,需要在目标环境中验证;
  • 即使应用读到了新值,后端服务也可能仍允许旧凭据一段时间。

更稳妥的轮换流程是:

更新不会自动等于轮换配图

  1. 在凭据提供方创建新凭据,并在支持的情况下保留旧凭据的短暂重叠期。
  2. 更新受控的 secret 源文件,避免通过聊天工具、命令历史或工单传递明文。
  3. 根据应用能力执行配置重载或重新创建对应服务。
  4. 用不输出凭据的方式验证新凭据确实可用。
  5. 确认业务连接恢复后,再撤销旧凭据。
  6. 保留可控回退方案:若新凭据不可用,恢复旧文件并重新加载服务;旧凭据已经撤销时,不应把回退理解为必然有效。

重新创建容器可能造成连接中断,应先确认服务副本数量、健康检查和连接重试策略。不要在生产环境未经验证就使用会影响全部副本的批量重建操作。

本地 Compose 与 Swarm secrets 不是同一安全模型

本地执行 docker compose up 时,file: 类型的 secret 通常依赖主机文件和本地挂载机制。它不会自动变成一个由 Docker 管理、加密保存并集中审计的凭据对象。

Docker Swarm 的原生 secrets 则由 Swarm 控制面管理,具有不同的存储、传输和容器挂载语义。使用 docker stack deploy 时,应按 Swarm secret 的生命周期和权限模型验证,不能把本地 Compose 的文件型行为直接套过去。

本地 Compose 与 Swarm secrets 不是同一安全模型配图

因此,下面两个判断不能混为一谈:

  • “secret 值没有写在 YAML 中”;
  • “secret 值已经由编排平台加密管理”。

前者是配置暴露面的改善,后者需要平台确实提供对应的秘密管理能力。external: true 也不等于自动接入任意外部密码管理系统,必须确认当前编排环境支持什么外部对象,以及它如何创建、读取和轮换。

一套不泄露值的验证方法

验证重点不是执行 cat /run/secrets/db_password,而是确认路径、权限、环境变量和日志行为,同时避免把测试过程变成新的泄露源。

先验证配置和文件边界

在项目目录中检查 secret 源文件是否被版本控制忽略,并确认文件权限。不要在公共终端、CI 日志或工单中输出文件内容:

git status --short --untracked-files=all -- secrets/
ls -l secrets/db_password
docker compose config --quiet

docker compose config --quiet 适合做语法和配置有效性检查。需要查看解析后的挂载关系时,应在受控终端执行 docker compose config,并留意是否存在通过 ${DB_PASSWORD} 注入的明文值。配置输出可能包含环境变量内容,不应直接粘贴到日志系统。

验证服务确实获得了文件

下面示例假设容器中存在 POSIX sh,并且应用服务名为 api:

cid="$(docker compose ps -q api)"

docker inspect "$cid" \
  --format '{{range .Mounts}}{{println .Destination}}{{end}}' |
  grep -Fx '/run/secrets/db_password' >/dev/null &&
  echo "secret mount exists"

再以容器实际运行用户检查文件可读性、非空状态,以及密码没有进入同名环境变量:

docker compose exec -T api sh -ceu '
test -r /run/secrets/db_password
test -s /run/secrets/db_password
test "${DB_PASSWORD+x}" = ""
test "${DB_PASSWORD_FILE:-}" = "/run/secrets/db_password"
printf "%s\n" "secret file is readable; password value is not in DB_PASSWORD"
'

这里没有打印文件内容。若应用不使用 DB_PASSWORD_FILE 这个变量,可以删除对应检查,但仍应确认应用自己的配置确实指向 /run/secrets/db_password。

还可以在受控环境中检查容器配置是否出现密码环境变量:

if docker inspect "$cid" \
  --format '{{range .Config.Env}}{{println .}}{{end}}' |
  grep -q '^DB_PASSWORD='; then
  echo "password environment variable found"
else
  echo "password environment variable not found"
fi

该命令不会把匹配行打印出来,但 Docker 返回的环境信息仍会经过本地管道处理。生产核查时应限制终端、脚本和审计系统的访问范围。

验证应用、日志和轮换行为

仅能读取文件,不代表应用使用正确。应使用测试凭据完成一次受控连接验证,并检查:

  • 应用日志中没有出现密码值;
  • 启动失败信息没有回显完整文件内容;
  • 健康检查接口没有返回环境变量或配置详情;
  • 崩溃转储、调试端点和诊断压缩包没有包含 secret;
  • 子进程环境中没有出现密码;
  • 修改测试凭据后,应用是否重新读取;
  • 重新创建服务后,是否确实挂载了新文件;
  • 撤销旧凭据后,旧连接和新连接的结果是否符合预期。

轮换测试最好先在独立项目和非生产凭据上进行。若发现修改主机文件后应用仍使用旧值,不要继续猜测,应分别测试“文件是否更新”“容器挂载是否更新”“应用是否重新读取”三个环节。

什么时候不应把 Compose secrets 当成完整方案

以下场景中,文件型 Compose secrets 可以作为降低暴露面的措施,但不应被视为完整的凭据保护方案:

  • 主机上存在多个不受信任的管理员或运维账号;
  • 容器内运行第三方代码,且该代码拥有 root 权限;
  • 凭据需要集中审计、细粒度授权和自动轮换;
  • 多主机部署需要统一分发,而不是每台主机维护一份明文源文件;
  • 应用会把配置复制到环境变量、日志、缓存或错误报告;
  • 需要在构建阶段访问私有仓库、私有包源或签名密钥;
  • 需要区分同一容器内多个进程的读取权限。

这时应结合外部秘密管理系统、平台原生 secret、短期凭据、主机权限控制、非 root 容器、日志脱敏和轮换机制。具体选型取决于部署平台,而不是仅由 Compose YAML 的写法决定。

最后可以用一个简单边界来判断:如果目标是避免密码出现在 Compose 配置、容器环境和普通子进程继承链中,Compose secrets 通常比环境变量更合适;如果目标是防止已控制主机或容器 root 的攻击者读取凭据,它们都不能单独提供这个保证。 是否真正达到预期,应以源文件权限、服务挂载范围、容器内读取测试、日志检查和一次完整轮换演练的结果为准。

A5数据为运行 Docker 化网站、接口、数据库及多任务服务提供中国香港、美国、日本、韩国、中国台湾、新加坡和马来西亚等地区的物理服务器资源,覆盖常规建站、AMD 计算、存储、多 IP 与不同带宽线路方案。结合 NVMe、SSD、大内存及多核处理器配置,可为容器服务提供相应的主机承载基础,支持跨地区业务部署与数据处理场景。

本文由A5数据原创发布,转载请注明出处:https://www.a5idc.com/helpcontent/5396.html

相关推荐