码头工人网络连接

描述

将容器连接到网络

API 1.21+  客户端和守护程序API都必须至少为 1.21, 才能使用此命令。docker version在客户端上使用命令检查客户端和守护程序API版本。

用法

$ docker network connect [OPTIONS] NETWORK CONTAINER

扩展说明

将容器连接到网络。您可以按名称或ID连接容器。连接后,容器可以与同一网络中的其他容器通信。

有关此命令的示例用法,请参阅下面的示例部分

选项

名称,简写 默认 描述
--alias 为容器添加网络范围的别名
--driver-opt 网络的驱动程序选项
--ip IPv4地址(例如172.30.100.104)
--ip6 IPv6地址(例如2001:db8 :: 33)
--link 将链接添加到另一个容器
--link-local-ip 为容器添加本地链接地址

例子

将正在运行的容器连接到网络

$ docker network connect multi-host-network container1

启动容器时将其连接到网络

您还可以使用该docker run --network=<network-name>选项启动容器,然后立即将其连接到网络。

$ docker run -itd --network=multi-host-network busybox

指定容器将在给定网络上使用的IP地址

您可以指定要分配给容器接口的IP地址。

$ docker network connect --ip 10.10.36.122 multi-host-network container2

您可以使用--linkoption链接另一个具有首选别名的容器

$ docker network connect --link container1:c1 multi-host-network container2

为容器创建网络别名

--alias 选项可用于通过所连接网络中的另一个名称来解析容器。

$ docker network connect --alias db --alias mysql multi-host-network container2

停止,暂停或重新启动容器的网络含义

您可以暂停,重新启动和停止连接到网络的容器。容器在运行时会连接到其配置的网络。

如果指定,重新启动已停止的容器时,将重新应用该容器的IP地址。如果IP地址不再可用,则容器无法启动。保证IP地址可用的一种方法是--ip-range在创建网络时指定一个,然后从该范围之外选择静态IP地址。这样可以确保当该容器不在网络上时,不会将IP地址提供给另一个容器。

$ docker network create --subnet 172.20.0.0/16 --ip-range 172.20.240.0/20 multi-host-network
$ docker network connect --ip 172.20.128.2 multi-host-network container2

要验证容器已连接,请使用docker network inspect命令。用于docker network disconnect从网络中删除容器。

连接到网络后,容器只能使用另一个容器的IP地址或名称进行通信。对于overlay支持多主机连接的网络或自定义插件,连接到同一多主机网络但从不同引擎启动的容器也可以这种方式进行通信。

您可以将容器连接到一个或多个网络。网络不必是同一类型。例如,您可以连接单个容器桥和覆盖网络。

上级命令

命令 描述
码头工人网络 管理网络
命令 描述
码头工人网络连接 将容器连接到网络
码头工人网络创建 创建一个网络
泊坞窗网络断开 断开容器与网络的连接
码头工人网络检查 在一个或多个网络上显示详细信息
码头工人网络ls 列出网络
码头工人网络修剪 删除所有未使用的网络
码头工人网络 删除一个或多个网络