开发辅助

Dockerfile 检查器

分析 Dockerfile 的最佳实践、安全问题和优化建议,提供即时反馈和可操作的改进方案。

免费使用 无需注册 浏览器本地运行

工具操作区

2 错误 10 警告 3 提示
行 1DL3007错误

FROM 使用了 `latest` 标签(镜像:ubuntu:latest)

固定具体版本标签,例如使用 ubuntu:22.04,而不是 ubuntu:latest。

行 8DL3020错误

此处使用 COPY 即可,不应使用 ADD

复制本地文件时使用 COPY 而不是 ADD。ADD 具有自动解压和远程 URL 等额外功能,可能带来意外行为。

行 2DL4000警告

MAINTAINER 已弃用

改用 LABEL maintainer="[email protected]"。

行 5DL3015警告

`apt-get install` 未使用 `--no-install-recommends`

添加 --no-install-recommends,避免安装不必要的软件包并减小镜像体积。

行 6DL3014警告

`apt-get install` 未使用 `-y` 标志

添加 -y 标志以避免交互式提示:apt-get install -y。

行 6DL3015警告

`apt-get install` 未使用 `--no-install-recommends`

添加 --no-install-recommends,避免安装不必要的软件包并减小镜像体积。

行 6DL3009警告

安装后缺少 `apt-get clean` 或 `rm -rf /var/lib/apt/lists/*`

在同一个 RUN 层清理 apt 缓存以减小镜像体积。

行 11DL3004警告

Dockerfile 中使用了 `sudo`

避免使用 sudo。使用 USER 切换用户,或直接以 root 运行命令(Docker 默认)。

行 13DL3011警告

EXPOSE 未指定端口号

指定有效端口号,例如 EXPOSE 8080。

行 15DL3006警告

缺少 HEALTHCHECK 指令

添加 HEALTHCHECK,让 Docker 知道如何检查容器是否仍在正常工作。

行 15DL3002警告

以 root 运行 — 未发现 USER 指令

添加 USER 指令,让容器以非 root 用户运行以提高安全性。

行 15DL3025警告

CMD 使用 shell 形式而不是 exec 形式

使用 exec 形式:CMD ["executable", "arg1", "arg2"],以便正确处理信号。

行 1DL3005提示

建议使用 .dockerignore 文件

.dockerignore 文件可从构建上下文排除不必要文件,加快构建并减小镜像体积。

行 4DL3003提示

发现 4 条连续 RUN 指令

使用 && 合并 RUN 指令以减少镜像层数。

行 9DL3000提示

WORKDIR 应使用绝对路径

使用绝对路径,例如 WORKDIR /app,而不是 WORKDIR app。

什么是Dockerfile 检查器?

Dockerfile 静态检查器通过解析容器构建指令,自动排查常见的镜像安全隐患、废弃语法与层缓存膨胀问题。它参考 Hadolint 核心规则集,按错误、警告与优化建议三个等级标出未固定版本标签(:latest)、混用 ADD 与 COPY、缺少非 root USER 声明、重复 CMD 指令以及未合并的 RUN 层,协助开发者构建更精简、更安全的生产容器镜像。

如何使用Dockerfile 检查器

  1. 1先填写“Dockerfile Content”中的必要内容。
  2. 2按需修改选项或补充输入,结果会随着页面状态自动更新。
  3. 3检查结果区域中的输出。

Dockerfile 检查器的常见使用场景

镜像推送前的安全与体积自检

在执行 docker build 与推送到镜像仓库前,提前发现未固定版本标签、多余缓存层与高危权限配置。

CI/CD 容器流水线规范对齐

在合并代码前快速用浏览器检查 Dockerfile 是否符合团队容器化最佳实践,减少流水线返工。

Code Review 容器配置评审

在评审基础设施代码时,一键标出 ADD 误用、缺少 USER 降权、多个 CMD 冲突或未清理 apt 缓存等问题。

常见问题

该 Dockerfile 检查器覆盖了哪些核心规则?

覆盖错误、警告与优化建议三大类共 15+ 条规则,包括缺失 FROM、使用 latest 浮动标签、混用 ADD 与 COPY、重复 CMD、使用 sudo、缺少非 root USER 及合并 RUN 层等。

为什么要固定基础镜像的具体版本号?

使用 :latest 或省略标签会导致上游镜像更新时引发不可预期的构建失败或依赖破坏;固定具体版本(如 node:20-alpine)能保证可重复构建。

为什么容器内默认以 root 运行会有安全风险?

一旦应用层存在漏洞被攻破,容器内的 root 身份会显著放大容器逃逸与宿主机受攻击的风险,因此建议在镜像末尾通过 USER 指令切换到普通权限账户。