DiagramPreview
進階預覽Live previewExportDeveloper tool

Dockerfile 視覺化

将 Dockerfile 构建阶段和指令視覺化为步骤圖。

範例
預覽結果就緒
预览结果会显示在这里。

下一步可以繼續

把目前預覽結果帶到相關工具,繼續轉換、排查或匯出。

設計規範產生器

產生 Markdown 設計規範、檢查交接缺漏,並以流程圖補充說明。

開啟
AI 圖表生成器

用自然語言提示詞生成 Mermaid 圖表。

開啟
Mermaid AI 修復器

用 AI 修復 Mermaid 語法並提升圖表可讀性。

開啟

使用方法

  1. 1粘贴 Dockerfile,或加载 Node、Python、多阶段构建示例。
  2. 2检查构建阶段、指令顺序、复制产物,以及 latest、缺少 USER 等提示。
  3. 3确认构建依赖没有进入最终运行时镜像。
  4. 4需要在 PR 或 runbook 里解释镜像结构时,可以导出图。

常見場景

Dockerfile review容器安全说明多阶段构建解释AI Dockerfile 校验平台 onboarding

常見問題

优先检查哪些 Dockerfile 风险?

先看基础镜像是否固定版本、是否缺少 USER、是否有 curl | sh、remote ADD,以及最终镜像里是否残留包管理器缓存。

这个工具能证明镜像安全吗?

不能。它是可视化 review 辅助,仍需要镜像扫描、依赖固定和运行时测试。

为什么要把 Dockerfile 可视化?

多阶段构建的边界、复制产物和运行时依赖用图更容易解释,特别适合 PR review。

Dockerfile Visualizer 会把构建阶段、基础镜像、COPY/RUN 指令和运行时决策转成更容易 review 的图。

它适合检查 AI 生成 Dockerfile 里“能构建但不稳”的问题,例如 latest 标签、远程安装脚本、缺少 USER、运行时镜像包含过多依赖。

可用于 PR review、镜像加固、多阶段构建说明和平台新人 onboarding。

Demo:检查 Node Dockerfile 的生产风险

Dockerfile 本地能跑,不代表生产稳定。可视化后可以快速看到运行时镜像是否固定、是否足够小、是否以非 root 用户运行。

  • 优先使用 node:20-bookworm-slim,而不是 node:latest。
  • 用多阶段构建避免 devDependencies 进入运行时镜像。
  • 应用不需要 root 权限时,应添加 USER。
FROM node:20-bookworm-slim AS deps
WORKDIR /app
COPY package*.json ./
RUN npm ci

FROM node:20-bookworm-slim
WORKDIR /app
COPY --from=deps /app/node_modules ./node_modules
COPY . .
USER node
CMD ["npm", "start"]

预览图应能展示依赖阶段、运行时阶段、复制产物和非 root 运行决策。

PR 里值得说明的 Dockerfile 警告

当预览提示可疑指令时,最好转成具体 review 评论,而不是只说“不安全”。

  • FROM latest 会让重建结果在没有代码变更时发生变化。
  • curl | sh 隐藏安装脚本行为,审计困难。
  • apt-get install 后不清理缓存会增大镜像并保留构建依赖。

Dockerfile 視覺化 檢查清單

當你需要在文件、PR、事故復盤或交接材料發布前檢查原始內容時,可以使用 Dockerfile 視覺化。将 Dockerfile 构建阶段和指令視覺化为步骤圖。

匯出前建議檢查標籤是否可讀、關係是否和原始內容一致、範例是否包含敏感資訊,以及修改輸入後預覽是否仍然成立。

限制與排查

如果預覽失敗,先把輸入縮小到最小完整範例,確認格式語法,再逐段加回內容。

請把預覽結果視為 review 介面,而不是正式事實來源。進入文件或維運流程前仍需要人工確認。

可測試的範例輸入

  • Node: FROM node:22-alpine WORKDIR /app COPY package*.json ./ RUN npm ci COPY . . RUN npm run build EXPOSE 3000 CMD ["npm","start"]
  • Python: FROM python:3.12-slim WORKDIR /app COPY requirements.txt . RUN pip install -r requirements.txt COPY . . CMD ["python","app.py"]
  • Multi-stage: FROM node:22 AS build WORKDIR /app COPY . . RUN npm run build FROM nginx:alpine COPY --from=build /app/dist /usr/share/nginx/html

工具完成度

進階預覽

進階解析

此工具會從開發者輸入中提取結構與關係,適合除錯與文件 review;複雜邊界仍建議回到原始碼確認。

分級不是品質分數,而是說明目前工具更適合穩定匯出、深度除錯、快速解析,或 AI 輔助生成。