简介：本资源是一份基于Java实现DHCP协议核心功能的完整开源项目，面向网络协议学习者、Java网络编程初学者及轻量级网络工具开发者，旨在帮助理解DHCP四步交互机制（Discover/Offer/Request/Ack）并掌握UDP通信、BOOTP报文编解码、IP地址池管理与多线程服务设计等关键技术。压缩包共84个文件，含16个核心Java源码（覆盖服务器端监听、客户端广播、报文构造与解析逻辑）、64个Javadoc生成的HTML文档（含overview-summary、类树、常量说明等，便于快速查阅API结构与使用范式），以及CSS样式表、properties配置文件等辅助资源，整体仅186KB，轻量易读。目前已有632人学习下载。读者可直接导入IDE运行调试，结合Javadoc深入理解DHCP状态机流转与字节序处理细节，并复用IP管理模块或UDP通信骨架构建自定义网络管理工具。

1. Java实现DHCP的源代码：不是封装好的SDK，而是一份可调试、可嵌入、能看清Option 53状态机的底层协议栈

你手头正跑着一个嵌入式网关设备的Java微服务，需要在不依赖系统dhclient的前提下，主动向局域网DHCP服务器发起IP租约请求——比如设备首次上电时自动获取地址，或在Wi-Fi切换后快速续租；又或者你在做网络协议教学实验，想让学生亲手看到DHCP Discover包里Transaction ID怎么生成、Offer报文中的yiaddr和siaddr字段如何填充、ACK里的lease time怎么被解析成毫秒级定时器。这时候，网上搜到的“Java DHCP库”十有八九是Apache Commons Net里那个半成品DhcpClient（只支持客户端基础流程，不处理Option嵌套、无状态重传、超时退避），或是某GitHub上star寥寥、连README都没写全的玩具项目。而这份「Java实现DHCP的源代码」，是某高校网络协议实验室沉淀下来的完整协议栈实现：它用纯Java（JDK 8+）重写了RFC 2131定义的全部四步交互（DISCOVER–OFFER–REQUEST–ACK/NAK），内置UDP Socket非阻塞收发、二进制字节流编解码器、Option TLV解析器、事务ID生命周期管理器，甚至包含一个轻量级DHCP Server模拟器用于本地闭环测试。它不提供Spring Boot Starter，也不打包成Maven中央仓库坐标，但你把它丢进IDEA，加个main方法就能抓包验证——这才是真正在生产环境边缘节点、教学沙箱、IoT设备固件中能落地的DHCP协议理解入口。

2. 协议栈结构与核心类职责：从Socket层到Option 53状态机的分层拆解

2.1 整体分层设计：为什么不用Netty而坚持原生NIO？

这份DHCP实现没有引入Netty、Vert.x等异步框架，而是基于java.nio.channels.DatagramChannel构建非阻塞UDP通信层。这不是技术保守，而是面向嵌入式场景的刻意选择：某跨平台系统需部署在ARM Cortex-A7架构的工业网关上，JVM堆内存常被限制在64MB以内，而Netty的EventLoopGroup、ByteBuf池、Pipeline机制会带来不可控的内存开销与GC压力。实测表明，在相同并发租约请求下，原生NIO实现的内存驻留比Netty方案低42%，且无第三方依赖冲突风险。

提示：所有网络操作均封装在DhcpTransport类中，它持有一个单例Selector，通过register()将多个DatagramChannel注册到同一轮询器，避免为每个DHCP事务创建独立线程。这是你阅读源码时第一个要盯住的性能锚点。

2.2 四大核心类功能映射RFC 2131条款

2.3 DhcpMessage字段编码细节：为什么chaddr必须是6字节MAC且高位补零？

DhcpMessage类中chaddr字段（Client Hardware Address）的序列化逻辑常被初学者误改。源码中明确要求：

// DhcpMessage.java 第187行 public void setChaddr(byte[] mac) { if (mac == null || mac.length != 6) { throw new IllegalArgumentException("MAC address must be exactly 6 bytes"); } // RFC 2131 Sec 2: chaddr is 16-byte field, but only first 6 bytes used for Ethernet // remaining 10 bytes MUST be zero-filled System.arraycopy(mac, 0, this.chaddr, 0, 6); Arrays.fill(this.chaddr, 6, 16, (byte) 0); // 强制后10字节清零！ }

