Dockerfile 安全体检清单:用 droast 揪出 root 运行、硬编码密钥与 curl|sh 等 10 大高危写法
Dockerfile 安全体检清单:用 droast 揪出 root 运行、硬编码密钥与 curl|sh 等 10 大高危写法
droast 是一款"很有主见"的开源 Dockerfile linter(Dockerfile 检查工具),它能像一位看过太多线上事故的资深工程师那样,逐行审读你的 Dockerfile,揪出 root 运行、硬编码密钥、curl | sh、chmod 777 等 10 大高危写法,并用最不留情面的方式告诉你问题出在哪。本文给出一份可直接对照的 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 运行(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
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 时问题行下方即时出现波浪线,悬停查看告警详情:
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/(真实扫描语料)



