kathara/katharanp_vde

Docker VDE L2网络插件

镜像概述

该镜像提供一个Docker网络插件，专门用于创建纯二层（L2）网络环境。通过集成VDE（虚拟分布式以太网）软件交换机和tap虚拟网络接口，实现Docker容器间的二层网络通信，补充Docker默认网络模型在纯L2层通信支持上的不足，适用于需要链路层直接交互的应用场景。

核心功能与特性

• 纯二层网络创建：支持构建不依赖IP层的纯L2网络，容器间通过数据链路层直接通信
• VDE软件交换机集成：采用VDE虚拟交换机技术，提供稳定的二层转发能力，支持多节点分布式部署
• tap接口驱动：基于tap虚拟网络接口实现容器与虚拟交换机的连接，模拟物理网络接口特性
• Docker原生集成：符合Docker网络插件规范，可通过Docker CLI/API进行网络生命周期管理
• L2层通信支持：原生支持广播、组播等二层网络特性，兼容ARP、LLDP等链路层协议

使用场景与适用范围

• 二层协议依赖场景：运行依赖ARP、STP、LLDP等二层协议的网络服务或应用
• NFV测试环境：构建网络功能虚拟化（NFV）测试平台，模拟物理网络设备的二层连接
• 网络拓扑仿真：开发/测试环境中复现复杂物理二层网络拓扑，验证网络设备交互逻辑
• 低延迟通信需求：需要规避IP层路由转发延迟，实现容器间直接链路层通信的场景
• 广播/组播应用：支持需要二层广播或组播通信的应用（如集群发现、实时数据流分发）

使用方法与配置说明

前提条件

• Docker Engine 1.12+（支持网络插件系统）
• 主机内核支持tap接口（通常Linux内核默认支持）
• 安装依赖包：vde2（提供VDE交换机）、uml-utilities（提供tap接口管理工具）

插件安装

通过Docker插件管理命令安装（假设插件已发布至Docker插件仓库）：

bash
docker plugin install --grant-all-permissions vde-l2-network-plugin:latest

网络创建

使用插件驱动创建纯二层网络：

bash
docker network create \
  --driver=vde-l2-network-plugin \
  --opt vde_switch_path=/usr/bin/vde_switch \
  --opt tap_prefix=vde-tap \
  --opt mtu=1500 \
  my-l2-network

网络创建参数说明：

• --driver: 指定使用该L2网络插件
• --opt vde_switch_path: VDE交换机可执行文件路径（默认：/usr/bin/vde_switch）
• --opt tap_prefix: tap接口名称前缀（默认：vde）
• --opt mtu: 网络接口MTU值（默认：1500）
• --opt vlan_id: 可选，指定VLAN标签（如vlan_id=100）实现VLAN隔离

容器连接与通信

基本连接示例

启动容器并连接至创建的L2网络：

bash
# 启动容器1
docker run -d --name=container-l2-1 --network=my-l2-network --rm docker.xuanyuan.run/nginx:alpine

# 启动容器2（交互式）
docker run -it --name=container-l2-2 --network=my-l2-network --rm docker.xuanyuan.run/alpine sh

二层通信验证

在container-l2-2中安装网络工具并验证L2连通性：

bash
# 安装必要工具
apk add --no-cache iproute2 arping

# 查看容器网络接口（确认tap接口存在）
ip link show

# 获取目标容器MAC地址（假设container-l2-1的IP为192.168.1.10）
arping -I eth0 192.168.1.10

配置示例：docker-compose集成

在docker-compose.yml中使用该网络插件：

yaml
version: '3.8'

networks:
  l2-network:
    driver: vde-l2-network-plugin
    driver_opts:
      vde_switch_path: /usr/bin/vde_switch
      tap_prefix: app-tap
      mtu: 1450

services:
  node1:
    image: docker.xuanyuan.run/nginx:alpine
    networks:
      - l2-network

  node2:
    image: docker.xuanyuan.run/alpine:latest
    command: sleep infinity
    networks:
      - l2-network

启动服务：

bash
docker-compose up -d

注意事项

• 依赖安装：主机需预先安装vde2和uml-utilities包（Debian/Ubuntu: apt install vde2 uml-utilities；RHEL/CentOS: yum install vde2 uml-utilities）
• IP地址管理：纯L2网络不提供IP分配功能，需手动配置容器IP或部署DHCP服务
• 性能考量：VDE软件交换机为用户态实现，高吞吐量场景建议评估性能需求
• 安全隔离：默认不提供网络隔离，生产环境建议结合VLAN配置（vlan_id选项）或主机防火墙策略

卸载说明

bash
# 移除所有使用该插件的网络
docker network rm $(docker network ls --filter driver=vde-l2-network-plugin -q)

# 卸载插件
docker plugin disable vde-l2-network-plugin:latest
docker plugin rm vde-l2-network-plugin:latest