Docker CLI docker network ls 常用命令

1、docker network ls 简介

docker network ls 是Docker命令行工具中的一个命令，用于列出所有的网络。

参考文档：https://docs.docker.com/engine/reference/commandline/network_ls/

2、docker network ls 语法

docker network ls [OPTIONS]

3、docker network ls 命令

1）列出所有网络

docker network ls
NETWORK ID          NAME                DRIVER          SCOPE
7fca4eb8c647        bridge              bridge          local
9f904ee27bf5        none                null            local
cf03ee007fb4        host                host            local
78b03ee04fc4        multi-host          overlay         swarm

使用--no-trunc选项可显示完整的网络ID：

docker network ls --no-trunc
NETWORK ID                                                         NAME                DRIVER           SCOPE
18a2866682b85619a026c81b98a5e375bd33e1b0936a26cc497c283d27bae9b3   none                null             local
c288470c46f6c8949c5f7e5099b5b7947b07eabe8d9a27d79a9cbf111adcbf47   host                host             local
7b369448dccbf865d397c8d2be0cda7cf7edc6b0945f77d2529912ae917a0185   bridge              bridge           local
95e74588f40db048e86320c6526440c504650a1ff3e9f7d60a497c4d2163e5bd   foo                 bridge           local
63d1ff1f77b07ca51070a8c227e962238358bd310bde1529cf62e6c307ade161   dev                 bridge           local

2）筛选（--filter）

筛选标志（-f或--filter）的格式是键=值对。如果有多个筛选条件，则需要传递多个标志（例如，--filter "foo=bar" --filter "bif=baz"）。多个筛选标志会组合成OR筛选条件。例如，-f type=custom -f type=builtin可以返回自定义和内置网络。

目前支持的筛选条件有：

• driverid（网络ID）
• label（label=或label==）
• name（网络名称）
• scope（swarm|global|local）
• type（custom|builtin）

3）Driver

驱动程序筛选器根据网络的驱动程序进行匹配。

以下示例将匹配带有bridge驱动程序的网络：

docker network ls --filter driver=bridge
NETWORK ID          NAME                DRIVER            SCOPE
db9db329f835        test1               bridge            local
f6e212da9dfd        test2               bridge            local

4）ID

id筛选器匹配一部分或全部网络ID。

以下示例将匹配所有ID包含字符串63d1ff1f77b0...的网络。

docker network ls --filter id=63d1ff1f77b07ca51070a8c227e962238358bd310bde1529cf62e6c307ade161
NETWORK ID          NAME                DRIVER           SCOPE
63d1ff1f77b0        dev                 bridge           local

也可以按子字符串过滤ID，如下所示：

docker network ls --filter id=95e74588f40d
NETWORK ID          NAME                DRIVER          SCOPE
95e74588f40d        foo                 bridge          local
docker network ls --filter id=95e
NETWORK ID          NAME                DRIVER          SCOPE
95e74588f40d        foo                 bridge          local

5）Label

标签筛选器仅基于标签或标签和值匹配网络。

以下示例将匹配具有usage标签的所有网络，无论其值如何：

docker network ls -f "label=usage"
NETWORK ID          NAME                DRIVER         SCOPE
db9db329f835        test1               bridge         local
f6e212da9dfd        test2               bridge         local

以下示例将匹配具有prod值的usage标签的所有网络：

docker network ls -f "label=usage=prod"
NETWORK ID          NAME                DRIVER        SCOPE
f6e212da9dfd        test2               bridge        local

6）Name

名称筛选器匹配一部分或全部网络名称。

以下示例将匹配所有名称包含字符串foobar的网络。

docker network ls --filter name=foobar
NETWORK ID          NAME                DRIVER       SCOPE
06e7eef0a170        foobar              bridge       local

也可以按名称中的子字符串过滤，如下所示：

docker network ls -f "label=usage=prod"
NETWORK ID          NAME                DRIVER        SCOPE
f6e212da9dfd        test2               bridge        local

7）Scope

范围筛选器根据其范围匹配网络。

以下示例将匹配具有swarm范围的所有网络：

docker network ls --filter scope=swarm
NETWORK ID          NAME                DRIVER              SCOPE
xbtm0v4f1lfh        ingress             overlay             swarm
ic6r88twuu92        swarmnet            overlay             swarm

以下示例将匹配具有本地范围的所有网络：

docker network ls --filter scope=local
NETWORK ID          NAME                DRIVER              SCOPE
e85227439ac7        bridge              bridge              local
0ca0e19443ed        host                host                local
ca13cc149a36        localnet            bridge              local
f9e115d2de35        none                null                local

8）Type

类型筛选器支持两个值；builtin显示预定义网络（bridge、none、host），而custom显示用户定义的网络。

以下示例将匹配所有用户定义的网络：

docker network ls --filter type=custom
NETWORK ID          NAME                DRIVER       SCOPE
95e74588f40d        foo                 bridge       local
63d1ff1f77b0        dev                 bridge       local

通过使用此标志，可以进行批量清理。例如，使用此筛选器删除所有用户定义的网络：

docker network rm `docker network ls --filter type=custom -q`

尝试删除与容器相关联的网络时，会发出警告。

9）格式化输出（--format）

使用Go模板，格式选项(--format)可对网络输出进行漂亮的打印。

下面列出了Go模板的有效占位符：

当使用--format选项时，network ls命令会按照模板声明的方式输出数据，或者在使用table指令时，也会包含列标题。

以下示例使用一个没有标题的模板，将所有网络的ID和Driver条目用冒号（:）分隔开进行输出：

docker network ls --format "{{.ID}}: {{.Driver}}"
afaaab448eb2: bridge
d1584f8dc718: host
391df270dc66: null

要以JSON格式列出所有网络，请使用json指令：

docker network ls --format json
{"CreatedAt":"2021-03-09 21:41:29.798999529 +0000 UTC","Driver":"bridge","ID":"f33ba176dd8e","IPv6":"false","Internal":"false","Labels":"","Name":"bridge","Scope":"local"}
{"CreatedAt":"2021-03-09 21:41:29.772806592 +0000 UTC","Driver":"host","ID":"caf47bb3ac70","IPv6":"false","Internal":"false","Labels":"","Name":"host","Scope":"local"}
{"CreatedAt":"2021-03-09 21:41:29.752212603 +0000 UTC","Driver":"null","ID":"9d096c122066","IPv6":"false","Internal":"false","Labels":"","Name":"none","Scope":"local"}

4、命令选项

5、子命令