首页/云/Docker 容器速查/docker history 查看镜像构建历史
本包目录(366 条)
基础命令50 条
镜像与构建107 条
网络与存储52 条Compose 编排55 条资源与安全50 条容器排障52 条

docker history 查看镜像构建历史

按层列出镜像的构建历史(对应 Dockerfile 指令)与每层大小变化,用于确认层来源、定位异常层与审计镜像内容。

Docker 容器速查云更新于 2026-10-12
用途查看镜像层与来源指令
语法docker history [--no-trunc] [--format 模板] 镜像
适用有构建历史的镜像

示例

示例
docker history app/web:1.0
docker history --no-trunc app/web:1.0
docker history --format 'table {{.CreatedBy}}	{{.Size}}' app/web:1.0
--no-trunc 显示完整指令;没有构建历史的镜像(docker import 或部分第三方导出镜像)会显示 <missing>。

易错点

  • history 输出顺序是从新到旧,排查大层时按 Size 列扫一遍比从头读效率高
  • 看到异常的超长 RUN 指令说明镜像未做分层清理,这通常是瘦身改造的切入点

数据来源与参考

  • Docker 官方 CLI 参考:docker history(docs.docker.com)
​‌‌​​‌​​​‌‌​‌‌‌‌​‌‌​​​‌‌​‌‌‌​​‌‌​​‌​‌‌‌​​‌‌‌​​​‌​‌‌​‌​​‌​‌‌‌​​​‌​‌‌​‌​​‌​‌‌​​​‌‌​‌‌‌​‌​​​‌‌​‌‌‌‌​​‌​‌‌‌​​‌‌​​​‌‌​‌‌​‌‌‌‌​‌‌​‌‌​‌