docker network create

描述

创建一个新网络。DRIVER 接受bridge 或 overlay，它们是内置的网络驱动程序。如果您已安装第三方或您自己的自定义网络驱动程序，您也可以在此处指定该DRIVER。如果您没有指定--driver选项，则命令会自动为您创建一个bridge网络。安装 Docker Engine 时会自动创建一个bridge网络。此网络对应于 Docker Engine 传统上依赖的docker0桥接器。当您使用docker run启动新容器时，它会自动连接到此桥接网络。您无法删除此默认桥接网络，但可以使用network create命令创建新的网络。

$ docker network create -d bridge my-bridge-network

桥接网络是在单个 Docker Engine 安装上的隔离网络。如果您想创建一个跨多个运行 Docker Engine 的 Docker 主机的网络，则必须启用 Swarm 模式并创建一个overlay网络。要了解更多关于 Swarm 模式的 overlay 网络的信息，请参阅 "使用 overlay 网络"。

启用 Swarm 模式后，您可以创建一个 Swarm 范围的 overlay 网络。

$ docker network create --scope=swarm --attachable -d overlay my-multihost-network

默认情况下，Swarm 范围的网络不允许手动启动的容器连接。添加此限制是为了防止访问 Swarm 集群中非管理器节点的人员运行能够访问 Swarm 服务网络堆栈的容器。

上面示例中使用的--attachable选项禁用了此限制，并允许 Swarm 服务和手动启动的容器连接到 overlay 网络。

网络名称必须唯一。Docker 守护进程尝试识别命名冲突，但这不能保证。避免名称冲突是用户的责任。

Overlay 网络限制

当您使用默认的基于 VIP 的端点模式创建网络时，您应该使用/24块（默认值）创建 overlay 网络，这将您限制为 256 个 IP 地址。此建议解决了Swarm 模式的限制。如果您需要超过 256 个 IP 地址，请不要增加 IP 块大小。您可以使用带有外部负载均衡器的dnsrr端点模式，或者使用多个较小的 overlay 网络。有关不同端点模式的更多信息，请参阅配置服务发现。

选项

示例

连接容器

启动容器时，使用--network标志将其连接到网络。此示例将busybox容器添加到mynet网络。

$ docker run -itd --network=mynet busybox

如果要在容器已运行后将其添加到网络，请使用docker network connect子命令。

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

您可以使用docker network disconnect命令将容器从网络断开连接。

指定高级选项

创建网络时，Docker Engine 默认情况下会为该网络创建一个不重叠的子网。此子网不是现有网络的细分。它纯粹用于 IP 地址分配。您可以覆盖此默认值并使用--subnet选项直接指定子网值。在bridge网络上，您只能创建一个子网。

$ docker network create --driver=bridge --subnet=192.168.0.0/16 br0

此外，您还可以指定--gateway、--ip-range和--aux-address选项。

$ docker network create \
  --driver=bridge \
  --subnet=172.28.0.0/16 \
  --ip-range=172.28.5.0/24 \
  --gateway=172.28.5.254 \
  br0

如果您省略--gateway标志，Docker Engine 会从首选池中为您选择一个。对于overlay网络以及支持它的网络驱动程序插件，您可以创建多个子网。此示例使用两个/25子网掩码来遵守当前指南，即单个 overlay 网络中不超过 256 个 IP。每个子网有 126 个可用地址。

$ docker network create -d overlay \
  --subnet=192.168.10.0/25 \
  --subnet=192.168.20.0/25 \
  --gateway=192.168.10.100 \
  --gateway=192.168.20.100 \
  --aux-address="my-router=192.168.10.5" --aux-address="my-switch=192.168.10.6" \
  --aux-address="my-printer=192.168.20.5" --aux-address="my-nas=192.168.20.6" \
  my-multihost-network

确保您的子网不重叠。如果重叠，则网络创建失败，Docker Engine 返回错误。

桥接驱动程序选项

创建自定义网络时，默认网络驱动程序（即bridge）具有可以传递的其他选项。以下是这些选项以及用于 docker0 桥接器的等效 Docker 守护程序标志。

以下参数可以传递给任何网络驱动程序的docker network create，再次与用于 docker0 桥接器的 Docker 守护程序标志的近似等效项一起。

例如，让我们使用-o或--opt选项在发布端口时指定 IP 地址绑定。

$ docker network create \
    -o "com.docker.network.bridge.host_binding_ipv4"="172.19.0.1" \
    simple-network

网络内部模式（--internal）

内部网络上的容器可以在彼此之间进行通信，但不能与任何其他网络通信，因为没有配置默认路由，并且防火墙规则设置为丢弃来自其他网络的所有流量。可以与网关 IP 地址（以及相应配置的主机服务）进行通信，并且主机可以直接与任何容器 IP 通信。

默认情况下，当您将容器连接到overlay网络时，Docker 还会连接一个桥接网络来提供外部连接。如果您想创建一个外部隔离的overlay网络，您可以指定--internal选项。

网络入口模式（--ingress）

您可以创建将在 Swarm 集群中用于提供路由网状结构的网络。您可以通过在创建网络时指定--ingress来实现。一次只能创建一个入口网络。只有在没有服务依赖于它时才能删除该网络。除了--attachable选项外，创建 overlay 网络时可用的任何选项在创建入口网络时也可用。

$ docker network create -d overlay \
  --subnet=10.11.0.0/16 \
  --ingress \
  --opt com.docker.network.driver.mtu=9216 \
  --opt encrypted=true \
  my-ingress-network

在预定义网络上运行服务

您可以在预定义的 Docker 网络bridge和host上创建服务。

$ docker service create --name my-service \
  --network host \
  --replicas 2 \
  busybox top

具有本地范围驱动程序的 Swarm 网络

您可以使用本地范围网络驱动程序创建 Swarm 网络。您可以通过在创建网络期间将网络范围提升到swarm来实现。然后，您可以在创建服务时使用此网络。

$ docker network create -d bridge \
  --scope swarm \
  --attachable \
  swarm-network

对于提供跨主机连接的网络驱动程序（例如 macvlan），如果需要节点特定配置才能在每个主机上连接网络，则您将通过仅配置网络来提供该配置。创建 Swarm 范围的网络时，您将指定包含配置的网络的名称。

node1$ docker network create --config-only --subnet 192.168.100.0/24 --gateway 192.168.100.115 mv-config
node2$ docker network create --config-only --subnet 192.168.200.0/24 --gateway 192.168.200.202 mv-config
node1$ docker network create -d macvlan --scope swarm --config-from mv-config --attachable swarm-network