docker network inspect

描述

显示一个或多个 Docker 网络的详细信息。

默认情况下，该命令以 JSON 格式输出网络的完整配置和状态信息，包括网络驱动、子网、IP 范围、连接的容器等。

用法

docker network inspect [OPTIONS] NETWORK [NETWORK...]

你可以同时检查多个网络，只需在命令后依次列出它们的名称或 ID。

选项

选项	默认值	描述
-f, --format	无	使用自定义模板格式化输出： • 'json'：以紧凑 JSON 格式输出 • 'TEMPLATE'：使用 Go 模板语法自定义输出格式 更多格式说明请参见：Docker 输出格式化指南
-v, --verbose	false	启用详细诊断输出（主要用于调试，可能包含驱动特定的内部信息）

示例

1. 查看单个网络的详细信息

$ docker network inspect bridge

输出示例（节选）：

[
  {
    "Name": "bridge",
    "Id": "7ea29fc14122...",
    "Driver": "bridge",
    "Scope": "local",
    "IPAM": {
      "Driver": "default",
      "Config": [
        {
          "Subnet": "172.17.0.0/16",
          "Gateway": "172.17.0.1"
        }
      ]
    },
    "Containers": {
      "3a2b4c5d6e7f...": {
        "Name": "my_container",
        "EndpointID": "abc123...",
        "MacAddress": "02:42:ac:11:00:02",
        "IPv4Address": "172.17.0.2/16",
        "IPv6Address": ""
      }
    },
    "Options": {
      "com.docker.network.bridge.default_bridge": "true"
    }
  }
]

2. 同时检查多个网络

$ docker network inspect bridge host my_custom_network

输出将是一个包含多个网络对象的 JSON 数组。

3. 使用 --format 提取特定字段（Go 模板）

例如，只显示网络名称和驱动：

$ docker network inspect --format '{{.Name}} {{.Driver}}' bridge
bridge bridge

或者提取所有连接到某网络的容器名称：

$ docker network inspect --format '{{range .Containers}}{{.Name}} {{end}}' my_network
web_app db_cache

4. 以纯 JSON 格式输出（便于脚本处理）

$ docker network inspect --format json my_network
{"Name":"my_network","Id":"..."}

注意：--format 'json' 是 Docker CLI 提供的便捷写法，等价于使用完整的 Go 模板 {{json .}}。

5. 启用详细模式（--verbose）

$ docker network inspect --verbose my_overlay_network

此选项会输出额外的诊断信息，例如网络插件的状态、底层网络接口详情等，具体取决于所使用的网络驱动（如 overlay、macvlan 或第三方插件）。

输出字段说明（常见）

• Name：网络名称

• Id：网络唯一标识符

• Created：创建时间

• Scope：作用域（local、swarm 等）

• Driver：网络驱动（如 bridge、overlay、host、macvlan）

• EnableIPv6：是否启用 IPv6

• IPAM：IP 地址管理配置（子网、网关、IP 范围等）

• Internal：是否为内部网络（禁止外部访问）

• Attachable：是否允许手动连接正在运行的容器（对 Swarm overlay 网络有效）

• Ingress：是否为 Swarm 的入口网络

• Containers：当前连接到该网络的容器列表，包含 IP、MAC 地址等

• Options：创建网络时指定的驱动选项

• Labels：用户定义的标签（键值对）