docker image inspect

显示一个或多个镜像的详细信息。

用法

docker image inspect [OPTIONS] IMAGE [IMAGE...]

该命令返回有关指定镜像的底层信息，包括其配置、元数据、层（layers）、创建时间、环境变量、入口点（Entrypoint）、工作目录（WorkingDir）等。输出默认为 JSON 格式。

你可以使用 --format（或 -f）选项来自定义输出格式，例如只提取特定字段。

选项

| 短选项 | 长选项 | 默认值 | 描述 | | | ---- | | | | -f | --format | 无 | 使用自定义 Go 模板格式化输出： • 'json'：以紧凑 JSON 格式输出 • 'TEMPLATE'：使用 Go 模板语法输出特定字段 更多格式化说明请参阅：https://docs.docker.com/go/formatting/ |

示例

1. 查看镜像的完整信息（JSON 格式）

docker image inspect nginx:latest

输出为包含所有镜像元数据的 JSON 数组（即使只查一个镜像，也会返回数组）。

2. 仅获取镜像 ID

$ docker image inspect --format='{{.Id}}' nginx:latest
sha256:605c77e624ddb75e6110f997c58876baa13f11cd244fd88e9a62403644a3bfa4

3. 获取镜像的架构和操作系统

$ docker image inspect --format='{{.Architecture}}/{{.Os}}' alpine
amd64/linux

4. 获取镜像的创建时间

$ docker image inspect --format='{{.Created}}' ubuntu
2024-03-15T01:23:45.678901234Z

5. 批量检查多个镜像

$ docker image inspect nginx:latest redis:alpine --format='{{.RepoTags}} {{.Size}}'
[nginx:latest] 142000000
[redis:alpine] 32500000

💡 注意：RepoTags 是一个字符串数组，因此在模板中会以 [tag1 tag2] 形式显示。