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 驱动程序选项

创建自定义 `bridge` 网络时，可以传递以下附加选项。其中一些具有等效的标志，可以在 dockerd 命令行或 `daemon.json` 中用于配置默认的 bridge `docker0`。

以下参数可以传递给 `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` 来完成此操作。一次只能创建一个入口网络。只有当没有服务依赖它时才能删除该网络。创建 overlay 网络时可用的任何选项在创建入口网络时也可用，除了 `--attachable` 选项。

$ 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