claymore666/net-dhcp

net-dhcp

Docker网络插件，让每个容器的IP从现有局域网DHCP服务器（如路由器）获取，而非Docker管理的地址池，使容器像局域网其他主机一样存在。

这是https://github.com/devplayer0/docker-net-dhcp%E7%9A%84%E7%BB%B4%E6%8A%A4%E5%88%86%E6%94%AF%E3%80%82%E5%8E%9F%E5%A7%8B%E8%AE%BE%E8%AE%A1%E5%92%8C%E6%A1%A5%E6%8E%A5%E6%A8%A1%E5%BC%8F%E7%9A%84%E5%AE%9E%E7%8E%B0%E5%BD%92%E5%8A%9F%E4%BA%8E%E4%B8%8A%E6%B8%B8%E4%BD%9C%E8%80%85%EF%BC%8C%E4%B8%8A%E6%B8%B8%E8%87%AA2021%E5%B9%B4%E8%B5%B7%E6%9C%AA%E6%9B%B4%E6%96%B0%EF%BC%8C%E6%97%A0%E6%B3%95%E5%9C%A8%E5%BD%93%E5%89%8DDocker%E7%89%88%E6%9C%AC%E8%BF%90%E8%A1%8C%EF%BC%8C%E6%9C%AC%E5%88%86%E6%94%AF%E5%BB%B6%E7%BB%AD%E5%B9%B6%E6%94%B9%E8%BF%9B%E4%BA%86%E8%AF%A5%E5%B7%A5%E4%BD%9C%E3%80%82

安装

bash
docker plugin install claymore666/net-dhcp:latest

也可通过GHCR获取：ghcr.io/claymore666/docker-net-dhcp:latest

与上游相比的改进

• 现代化工具链：Go 1.25、最新Docker SDK（v28）、最新Alpine系统
• 新增mode=macvlan：直接绑定到父网卡，无需主机桥接 -新增mode=ipvlan：适用于拒绝macvlan子MAC地址的交换机
• 修复守护进程重启死锁（网络选项持久化到磁盘）
• 通过60秒墓碑机制确保docker restart和systemctl restart docker时MAC+IP稳定
• 静态IP覆盖：每个端点可通过--driver-opt ip=192.168.X.Y设置
• 修复go test -race发现的数据竞争问题
• 整合上游PR（跳过路由、冲突检测绕过、IPv6支持）
• 每次PR的实时集成测试：覆盖完整生命周期、恢复、并发场景，生产代码路径覆盖率约70%

使用场景

适用于需要容器直接接入局域网、使用DHCP分配IP的场景，例如让容器作为局域网内的服务节点（如Nginx、数据库），与其他设备直接通信。

配置说明

桥接模式（兼容上游）

bash
docker network create -d claymore666/net-dhcp:latest \
    --ipam-driver null -o bridge=my-bridge my-dhcp-net

Macvlan模式（无需主机桥接）

bash
docker network create -d claymore666/net-dhcp:latest \
    --ipam-driver null -o mode=macvlan -o parent=eth0 lan-dhcp

Docker Compose示例

yaml
services:
  app:
    image: nginx
    networks: [lan-dhcp]
networks:
  lan-dhcp:
    external: true

链接

• 源码+完整变更日志：https://github.com/claymore666/docker-net-dhcp
• 上游项目：https://github.com/devplayer0/docker-net-dhcp

许可证

GPL-3.0，与上游一致，保留所有上游版权声明。