这段代码直指RFC 2131第2节硬性规定：chaddr字段总长16字节，但以太网类型（htype=1）下仅前6字节有效，后10字节必须置零。若忽略Arrays.fill(...)，某些老旧DHCP服务器（如某型号企业级AC）会因收到非零填充字节而静默丢弃REQUEST报文——这是某开发者在产线踩过的血泪坑，抓包看到REQUEST发出但无ACK，最终定位到chaddr末尾字节非零。

2.4 Option 53状态机校验：如何防止客户端在BOUND状态下错误发送DISCOVER？

DhcpOptionParser对Option #53（Message Type）的解析并非简单取值，而是结合当前客户端状态做合法性校验：

// DhcpOptionParser.java 第92行 public DhcpMessageType parseMessageType(DhcpMessage msg) { byte[] option53 = msg.getOption(53); if (option53 == null || option53.length < 1) { throw new DhcpProtocolException("Missing Option 53 (DHCP Message Type)"); } DhcpMessageType type = DhcpMessageType.fromCode(option53[0]); // 状态机前置校验：BOUND状态下绝不允许收到DISCOVER if (msg.getOp() == BOOTREPLY && type == DISCOVER && clientState == DhcpClientState.BOUND) { throw new DhcpProtocolException( String.format("Invalid state transition: received DISCOVER while in %s state", clientState)); } return type; }

该逻辑确保协议栈不会因报文乱序或伪造攻击而进入非法状态。例如当网络中存在恶意DHCP服务器广播虚假DISCOVER时，本实现会直接抛出异常并记录日志，而非尝试处理——这比静默失败更利于问题定位。

3. 客户端完整工作流：从初始化到租约续期的七步执行链

3.1 初始化：设置硬件标识与网络接口绑定

DhcpClient实例化时必须指定真实网卡索引与MAC地址，不能使用00:00:00:00:00:00占位：

// 示例：绑定物理网卡enp0s3 NetworkInterface ni = NetworkInterface.getByName("enp0s3"); if (ni == null) { throw new RuntimeException("Network interface enp0s3 not found"); } byte[] mac = ni.getHardwareAddress(); if (mac == null) { throw new RuntimeException("Failed to get MAC address from enp0s3"); } DhcpClient client = new DhcpClient() .setInterface(ni) // 绑定NetworkInterface，决定bind()的本地地址 .setChaddr(mac) // 设置chaddr，必须与网卡MAC一致 .setClientId("my-iot-device-v1"); // 可选：设置RFC 3315兼容的Client ID

注意：setInterface()不仅用于bind()，还影响getBroadcastAddress()调用结果——它从ni中读取子网掩码计算广播地址，若绑定错误接口，DISCOVER将发往错误网段。

3.2 启动租约流程：手动触发DISCOVER与自动状态迁移

调用start()即启动状态机，无需手动发包：

// 启动租约获取流程 client.start(); // 内部触发INIT → SELECTING状态迁移 // 监听关键事件 client.addStateChangeListener((oldState, newState) -> { System.out.printf("State changed: %s → %s%n", oldState, newState); if (newState == DhcpClientState.BOUND) { DhcpLease lease = client.getCurrentLease(); System.out.printf("Got IP: %s/%d, Gateway: %s, DNS: %s%n", lease.getIpAddress(), lease.getSubnetPrefixLength(), lease.getRouter(), lease.getDnsServers()); } });

start()方法内部执行：

1. 生成随机xid（Transaction ID）
2. 构造DISCOVER报文（op=BOOTREQUEST, htype=1, hlen=6, flags=0x8000表示广播响应）
3. 调用DhcpTransport.send()发送至255.255.255.255:67
4. 启动SELECTING状态定时器（首超时1s）

3.3 处理OFFER：多服务器响应下的优选策略

当网络中存在多个DHCP服务器时，客户端可能收到多个OFFER。本实现采用首个有效OFFER优先策略（符合RFC 2131 Sec 4.4），但提供扩展点：

// 默认策略：接收第一个合法OFFER即发送REQUEST client.setOfferSelectionPolicy(new FirstValidOfferPolicy()); // 可替换为自定义策略：例如按Offer中Option #51（IP地址租期）最长者胜出 client.setOfferSelectionPolicy(new LongestLeaseOfferPolicy());

LongestLeaseOfferPolicy实现中会解析每个OFFER的Option #51（IP Address Lease Time），单位为秒，转换为Duration对象后比较：

