docker info 命令（保姆级教程）

Docker Info 命令：你必须掌握的系统级诊断工具

在使用 Docker 的过程中，你可能会遇到容器无法启动、镜像拉取失败、资源占用异常等问题。这时候，一个简单却强大的命令能帮你快速定位问题根源——那就是 docker info。这个命令就像 Docker 的“体检报告”，能让你全面了解当前 Docker 环境的运行状态、资源使用情况和配置细节。

对初学者而言，docker info 命令看似普通，实则蕴含丰富信息。它不只是一串数据罗列，更是一张系统健康图谱。无论你是刚接触容器化技术，还是已经使用 Docker 一段时间的开发者，掌握这个命令都能让你在排查问题时事半功倍。

什么是 Docker Info 命令？

docker info 是 Docker CLI 提供的一个核心诊断命令，用于输出当前 Docker 引擎的详细信息。它涵盖从系统环境、存储驱动、网络配置到运行时资源等几乎所有关键指标。

你可以把它想象成一台汽车的“仪表盘”：当你开车时，仪表盘上的发动机温度、油量、转速等数据，能帮助你判断车辆是否正常运行。而 docker info 就是 Docker 的“仪表盘”，让你随时掌握容器引擎的运行状态。

执行命令非常简单：

docker info

运行后，你会看到一长串输出信息。别被吓到，这些信息其实是有结构的，我们接下来会逐一拆解。

核心信息解析：从系统到运行时

Docker 版本与构建信息

这部分信息告诉你当前 Docker 引擎的版本号、构建时间以及架构信息。例如：

Client:
 Version:           24.0.7
 API version:       1.43
 Go version:        go1.20.11
 Git commit:        3e425f8
 Built:             Wed Nov  8 20:33:31 2023
 OS/Arch:           linux/amd64
 Experimental:      false

Server:
 Engine:
  Version:          24.0.7
  API version:      1.43 (minimum version 1.12)
  Go version:       go1.20.11
  Git commit:       3e425f8
  Built:            Wed Nov  8 20:33:31 2023
  OS/Arch:          linux/amd64
  Experimental:     false
  seccomp:          enabled
  cgroup v2:        enabled

Version：Docker 引擎和客户端的版本号。确保你使用的是稳定版本，避免因版本兼容问题导致异常。
API version：Docker 客户端与服务端通信所用的 API 版本。如果客户端版本过低，可能无法与高版本服务端通信。
Go version：Docker 本身是用 Go 语言开发的，这里显示的是其运行时环境。
Built：构建时间，可用于判断是否为官方发布版或自定义构建。
cgroup v2：容器资源限制机制，v2 是较新的标准，支持更精细的控制。

💡 提示：如果你发现 API version 与 Minimum version 不一致，可能是客户端或服务端版本不匹配，需升级。

存储与镜像管理

这部分信息关乎容器的持久化和镜像存储，是理解 Docker 如何管理数据的关键。

Storage Driver: overlay2
 Backing Filesystem: extfs
 Supports d_type: true
 Native Overlay Diff: true

Storage Driver：Docker 使用的存储驱动。overlay2 是目前主流且推荐的选择，性能好、支持多层联合文件系统。
Backing Filesystem：底层文件系统类型。extfs 表示使用 ext4 文件系统，这是 Linux 上最常见的类型。
Supports d_type：表示是否支持目录类型信息，影响某些操作的性能。
Native Overlay Diff：是否启用原生 overlay 差分功能，提升镜像构建效率。

⚠️ 注意：如果你看到 Storage Driver: vfs，说明使用的是较老的存储方式，性能较差，建议迁移到 overlay2。

容器与镜像数量统计

这组数据能让你快速掌握当前环境的使用规模：

Containers: 12
 Running: 5
 Paused: 0
 Stopped: 7
 Images: 45

Containers：当前系统中所有容器的数量（包括运行中、停止、暂停的）。
Running：正在运行的容器数量。
Stopped：已停止但未删除的容器。
Images：本地镜像总数。

📌 实用场景：当你发现系统内存占用过高，可以先运行 docker info 查看容器和镜像数量。如果镜像数超过 100，可能需要清理无用镜像。

