Docker Compose v3下为IPvlan接口配置静态IP部署DHCP服务器

一、IPvlan/Macvlan 完全适配你的需求 #

这两种网络驱动都能让容器直接接入宿主机的物理网络，容器和外部桥接设备处于同一广播域，DHCP服务器可以直接向设备发送IP分配报文，完美匹配你的场景。相比Macvlan，IPvlan不需要修改宿主机网卡的MAC地址，对现有网络环境影响更小，优先选它没错。

二、Compose v3 配置 IPvlan 静态IP的正确姿势 #

直接上可运行的配置示例，关键参数逐一解释：

version: '3.8'

networks:
  ipvlan_dhcp_net:
    driver: ipvlan
    driver_opts:
      parent: eth0  # 替换成你宿主机的物理网卡名，比如enp0s3、ens33
    ipam:
      config:
        - subnet: 192.168.50.0/24  # 填你要给DHCP客户端分配的IP段
          gateway: 192.168.50.1    # 填该网段的网关，一般是宿主机在这个网段的IP，或者物理网关
          # 可选：限定容器可用的IP范围，避免和DHCP分配池冲突
          ip_range: 192.168.50.150/28

services:
  dhcp-server:
    # 用成熟的DHCP镜像，比如networkboot/dhcpd
    image: networkboot/dhcpd:latest
    container_name: dhcp-server
    networks:
      ipvlan_dhcp_net:
        ipv4_address: 192.168.50.151  # 给DHCP容器分配的静态IP，必须在subnet范围内
    # DHCP服务需要网络管理权限，必须添加
    cap_add:
      - NET_ADMIN
    # 挂载自定义DHCP配置文件，定义分配池、网关等规则
    volumes:
      - ./dhcpd.conf:/etc/dhcp/dhcpd.conf
    restart: unless-stopped

关键配置说明 #

• parent参数：必须绑定到宿主机的物理网卡，不能用Docker默认的docker0桥接，否则外部设备收不到DHCP广播报文。
• subnet和gateway：subnet就是你计划给客户端分配的IP段；gateway要和客户端的默认路由一致——如果客户端需要通过宿主机上网，就填宿主机在该网段的IP；如果只是本地局域网通信，填该网段内的有效IP即可。
• ipv4_address：给DHCP容器的静态IP必须在subnet范围内，且要避开你在dhcpd.conf里定义的DHCP分配池，防止IP冲突。

三、网关/IP段的困惑解答 #

你不需要纠结复杂的路由配置，只要保证两点：

1. 宿主机的物理网卡已经配置了和subnet同网段的IP（比如192.168.50.2），或者宿主机本身就是该网段的网关。
2. DHCP配置文件dhcpd.conf里的subnet和Compose里的subnet完全一致，示例配置如下：

subnet 192.168.50.0 netmask 255.255.255.0 {
  range 192.168.50.10 192.168.50.149;  # 分配池避开容器的静态IP
  option routers 192.168.50.1;  # 和Compose里的gateway保持一致
  option subnet-mask 255.255.255.0;
}

四、必踩的坑要避开 #

• 必须给DHCP容器加NET_ADMIN权限，否则无法监听UDP 67端口的DHCP请求。
• 如果宿主机开启了防火墙，要放行UDP 67/68端口，不然DHCP报文会被拦截。
• IPvlan默认是L2模式，适合DHCP依赖的广播场景，不要改成L3模式，否则需要额外配置路由规则。

内容的提问来源于stack exchange，提问作者pedr0