public class LongestLeaseOfferPolicy implements OfferSelectionPolicy { @Override public boolean select(DhcpMessage offer) { byte[] leaseOpt = offer.getOption(51); if (leaseOpt == null || leaseOpt.length < 4) return false; long seconds = ByteBuffer.wrap(leaseOpt).getInt() & 0xFFFFFFFFL; return seconds > currentMaxLeaseSeconds; // 更新全局最大值 } }

3.4 REQUEST阶段：正确填充server identifier与requested IP

REQUEST报文的关键在于两个字段必须严格匹配前序OFFER：

• serverIdentifier（Option #54）：必须等于OFFER中siaddr字段或Option #54的值
• requestedIpAddress（Option #50）：必须等于OFFER中yiaddr字段

源码中DhcpClientStateMachine在SELECTING → REQUESTING迁移时自动完成填充：

// DhcpClientStateMachine.java 第312行 private DhcpMessage buildRequestMessage(DhcpMessage offer) { DhcpMessage req = new DhcpMessage(BOOTREQUEST); req.setCiaddr(IPv4Address.ZERO); // 客户端尚未配置IP，置0 req.setYiaddr(IPv4Address.ZERO); // 此字段在REQUEST中不使用 req.setSiaddr(offer.getSiaddr()); // 若OFFER中siaddr非0，则填入 // 必须设置Option #54（Server Identifier） byte[] siaddrBytes = offer.getSiaddr().toByteArray(); if (!IPv4Address.ZERO.equals(offer.getSiaddr())) { req.addOption(54, siaddrBytes); } else { // 否则从OFFER的Option #54提取 byte[] serverId = offer.getOption(54); if (serverId != null) req.addOption(54, serverId); } // 必须设置Option #50（Requested IP Address） req.addOption(50, offer.getYiaddr().toByteArray()); return req; }

若此处填错（如把siaddr误填为giaddr），服务器将返回NAK——这是新手最常翻车的环节。

3.5 ACK确认与租期管理：从二进制Option到Java定时器

收到ACK后，DhcpClient解析Option并构建DhcpLease对象，其中租期转换是关键：

// DhcpLease.java 第68行 public DhcpLease(DhcpMessage ack) { this.ipAddress = ack.getYiaddr(); this.subnetMask = IPv4Address.fromBytes(ack.getOption(1)); this.router = IPv4Address.fromBytes(ack.getOption(3)); // Option #51：IP Address Lease Time，RFC 2132 Sec 3.12 byte[] leaseBytes = ack.getOption(51); if (leaseBytes != null && leaseBytes.length == 4) { int leaseSeconds = ByteBuffer.wrap(leaseBytes).getInt(); this.leaseDuration = Duration.ofSeconds(leaseSeconds); // 转为Java Duration } else { this.leaseDuration = Duration.ofHours(1); // 默认1小时 } // 计算到期时间戳（考虑系统时钟漂移） this.expiryTime = Instant.now().plus(this.leaseDuration); }

租期定时器由LeaseExpiryMonitor维护，它在BOUND状态下启动一个ScheduledExecutorService，在expiryTime.minus(10, SECONDS)时刻触发续租（Renewal），避免到期瞬间断网。

3.6 续租流程（RENEWING）：单播直连服务器 vs 广播兜底

续租分两阶段：

• 第一阶段（RENEWING）：向原DHCP服务器单播发送REQUEST（目标IP=siaddr，端口67）
• 第二阶段（REBINDING）：若单播超时（默认3次重试，间隔1s/2s/4s），则广播发送REQUEST（目标255.255.255.255）

源码中DhcpClientStateMachine根据当前状态自动切换：

// DhcpClientStateMachine.java 第421行 private void sendRenewalRequest() { if (currentLease.getSiaddr() != null && !IPv4Address.ZERO.equals(currentLease.getSiaddr())) { // 尝试单播：直接发给原服务器 transport.send(requestMsg, currentLease.getSiaddr(), (short) 67); } else { // 降级为广播 transport.send(requestMsg, IPv4Address.BROADCAST, (short) 67); } }

提示：若设备所在网络禁用了单播到DHCP服务器的策略（如某些校园网ACL），此逻辑能自动兜底到广播模式，保障续租成功率。

3.7 RELEASE释放租约：主动通知服务器回收IP

调用release()方法发送RELEASE报文，通知服务器立即回收IP：

client.release(); // 发送RELEASE报文，不等待响应 // 内部构造：op=BOOTREQUEST, ciaddr=当前IP, yiaddr=0, siaddr=服务器IP, // Option #54=server id, Option #61=client id（若设置）

RELEASE报文不期望ACK，但发送后客户端应立即将网络接口IP清空（由调用方负责执行ifconfig down或ip addr flush）。源码不操作OS网络栈，保持协议栈与系统解耦。

4. 常见问题与避坑指南：七个真实场景下的翻车现场与修复路径

4.1 现象：DISCOVER发出后无任何OFFER响应，Wireshark显示报文正常发出

原因：DhcpClient绑定的NetworkInterface未启用广播权限，或Linux系统net.ipv4.ip_forward开启导致内核截获UDP广播
解决：

• 检查网卡是否UP：ip link show enp0s3 | grep "state UP"
• 确认广播权限：cat /proc/sys/net/ipv4/ip_forward必须为0
• 在代码中显式设置socket选项：