网络与 DNS 配置

容器之间的通信依赖于网络配置。docker info 提供了网络相关的关键参数：

Plugins:
 Volume: local
 Network: bridge host ipvlan macvlan null overlay
 Log: awslogs fluentd gcplogs gelf journald json-file local splunk syslog

Network：Docker 支持的网络类型。bridge 是默认网络，overlay 用于跨主机集群，host 直接使用宿主机网络。
Log：日志驱动类型，如 json-file 是默认的，适合本地调试。

🔄 小技巧：如果你在开发微服务，想让多个容器互通，确保 overlay 网络已启用。否则跨节点通信会失败。

资源使用与系统限制

这部分信息对排查性能问题至关重要：

Memory Limit: 16.00 GiB
Swap Limit: 16.00 GiB
Kernel Version: 5.15.0-76-generic
Operating System: Ubuntu 22.04.3 LTS
OSType: linux
Architecture: x86_64

Memory Limit：Docker 可用的最大内存。如果容器频繁 OOM（内存溢出），可能是这个限制太低。
Kernel Version：宿主机内核版本，某些新功能需要较新内核支持。
Operating System：操作系统版本，确保与 Docker 官方支持列表兼容。

🔍 案例：某开发者在 Ubuntu 20.04 上运行 Docker 24.0.7，发现 docker info 显示 Kernel Version: 5.4.0，但官方要求最低 5.10。最终通过升级内核解决启动失败问题。

实际应用场景：如何用 docker info 排查问题

场景一：容器启动失败，提示“no space left on device”

你尝试运行 docker run -d nginx，结果报错：

Error response from daemon: failed to create task for container: failed to create containerd task: failed to mount rootfs: no space left on device

此时，运行 docker info，查看以下几项：

Storage Driver：是否为 overlay2？如果不是，可能空间管理效率低。
Used Space：虽然 docker info 不直接显示“已用空间”，但可结合 df -h 查看 /var/lib/docker 分区容量。
Backing Filesystem：确认底层文件系统是否有足够空间。

✅ 解决方案：清理无用镜像和容器，或扩展磁盘空间。

场景二：容器无法访问外部网络

你创建的容器启动后无法访问互联网，但宿主机正常。

运行 docker info，检查：

Network：是否包含 bridge？如果没有，可能网络配置错误。
Docker Default Bridge：默认桥接网络 docker0 是否存在？可通过 ip a 命令验证。
DNS：查看 DNS 配置是否正确，如 nameserver 8.8.8.8。

✅ 建议：若 DNS 未设置，可在 daemon.json 中添加：

{
  "dns": ["8.8.8.8", "1.1.1.1"]
}

重启 Docker 服务后生效。

常见问题与最佳实践

Q：为什么 `docker info` 输出太长？怎么精简？

A：你可以使用 --format 参数自定义输出格式。例如：

docker info --format '{{.Containers}} containers, {{.Images}} images, {{.MemoryLimit}} memory'

输出：

12 containers, 45 images, 16.00 GiB memory

✅ 适合脚本自动化调用，比如监控脚本。

Q：`docker info` 能查到容器日志吗？

A：不能。docker info 只提供系统级信息，不包含容器日志。要查看日志，应使用 docker logs <container_id>。

Q：`docker info` 会修改系统状态吗？

A：不会。它只是一个只读命令，用于信息查询，不会影响任何容器或镜像。

总结：掌握 Docker Info 命令的三大价值

快速诊断：遇到问题时，第一反应是运行 docker info，它能帮你快速定位是资源不足、配置错误还是版本不兼容。
环境审计：在部署新环境时，用 docker info 检查存储驱动、内核版本、内存限制等，确保满足生产要求。
持续监控：结合脚本定期调用 docker info，可构建简易的容器运行时监控系统。

记住：一个优秀的开发者，不是靠“试错”解决问题，而是靠“观察”和“分析”。docker info 命令正是你观察 Docker 系统的窗口。

下次当你遇到容器异常时，别急着重启或重装，先运行一次 docker info。你会发现，很多问题的答案，早就在那串输出里静静等待着你。