跳到主要内容

显示一个或多个网络的网络配置

概述​

podman network inspect 用于显示一个或多个网络的配置信息，输出格式为JSON。

用法​

podman network inspect [选项] 网络 [网络 ...]

选项​

  • --format, -f=格式：使用Go模板格式化输出。

示例​

--format, -f=format​

以JSON格式或使用Go模板美化打印网络信息。

占位符描述
.Containers ...运行在此网络上的容器。
.Created ...创建网络的时间戳。
.DNSEnabled网络是否启用了DNS（布尔值）。
.Driver网络驱动。
.ID网络ID。
.Internal网络是否为内部网络（布尔值）。
.IPAMOptions ...网络的IPAM选项。
.IPv6Enabled网络是否启用了IPv6子网（布尔值）。
.Labels ...网络标签。
.Name网络名称。
.Network ...嵌套的网络类型。
.NetworkDNSServers在此网络中使用的DNS服务器数组。
.NetworkInterface主机上的网络接口名称。
.Options ...网络选项。
.Routes此网络的静态路由列表。
.Subnets此网络上的子网列表。

使用--format或-f选项，你可以指定一个Go模板来定制输出的格式。例如，如果你只想打印网络的名称和ID，可以使用如下命令：

podman network exists --format "{{.Name}} {{.ID}}" <网络名称或ID>

Go模板的语法允许你以特定的方式格式化输出，并且可以访问上述占位符所代表的字段。这提供了一种灵活的方式来展示和解析网络相关的信息。

当结合脚本或自动化工具使用时，--format选项可以帮助你提取和呈现所需的确切数据，而无需解析复杂的输出或执行额外的处理步骤。

请注意，如果你不熟悉Go模板的语法，你可以查阅Go语言的文档来了解更多关于模板的详细信息和可用功能。

检查默认的podman网络​

$ podman network inspect podman
[
    {
        "name": "podman",
        "id": "2f259bab93aaaaa2542ba43ef33eb990d0999ee1b9924b557b7be53c0b7a1bb9",
        "driver": "bridge",
        "network_interface": "podman0",
        "created": "2021-06-03T12:04:33.088567413+02:00",
        "subnets": [
            {
                "subnet": "10.88.0.0/16",
                "gateway": "10.88.0.1"
            }
        ],
        "ipv6_enabled": false,
        "internal": false,
        "dns_enabled": false,
        "ipam_options": {
            "driver": "host-local"
        }
    }
]

显示网络的子网和网关​

$ podman network inspect podman --format "{{range .Subnets}}Subnet: {{.Subnet}} Gateway: {{.Gateway}}{{end}}"
Subnet: 10.88.0.0/16 Gateway: 10.88.0.1

在上面的命令中，--format 选项允许你使用Go模板来自定义输出格式。在这个例子中，我们遍历网络的子网数组，并输出每个子网的地址和网关。

另请参阅​

podman(1), podman-network(1), podman-network-ls(1), podman-network-create(1)

版本信息​

2021年8月，由Paul Holzinger更新了新的网络格式。

2019年8月，最初由Brent Baude整理。