Dockerfile 安全体检清单:用 droast 揪出 root 运行、硬编码密钥与 curl|sh 等 10 大高危写法

原创2026-10-14 09:07:33404 阅读

Dockerfile 安全体检清单:用 droast 揪出 root 运行、硬编码密钥与 curl|sh 等 10 大高危写法

droast 是一款"很有主见"的开源 Dockerfile linter(Dockerfile 检查工具),它能像一位看过太多线上事故的资深工程师那样,逐行审读你的 Dockerfile,揪出 root 运行、硬编码密钥、curl | sh、chmod 777 等 10 大高危写法,并用最不留情面的方式告诉你问题出在哪。本文给出一份可直接对照的 Dockerfile 安全体检清单,附最快上手步骤,帮你的镜像在上线前过一遍"安检"。

droast Dockerfile 检查工具:燃烧的 Dockerfile 概念图

为什么你的 Dockerfile 需要一次"安全体检"?

Dockerfile 是镜像的唯一"出生证明"。写进去的每一行——基础镜像、环境变量、RUN 命令、权限设置——都会被永久固化进镜像,并在每次 docker build 后扩散到每一台运行它的机器。

一次常见却致命的组合拳通常是这样的:

  • 容器默认以 root 运行,攻击者拿到 shell 就等于拿到容器全部权限;
  • ENV DATABASE_PASSWORD=... 把密钥直接写进镜像,任何能 docker history 的人都能读出来;
  • RUN curl https://xx.sh | sh 让一条未校验的远程脚本决定你的构建过程;
  • 没有 .dockerignore,本地 .git/、私钥文件随构建上下文一起被打进镜像层。

droast 内置 85 条规则,覆盖安全、供应链、可复现性、性能与正确性等多个维度(完整规则见 src/rules.rs 中的 all_rules() 定义)。下面这份清单精选了其中与安全直接相关的 10 大高危写法。

10 大高危写法清单:逐条对照你的 Dockerfile

# 高危写法 典型症状 droast 规则 严重程度
1 容器以 root 运行 显式 USER root,或整个文件没有 USER 兜底 DF002 🔴 ERROR
2 未显式声明非 root 用户 隐式继承 root,"无意识裸奔" DF020 🔵 INFO
3 ENV/ARG 中硬编码密钥 ENV SECRET_KEY=...、ENV DATABASE_PASSWORD=admin123 DF014 🔴 ERROR
4 RUN 命令中硬编码凭据 安装步骤里内嵌账号、令牌 DF013 🔴 ERROR
5 curl | sh 执行远程脚本 未校验、未签名,脚本被篡改即沦陷 DF021 🔴 ERROR
6 chmod 777 全局可写 任何进程都能改写文件 DF034 🔴 ERROR
7 基础镜像用 :latest 镜像内容随时间漂移,构建不可复现 DF001 🟡 WARN
8 RUN 管道未设 pipefail 管道中任一步失败被静默吞掉 DF057 🟡 WARN
9 COPY . . 全量拷贝 构建上下文里的杂物、秘密一并入镜 DF007 🟡 WARN
10 缺少有效 .dockerignore 密钥、仓库、依赖目录搭上构建便车 DF033 🔵 INFO

修复方向速览:

  • 1 / 2(root 问题):在 Dockerfile 末尾加一个非特权 USER app 指令,构建阶段可以 root,运行阶段必须收敛。
  • 3 / 4(密钥问题):密钥一律走构建时的 --build-arg 注入或 RUN --mount=type=secret(BuildKit),绝不落盘进 ENV——环境变量会永久留在镜像历史里。
  • 5(curl | sh):先下载、再校验(sha256sum 比对或 GPG 签名),最后才执行。
  • 6(chmod 777):按最小权限原则改成 755 / 644 并明确属主。
  • 7(:latest):钉死具体版本标签,如 python:3.11-slim。
  • 8(pipefail):管道类 RUN 开头加 set -o pipefail。
  • 9 / 10(上下文问题):精确 COPY 所需文件,并维护一个有效的 .dockerignore。

droast Dockerfile 安全体检结果:root 运行与硬编码密钥告警截图

上图正是 droast 对一个"问题 Dockerfile" 的体检报告:root 运行(DF020)、curl | sh、chmod 777、硬编码的 SECRET_KEY 与数据库密码(DF013/DF014)、:latest 浮动标签(DF001)全部被点名。每条告警还附了一句"毒舌"点评(roast),可以加 --no-roast 切换为纯技术输出。

