显示网络的概要
简介
podman network ls 命令用于显示现有的 podman 网络的列表。
语法
podman network ls [options]
选项
--filter, -f=filter=value
提供过滤器值。
filters 参数的格式为 key=value。如果有多个 filter，则需要传递多个选项：--filter foo=bar --filter bif=baz。
支持的过滤器：
| 过滤器 | 描述 |
|---|---|
| driver | 按驱动类型过滤。 |
| id | 按网络ID（完整或部分）过滤。 |
| label | 过滤具有（或不具有，当使用 label!=[...] 时）指定标签的网络。 |
| name | 按网络名称过滤（接受正则表达式）。 |
| until | 过滤在给定时间戳之前创建的网络。 |
| dangling | 过滤没有容器连接的网络。 |
driver 过滤器接受的值有：bridge，macvlan，ipvlan。
label 过滤器接受两种格式。一种是 label=key 或 label=key=value，它显示具有指定标签的镜像。另一种格式是 label!=key 或 label!=key=value，它显示没有指定标签的镜像。
until 过滤器可以是 Unix 时间戳、日期格式的时间戳，或者是相对于机器时间的 Go 持续时间字符串（例如 10m, 1h30m）。
dangling 过滤器接受的值有 true 或 false。
通过使用这些过滤器，用户可以更精确地选择和查看符合特定条件的网络。例如，用户可以使用 driver 过滤器只查看使用特定驱动类型的网络，或者使用 name 过滤器通过正则表达式匹配网络名称。这些过滤器可以单独使用，也可以组合使用，以满足用户的不同需求。
--format=format
改变默认的输出格式。这可以是像 'json' 这样的支持的类型，或者是一个 Go 模板。 Go 模板的有效占位符如下：
| 占位符 | 描述 |
|---|---|
| .Created ... | 网络创建的时间戳 |
| .DNSEnabled | 网络是否启用了 DNS（布尔值） |
| .Driver | 网络驱动 |
| .ID | 网络 ID |
| .Internal | 网络是否为内部网络（布尔值） |
| .IPAMOptions ... | 网络的 IPAM 选项 |
| .IPv6Enabled | 网络是否启用了 IPv6 子网（布尔值） |
| .Labels | 网络的标签 |
| .Name | 网络名称 |
| .NetworkDNSServers | 在此网络中使用的 DNS 服务器数组 |
| .NetworkInterface | 主机上的网络接口名称 |
| .Options ... | 网络选项 |
| .Routes | 此网络的静态路由列表 |
| .Subnets | 此网络的子网列表 |
使用 --format 选项，用户可以自定义输出的格式，以适应自己的需求。例如，可以使用 JSON 格式来输出结构化的数据，或者使用 Go 模板来定义特定的输出字段和格式。通过选择合适的占位符，用户可以从网络对象中提取所需的信息，并将其以所需的方式呈现。
--no-trunc
不截断网络 ID。
--quiet, -q
使用 quiet 选项将输出限制为仅网络名称。
示例
显示所有网络：
$ podman network ls
NETWORK ID NAME DRIVER
88a7120ee19d podman bridge
6dd508dbf8cd podman6 bridge
8e35c2cd3bf6 podman5 macvlan
仅显示网络名称：
$ podman network ls -q
podman
podman2
outside
podman9
显示支持 bridge 插件的网络名称：
$ podman network ls --filter driver=bridge --format {{.Name}}
podman
podman2
podman9
列出网络及其子网：
$ podman network ls --format "{{.Name}}: {{range .Subnets}}{{.Subnet}} {{end}}"
podman: 10.88.0.0/16
podman3: 10.89.30.0/24 fde4:f86f:4aab:e68f::/64
macvlan:
另请参阅
podman(1), podman-network(1), podman-network-inspect(1), podman-network-create(1)
版本信息
2021年8月，由 Paul Holzinger 更新，增加了新的网络格式。
2019年8月，最初由 Brent Baude 整理。