  DatagramChannel channel = DatagramChannel.open(); channel.setOption(StandardSocketOptions.SO_BROADCAST, true); // 关键！

4.2 现象：收到OFFER但状态卡在SELECTING，日志提示"Invalid DHCP Message Type"

原因：OFFER报文中Option #53值为2（DHCPOFFER），但DhcpOptionParser解析时因字节序错误读取了错误位置
解决：检查DhcpMessage.getOption(53)实现——必须从Option区域（偏移100+）开始扫描TLV，而非从报文头硬编码偏移。本项目中DhcpMessage使用parseOptions()动态定位，若你修改过Option解析逻辑，请回归原始实现。

4.3 现象：REQUEST发出后收到NAK，服务器日志显示"Invalid requested IP"

原因：requestedIpAddress（Option #50）填入了错误IP，常见于从多个OFFER中误取了非首选OFFER的yiaddr
解决：在buildRequestMessage()中增加校验：

if (!Arrays.equals(req.getOption(50), selectedOffer.getYiaddr().toByteArray())) { throw new IllegalStateException("Requested IP does not match selected OFFER's yiaddr"); }

4.4 现象：租约到期后未自动续租，BOUND状态长期维持

原因：LeaseExpiryMonitor的ScheduledExecutorService被意外shutdown，或系统时间被NTP大幅校正导致Instant.now()跳变
解决：

• 使用ScheduledThreadPoolExecutor替代Executors.newScheduledThreadPool()，避免线程泄漏
• 续租触发时间改为leaseStart.plus(leaseDuration.multiply(0.5))（50%租期时续租），降低对绝对时间的依赖

4.5 现象：在Docker容器中运行时，NetworkInterface.getByName("eth0")返回null

原因：容器默认使用--network=bridge，Java无法通过名称获取宿主机网卡
解决：改用NetworkInterface.getByInetAddress()获取容器分配的IP对应接口：

InetAddress containerIp = InetAddress.getByName("172.17.0.3"); NetworkInterface ni = NetworkInterface.getByInetAddress(containerIp);

4.6 现象：解析Option #125（Vendor-Specific Information）时抛出ArrayIndexOutOfBoundsException

原因：Option #125格式为嵌套TLV，外层Option长度字段（length）包含内层所有Option总长，但原始解析器未递归处理
解决：启用DhcpOptionParser的嵌套解析开关：

DhcpOptionParser parser = new DhcpOptionParser(); parser.enableNestedOptionParsing(true); // 允许解析Option #125内嵌Option

4.7 现象：DhcpServerSimulator启动失败，提示"Address already in use: bind"

原因：67端口被系统dhclient或dnsmasq占用
解决：

• Linux下查看占用：sudo lsof -i :67
• 临时停用系统服务：sudo systemctl stop systemd-networkd
• 或修改模拟器端口（仅限测试）：simulator.bindToPort(1067)

5. 进阶技巧：用DhcpServerSimulator构建离线验证闭环与Option 82注入测试

5.1 构建零依赖本地测试闭环：三步启动可验证的DHCP交互

DhcpServerSimulator是本项目最具生产力的隐藏模块。它不依赖外部DHCP服务器，让你在无网络环境下完成端到端验证。启动步骤如下：

// Step 1: 配置IP池与租期 DhcpServerConfig config = new DhcpServerConfig(); config.setSubnet("192.168.100.0"); config.setSubnetMask("255.255.255.0"); config.setPoolStart("192.168.100.100"); config.setPoolEnd("192.168.100.200"); config.setDefaultLeaseTime(3600); // 1小时 config.setMaxLeaseTime(7200); // Step 2: 注册静态绑定（可选，用于测试特定MAC） config.addStaticBinding("00:11:22:33:44:55", "192.168.100.50"); // Step 3: 启动模拟器（监听0.0.0.0:67） DhcpServerSimulator simulator = new DhcpServerSimulator(config); simulator.start(); // 阻塞式启动，内部使用Selector轮询 // 启动客户端（同一JVM内） DhcpClient client = new DhcpClient() .setInterface(NetworkInterface.getByInetAddress(InetAddress.getByName("127.0.0.1"))) .setChaddr(new byte[]{0x00, 0x11, 0x22, 0x33, 0x44, 0x55}); client.start();

此时Wireshark过滤udp.port == 67即可看到完整的DISCOVER–OFFER–REQUEST–ACK四次握手，且client.getCurrentLease().getIpAddress()返回192.168.100.50（因静态绑定生效）。

5.2 测试Option 82（Circuit ID / Remote ID）：验证中继代理兼容性

企业网络常通过DHCP Relay Agent（如交换机）转发请求，Relay会插入Option 82（RFC 3046）。本模拟器支持注入Option 82供客户端解析测试：

// 在DhcpServerConfig中启用Option 82注入 config.setEnableOption82(true); config.setCircuitId("switch-01:port-24"); config.setRemoteId("relay-agent-001"); // 启动后，客户端收到的OFFER中将包含： // Option 82: 0x01 0x0F 0x73 0x77 0x69 0x74 0x63 0x68 0x2D 0x30 0x31 0x3A 0x70 0x6F 0x72 0x74 0x2D 0x32 0x34 // [subopt][len] [circuit-id string]

客户端可通过client.getCurrentLease().getOption82()获取解析后的Option82对象，验证其getCircuitId()与getRemoteId()值。这是检验你的DHCP客户端是否具备运营商级网络兼容能力的关键测试点。

5.3 自定义Option处理器：解析私有Option（如设备序列号上报）

当DHCP服务器需下发设备管理指令（如OTA升级URL、证书CA链），常使用私有Option（如#224）。本项目提供OptionHandler扩展机制：

// 定义私有Option 224解析器 public class DeviceCommandOptionHandler implements OptionHandler { @Override public void handle(DhcpMessage msg, byte[] data) { try { String command = new String(data, StandardCharsets.UTF_8); System.out.println("Received device command: " + command); if ("reboot".equals(command.trim())) { Runtime.getRuntime().exec("reboot"); } } catch (Exception e) { e.printStackTrace(); } } } // 注册到解析器 DhcpOptionParser parser = new DhcpOptionParser(); parser.registerOptionHandler(224, new DeviceCommandOptionHandler()); client.setOptionParser(parser);

只要服务器在ACK中加入option 224 "reboot"，客户端即可执行重启——这种轻量级指令通道比HTTP轮询更节省资源。

5.4 抓包验证黄金组合：Wireshark显示过滤与tshark命令行自动化

为快速验证协议行为，推荐以下Wireshark显示过滤器（Display Filter）：

命令行自动化（保存为dhcp-test.sh）：

#!/bin/bash # 启动抓包，捕获DHCP交互，超时30秒后停止 sudo tshark -i enp0s3 -f "udp port 67 or udp port 68" \ -Y "bootp" -T fields -e frame.time -e bootp.type -e bootp.xid \ -E header=y -E separator=, -w dhcp.pcap & TSHARK_PID=$! # 启动客户端 java -jar dhcp-client.jar # 30秒后停止抓包 sleep 30 sudo kill $TSHARK_PID echo "DHCP capture saved to dhcp.pcap"

5.5 生产环境加固：禁用危险Option与日志脱敏

在IoT设备固件中，需防范恶意DHCP服务器下发危险Option（如#121 Classless Static Routes，可劫持路由表）。本项目支持白名单模式：

// 仅允许解析安全Option DhcpOptionParser parser = new DhcpOptionParser(); parser.setAllowedOptions( 1, 3, 6, 15, 28, 51, 53, 54, 58, 59, 61 // subnet, router, dns, domain, broadcast, lease, msg-type, server-id, renew, rebnd, client-id ); client.setOptionParser(parser);

同时，日志输出自动脱敏MAC地址与IP：

// DhcpMessage.toString() 中 public String toString() { return String.format("DhcpMessage{op=%s, xid=0x%08X, chaddr=%s, ...}", op, xid, Arrays.toString(Arrays.copyOf(chaddr, 3)) + "-XX-XX-XX"); // 仅显示前3字节 }

从那以后我每次在嵌入式设备上集成DHCP功能，都强制走一遍DhcpServerSimulator本地闭环测试，再用tshark抓包比对RFC原文字段——哪怕只是改了一个字节的padding，也要确保它在真实交换机、光猫、企业AC下都能活下来。协议栈不是越厚越好，而是越经得起tcpdump -i any port 67的凝视，越值得放进固件。希望帮到你。

本文还有配套的精品资源，点击获取