三步完成第一次 Dockerfile 体检

第一步:安装 droast

任选一种方式:

# 一行安装(macOS / Linux,自动识别 Homebrew)
curl -fsL ewry.net/droast/install.sh | sh

# 或 Homebrew
brew install droast

# 或不想安装任何东西,直接用容器
docker run --rm -v "$PWD:/workspace:ro" -w /workspace \
  immanuwell/droast:1.6.1 --no-roast .

第二步:运行检查

droast Dockerfile        # 检查单个文件
droast .                 # 递归扫描整个仓库(自动发现 Dockerfile.*、Containerfile 等)
droast --min-severity warning .   # 只看警告与错误,过滤噪音

droast 会递归识别 Dockerfile、Dockerfile.*、*.Dockerfile、Containerfile 等所有命名约定,并读取 Compose YAML 与 Bake 文件找到非标准路径的 Dockerfile。

第三步:按严重程度处理

droast --preset security .   # 只跑安全 + 供应链规则
droast --format github .     # 输出 CI 注释格式
droast --format json .       # 机器可读 JSON

droast Dockerfile 检查的 compact 与 JSON 输出格式截图

compact 格式一行一条、json 格式带指纹与规则详情,方便接入任何 CI 系统或二次开发。

把安全检查固化进团队工作流

CI 集成:5 行接入 PR 检查

在 CI 中使用 droast 的 GitHub Action,问题会以内联注释直接标注在 PR 的 diff 上(Action 定义见 action.yml):

- uses: immanuwell/dockerfile-roast@1.6.1
  with:
    files: '**/Dockerfile'
    preset: security

团队配置:一份 droast.toml 管住全部仓库

在项目根目录放一份 droast.toml,即可提交团队级默认策略,完整字段说明见 DOCS.md:

preset       = "production"   # minimal | security | performance | production | strict
min-severity = "warning"
fail-on      = "warning"      # 让警告也能拦住 CI

内置的 5 档预设各有分工:security 聚焦不安全用户、泄露密钥与危险下载;production 是全类别的平衡默认;strict 则要求每条豁免必须注明原因和过期时间,适合新项目和发布镜像。企业级示例(注册表白名单、基础镜像策略、强制 OCI 标签)可直接参考 examples/droast-enterprise.toml。

编辑器内实时体检:VS Code / Neovim 插件

安装 VS Code 扩展后,写 Dockerfile 时问题行下方即时出现波浪线,悬停查看告警详情:

VS Code 中 droast Dockerfile 插件的实时安全告警截图

code --install-extension ImmanuelTikhonov.droast

Neovim 用户可参考 nvim/README.md 一行脚本安装(插件源码在 nvim/lua/droast/)。

常见问题

droast 和 Hadolint 是什么关系? droast 提供 --hadolint-compatible 兼容模式(实现见 src/hadolint_compat.rs),可直接替换 Hadolint 调用,识别 .hadolint.yaml 配置与 DL#### 规则别名,并支持 sarif、junit 等 Hadolint 输出格式。还能用 droast init --from-hadolint .hadolint.yaml 一键迁移策略。

误报了怎么跳过? 单条跳过:droast --skip DF012 Dockerfile;行内豁免需写明理由与过期时间(strict 预设下强制):

# droast ignore=DF001 reason="PLAT-142 migration" expires=2026-09-30
FROM alpine:latest

能不能顺手修掉一部分问题? 可以。droast --fix --dry-run --format diff Dockerfile 先预览,确认后再 --fix 应用,目前覆盖 4 类可确定性修复的机械性规则(详见 src/fixes.rs 与 DOCS.md)。

小结

Dockerfile 的安全隐患往往就藏在你"随手一写"的那几行里:root 运行、硬编码密钥、curl | sh、chmod 777、latest 标签……用 droast 做一次 10 大高危写法体检,成本只有两条命令:

brew install droast
droast --preset security .

对照本文清单逐条消除告警,再把它钉进 CI 与编辑器,你的镜像在出厂前就具备了第一道真正的安全防线。

延伸阅读:README.md(功能全览) · DOCS.md(完整文档) · schemas/droast.schema.json(配置 Schema) · tests/fixtures/(真实扫描语料)

登录后查看全文
dockerfile-roast