docker inspect 命令（长文讲解）

什么是 docker inspect 命令？

在使用 Docker 的过程中，你可能已经习惯于运行容器、查看日志、进入终端。但当你真正想深入了解一个容器或镜像内部“长什么样”时，docker inspect 命令就成了你最可靠的工具。

想象一下，你有一个快递包裹，外面贴着标签写着“重要文件”。你当然知道它很重要，但具体里面装了什么？是合同、发票还是图纸？只有打开才能知道。docker inspect 就像是这个“打开包裹”的钥匙，它能让你查看容器或镜像的详细元数据信息，包括网络配置、存储挂载、环境变量、启动命令、IP 地址等。

这个命令不是用来运行程序的，而是用来“诊断”和“分析”的。无论是排查容器无法启动的问题，还是想确认某个端口是否正确映射，docker inspect 都能提供关键线索。

docker inspect 命令的基本语法

docker inspect 的基本用法非常直接，只需在命令行输入：

docker inspect [选项] <容器名或ID> | <镜像名或ID>

其中：

• <容器名或ID>：可以是容器的短ID（如 a1b2c3d）、完整ID（如 a1b2c3d4e5f6）或自定义名称（如 my-nginx）。
• <镜像名或ID>：同样支持镜像的名称（如 nginx:latest）或 ID。
• [选项]：可选参数，用于控制输出格式或过滤信息。

💡 提示：如果你不确定容器或镜像的名称/ID，可以先运行 docker ps 查看正在运行的容器，或 docker images 查看本地镜像列表。

查看容器的详细信息

我们先来创建一个简单的容器，然后使用 docker inspect 查看它的信息。

docker run -d --name my-nginx -p 8080:80 nginx:latest

这条命令做了三件事：

1. 从 Docker Hub 下载 nginx:latest 镜像（如果本地没有）；
2. 启动一个后台运行的容器；
3. 将宿主机的 8080 端口映射到容器的 80 端口。

现在，我们用 docker inspect 查看这个容器的完整信息：

docker inspect my-nginx

执行后你会看到一大段 JSON 格式的输出。别被吓到，这就是 docker inspect 的“原生语言”——结构化的数据，便于程序解析。

我们来重点解读几个关键字段：

📌 注意：docker inspect 返回的是完整的 JSON 对象，所以输出非常庞大。如果你只想看某一部分，可以用 -f 选项格式化输出。

使用 -f 选项提取特定信息

-f 是 docker inspect 最实用的选项之一，它允许你用 Go 模板语法从输出中提取特定字段，避免被冗长的 JSON 淹没。

比如你想只查看容器的 IP 地址：

docker inspect -f '{{ .NetworkSettings.IPAddress }}' my-nginx

输出示例：

172.17.0.2

再比如你想查看端口映射情况：

docker inspect -f '{{ .NetworkSettings.Ports }}' my-nginx

输出：

map[80/tcp:[{0.0.0.0 8080}]]

这表示容器的 80 端口被映射到了宿主机的 8080 端口。

✅ 小技巧：你可以把 {{ .NetworkSettings.IPAddress }} 当作“从容器信息中取出 IP”的快捷指令。熟练掌握后，排查网络问题效率会大幅提升。

查看镜像的详细信息

docker inspect 不仅能查看容器，还能查看镜像的元数据。

我们来查看 nginx:latest 镜像的详细信息：

docker inspect nginx:latest

输出中会包含以下关键信息：

• Architecture：镜像支持的架构（如 amd64）
• Os：操作系统类型（如 linux）
• Layers：镜像的分层结构，每一层代表一次文件系统的变更
• Config：容器运行时的默认配置，如 CMD、EXPOSE、ENV 等
• Created：镜像创建时间

例如，查看镜像的默认启动命令：

docker inspect -f '{{ .Config.Cmd }}' nginx:latest

输出：

[/bin/bash]

⚠️ 注意：这里显示的是 nginx:latest 的默认命令，但实际运行容器时，nginx 容器的默认命令是 /usr/sbin/nginx -g 'daemon off;'，这是因为镜像在构建时定义了 CMD，而 docker inspect 查看的是镜像配置。

实用场景：排查容器无法访问的问题

假设你启动了一个 Web 服务容器，但浏览器访问 http://localhost:8080 时提示连接失败。这时候 docker inspect 就派上用场了。

1. 确认端口是否正确映射：

docker inspect -f '{{ .NetworkSettings.Ports }}' my-nginx

如果输出中没有 8080/tcp 映射到 80/tcp，说明端口映射有问题。

2. 确认容器是否真的在运行：

docker inspect -f '{{ .State.Running }}' my-nginx

输出为 true 表示容器正在运行，false 则说明已停止。

3. 查看容器的 IP 地址和网络配置：

docker inspect -f '{{ .NetworkSettings.IPAddress }}' my-nginx

如果 IP 是空的，说明网络未正确初始化。

4. 检查挂载点是否正确：

docker inspect -f '{{ .Mounts }}' my-nginx

如果有挂载错误，可能导致服务无法读取配置文件。

高级用法：结合脚本自动化分析

docker inspect 的 JSON 输出非常适合脚本处理。比如你可以写一个 Bash 脚本，自动检查所有运行中的容器是否暴露了敏感端口。

#!/bin/bash

for container in $(docker ps --format "{{.Names}}"); do
  ports=$(docker inspect -f '{{.NetworkSettings.Ports}}' "$container" 2>/dev/null)
  if [[ "$ports" == *"22/tcp"* ]]; then
    echo "⚠️  警告：容器 $container 暴露了 22 端口！"
  fi
done

这个脚本利用了 docker inspect 的输出，实现了安全巡检的功能。

总结：为什么你必须掌握 docker inspect 命令？

docker inspect 命令看似简单，实则功能强大。它不仅是 Docker 的“显微镜”，更是排查问题的“诊断仪”。

无论是初学者还是中级开发者，只要你在使用容器，就一定会遇到各种“为什么不起作用”的问题。而 docker inspect 就是你最可靠的答案来源。

通过它，你可以：

• 确认容器是否在运行；
• 查看端口映射是否正确；
• 获取容器的 IP 地址；
• 检查挂载点和环境变量；
• 为自动化运维脚本提供数据支持。

记住，Docker 不只是“运行容器”的工具，它更是一个完整的应用生命周期管理平台。而 docker inspect 命令，正是你深入这个平台内部的钥匙。

下次当你卡在某个问题上时，不要急着重启或重装，先试试 docker inspect —— 也许答案就在那几行 JSON 里。