docker inspect 命令可直接查看本地已存在镜像的完整元数据快照，核心字段包括唯一不可变的 id、本地标签 repotags、构建时间 created、作者 author、架构 architecture 与系统 os，以及构建历史 history。

直接用 docker inspect 查看特定标签镜像的元数据，核心在于确保该标签确实指向一个本地存在的镜像——inspect 本身不识别“远程标签”，只读取本地已拉取或构建完成的镜像快照。

确认标签是否真实存在本地

运行 docker images，检查目标镜像名和标签是否出现在输出中。例如：

• nginx:alpine 出现在列表里 → 可以 inspect
• nginx:1.25.8 没出现 → 需先 docker pull nginx:1.25.8
• 只看到 <none>:<none></none></none>（悬空镜像）→ 它没有 RepoTags，不能用标签名 inspect，得用 ID

查看完整元数据并定位关键构建字段

执行命令后，重点关注以下字段，它们直接反映构建来源与上下文：

Docker Image Puller

使用 Python 脚本下载 Docker 镜像并打包为 tar 文件。用户说“下载镜像”“拉取镜像”“pull xxx”“帮我下载 nginx 镜像”等时触发。支持 SOCKS5 代理直连（推荐）和国内镜像站加速两种模式。

下载

• Id：镜像唯一 SHA256 哈希，不可变，是内容真实性依据
• RepoTags：当前本地打上的标签数组，如 ["myapp:v2.1"]；为空说明该镜像未被标记
• Created：UTC 时间戳（精确到纳秒），格式如 "2026-09-22T14:03:17.224Z"，代表镜像构建完成时刻
• Author：来自 Dockerfile 的 LABEL maintainer= 或旧式 MAINTAINER 指令，常为空
• Architecture 和 Os：如 "amd64"、"linux"，决定运行兼容性
• History：每一步构建指令记录，含 created_by（如 /bin/sh -c #(nop) CMD ["node"]），可追溯哪一行改了配置

快速提取常用构建信息（用 -f 格式化）

避免翻长 JSON，用 Go 模板精准抓取：

• 创建时间：docker inspect -f '{{ .Created }}' nginx:alpine
• 作者信息：docker inspect -f '{{ .Author }}' myapp:v2.1
• 架构与系统：docker inspect -f '{{ .Architecture }}/{{ .Os }}' python:3.11-slim
• 构建指令溯源：docker inspect -f '{{json .History}}' ubuntu:24.04 | jq '.[-1].created_by'

标签 ≠ 元数据源头，注意常见误区

标签只是本地引用别名，不携带构建信息。同一镜像不同标签（如 app:latest 和 app:v1.0）inspect 出来的 Id、Created、History 完全一致。真正影响元数据的是构建过程（Dockerfile 内容、构建时参数、base 镜像版本），不是 tag 名字本身。