异常教程

docker info 命令（一文讲透）

更新时间:

💡一则或许对你有用的小广告

欢迎加入小哈的星球 ，你将获得：专属的项目实战 / 1v1 提问 / Java 学习路线 / 学习打卡 / 每月赠书 / 社群讨论

截止目前， 星球 内专栏累计输出 90w+ 字，讲解图 3441+ 张，还在持续爆肝中.. 后续还会上新更多项目，目标是将 Java 领域典型的项目都整一波，如秒杀系统, 在线商城, IM 即时通讯，权限管理，Spring Cloud Alibaba 微服务等等，已有 3100+ 小伙伴加入学习 ，欢迎点击围观

在容器化技术蓬勃发展的今天，Docker 已成为开发者构建、部署和运行应用程序的必备工具。然而，许多开发者在使用 Docker 时，往往只停留在基础命令的表面，例如 docker run 或 docker build。今天，我们聚焦一个看似简单却极具实用价值的命令——docker info。这个命令不仅是 Docker 系统状态的“体检报告”，更是排查问题、优化配置的“瑞士军刀”。通过深入理解 docker info，开发者可以更高效地掌控 Docker 的运行机制，避免因配置不当或资源不足导致的故障。

一、什么是 docker info 命令？

docker info 是 Docker 提供的系统级诊断命令，用于展示 Docker 守护进程（Docker Daemon）的详细配置信息、运行状态以及系统资源的使用情况。它类似于操作系统的 systemctl status 或 top 命令，但针对 Docker 生态进行了深度定制。

形象比喻：
如果把 Docker 守护进程比作一座城市的交通指挥中心，那么 docker info 就是指挥中心的监控大屏，实时显示道路（网络）、车辆（容器）、加油站（存储驱动）等基础设施的运行状态。

基础语法：

docker info [OPTIONS]

二、命令输出详解：从头读懂 Docker 的“体检报告”

执行 docker info 后，会输出大量信息。以下通过分段解析，逐步揭开这些字段的含义：

1. Docker 版本与基础配置

Client:  
 Context:    default  
 Debug Mode: false  
 Plugins:  
  buildx: Docker Buildx (Docker Inc., v0.11.2)  
  compose: Docker Compose (Docker Inc., v2.20.3)  

Server:  
 Containers: 3  
  Running: 2  
  Paused: 0  
  Stopped: 1  
 Images: 15  
 Server Version: 24.3.1  
 Storage Driver: overlay2
  • Client 部分：显示 Docker 客户端（CLI）的版本及插件信息，例如 buildx 和 compose 插件的版本。
  • Server 部分：展示 Docker 守护进程的运行状态，包括当前容器数量（运行中、暂停、停止）、镜像数量、版本号及存储驱动类型。

关键字段解析：

  • Storage Driver：Docker 存储数据的方式，overlay2 是最常见的 Linux 存储驱动，类似文件系统中的“分层存储”，支持高效快照和隔离。
  • Server Version：守护进程版本，若与客户端版本不一致，可能引发兼容性问题。

2. 网络与资源限制

Networks: 2  
 Swap: disabled  
 Memory: 8GiB  
 Memory Limit: enabled  
 Swap Limit: enabled
  • Networks：系统中已创建的 Docker 网络数量，包括默认的 bridge 网络。
  • Memory：显示 Docker 守护进程分配的内存总量及限制策略（是否启用内存限制）。

案例场景：
假设开发者发现容器频繁因内存不足崩溃，可以通过 docker info 检查 Memory Limit 是否已启用，并结合 docker container inspect 查看具体容器的内存配额。

3. 存储与镜像配置

Logging Driver: json-file  
 Cgroup Version: 2
  • Logging Driver：容器日志的默认存储方式，json-file 是默认选项，也可配置为 syslog 或 journald。
  • Cgroup Version：控制组（Cgroups）的版本，用于资源隔离和限制。Cgroup v2 提供更精细的资源控制能力。

进阶思考：
若 docker info 显示 Cgroup Version: 1，而开发者需要使用某些高级特性（如更细粒度的 CPU 配额），可能需要升级系统内核以支持 Cgroup v2。

4. 安全与实验性功能

Live Restore Enabled: true  
 Isolation: process  
 No Proxy: *.local, 169.254/16
  • Live Restore：是否启用守护进程重启时容器的无缝接管功能。
  • Isolation：容器的隔离模式，默认为 process（基于 Linux 命名空间），在 Windows 上可能为 hyperv（基于 Hyper-V）。

三、实战场景：如何用 docker info 解决问题？

场景 1：排查容器启动失败

假设用户尝试启动一个容器时收到错误：Cannot connect to the Docker daemon at unix:///var/run/docker.sock。此时，执行 docker info 可能会发现：

WARNING: No swap limit support

解决方案：
通过修改 /etc/docker/daemon.json 添加 {"live-restore": true} 并重启 Docker 服务，即可解决因缺少交换空间支持导致的连接问题。

场景 2：优化存储驱动性能

若 docker info 显示 Storage Driver: vfs，这表示 Docker 使用了性能较差的 vfs 驱动（通常因系统未安装 overlay2 依赖）。此时可通过以下步骤切换：

sudo apt-get install overlay  

sudo systemctl restart docker

四、高级用法：结合选项扩展功能

docker info 支持多个选项，可定制输出内容：

1. 过滤警告信息

docker info --filter "type=warning"

仅显示系统警告（如未启用的资源限制或过时配置）。

2. 生成简洁的 JSON 格式

docker info --format "{{json .}}"

输出结构化的 JSON 数据，便于脚本解析或集成到监控系统。

3. 指定上下文（Context）

若开发者使用多云环境或管理多个 Docker 主机，可通过 --context 指定目标：

docker info --context remote-server

五、常见问题与解答

Q1：为什么 docker info 显示的容器数量与 docker ps 不一致？

A：docker info 统计的是所有容器（包括停止状态），而 docker ps 默认仅显示运行中的容器。通过 docker ps -a 可查看全部容器。

Q2：如何查看 Docker 的日志路径？

A：在 docker info 的输出中搜索 Logging Driver 字段，例如 json-file 的日志默认存储在 /var/lib/docker/containers/<container-id>/。

结论

docker info 命令是 Docker 生态中的“全科医生”，它不仅帮助开发者快速掌握系统状态，还能在故障排查、性能优化和配置验证中发挥关键作用。无论是初学者还是资深开发者，定期使用 docker info 分析系统健康状况，都能显著提升容器化应用的可靠性和效率。

行动建议：

  1. 立即在本地执行 docker info，记录关键指标（如内存限制、存储驱动）。
  2. 尝试通过修改 daemon.json 配置文件调整系统参数，并观察 docker info 的变化。
  3. 在项目部署前，用 docker info 验证环境是否满足容器化需求。

通过深入理解这一命令，开发者不仅能更熟练地驾驭 Docker，还能在容器化实践中建立系统化、前瞻性的技术思维。

最新发布

查看更多文章