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>（悬空镜像）→ 它没有 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 名字本身。
