OpenWrt DHCP option 121 配置后没网:静态路由与断网排查
简答:OpenWrt DHCP option 121 应同时写目标网段和 0.0.0.0/0 默认路由,再用 UCI 或 LuCI 下发;
定义:DHCP option 121 是 DHCPv4 的无类别静态路由选项,用于把带前缀长度的目标网段和下一跳自动安装到支持该选项的客户端。
先照抄配置,再判断是哪一层出错

假设主路由和 DHCP 服务器地址为 192.168.1.1,旁路由地址为 192.168.1.2,需要把 192.168.50.0/24 交给旁路由。首次测试建议只选择一台电脑,避免配置错误影响全网设备。
| 检查层 | 判断条件 | 下一步 |
|---|---|---|
| DHCP ACK | 抓包中有 option 121,必要时还有 249 | 继续查看客户端路由表 |
| 客户端路由 | 192.168.50.0/24 指向 192.168.1.2 | 测试下一跳和目标网段 |
| 默认路由 | default 仍指向 192.168.1.1 | 若缺失,补充 0.0.0.0/0,192.168.1.1 |
| 旁路由转发 | 旁路由能收到请求并转发到目标接口 | 检查 IP 转发、防火墙和回程路由 |
| 连接状态 | 去程和回程经过的设备、接口与状态一致 | 排查非对称路径、INVALID 和反向路径过滤 |
RFC 3442 将 option 121 定义为每条路由携带前缀长度的 DHCPv4 选项;支持该选项的客户端在收到它时不能继续采用 option 33,并且服务器应在 option 121 中同时提供默认路由。可核对 RFC 3442 无类别静态路由选项。
因此,LuCI 的 DHCP-Options 可先填写:
121,192.168.50.0/24,192.168.1.2,0.0.0.0/0,192.168.1.1
不要只写 121,192.168.50.0/24,192.168.1.2。否则严格实现 RFC 3442 的客户端可能忽略 option 3 中的默认网关。OpenWrt 项目已有相关问题记录,但不同客户端和版本表现可能不同,必须以实际路由表为准。
LuCI 与 UCI 配置 OpenWrt DHCP option 121
LuCI 网页配置
- 进入
Network > Interfaces,编辑实际提供 DHCP 服务的 LAN 接口。 - 打开
DHCP Server > Advanced Settings。 - 在
DHCP-Options中新增121,192.168.50.0/24,192.168.1.2,0.0.0.0/0,192.168.1.1。 - 保存并应用,只让一台测试设备断开后重新连接或重新获取 DHCP 租约。
OpenWrt 项目问题记录中的 LuCI 示例也使用 DHCP Server > Advanced Settings > DHCP-Options 填写 option 121;该记录同时说明,缺少默认路由的现象与客户端实现和具体路由条目有关,可查看 OpenWrt option 121 默认网关问题记录。
SSH 中使用 UCI
下面命令在 OpenWrt SSH 中执行。先备份并查看现有配置,避免重复追加:
cp /etc/config/dhcp /etc/config/dhcp.bak-121
uci show dhcp.lan | grep dhcp_option
确认没有相同内容后,再追加:
uci add_list dhcp.lan.dhcp_option='121,192.168.50.0/24,192.168.1.2,0.0.0.0/0,192.168.1.1'
uci commit dhcp
/etc/init.d/dnsmasq restart
uci show dhcp.lan | grep dhcp_option
若命令输出中已经存在完全相同的字符串,不要再次执行 uci add_list。重启失败时查看:
logread -e dnsmasq
dhcp_option 是 dnsmasq DHCP 选项列表的 UCI 映射,实际语法仍由 dnsmasq 处理。可对照 dnsmasq 官方手册中的 dhcp-option 说明。
option 249 要不要和 option 121 一起发
| 选项 | 作用 | 配置建议 | 验证方式 |
|---|---|---|---|
| 121 | 无类别静态路由,每条路由包含前缀长度 | 作为主要配置,并加入默认路由 | 检查客户端 IPv4 路由表 |
| 249 | 部分 Windows 环境使用的类无类别静态路由选项 | 只有在目标 Windows 设备实测需要时再补充 | 用 route print 确认是否安装 |
| 33 | 传统静态路由,不能表达任意 CIDR 前缀 | 不作为 option 121 的替代品 | 确认客户端是否支持旧式路由 |
可以在测试阶段同时加入:
249,192.168.50.0/24,192.168.1.2
但 option 249 是否生效取决于实际客户端和系统版本,不能把它当成所有 Windows 设备的通用兼容方案。若同时配置 121 和 249,仍应分别检查 Windows、Linux、macOS 的路由表,不要只看 DHCP 页面是否保存成功。
只给指定设备下发 option 121
如果只有 NAS、办公电脑或实验室主机需要访问异地网段,不建议把 option 121 发送给整个 LAN。dnsmasq 的 dhcp-host 可以通过 set:<tag> 给匹配的主机设置标签,再用 tag:<tag> 选择性发送 DHCP 选项;相关规则见 dnsmasq 官方手册的 tag 与 dhcp-option 说明。
在 /etc/config/dhcp 中可使用类似配置:
config host
option name 'office-pc'
option mac 'AA:BB:CC:DD:EE:FF'
option ip '192.168.1.50'
option tag 'route121'
config dhcp 'lan'
list dhcp_option 'tag:route121,121,192.168.50.0/24,192.168.1.2,0.0.0.0/0,192.168.1.1'
修改前先检查现有 host 和 DHCP 区段,避免把内容追加到错误的接口:
uci show dhcp | grep -E 'dhcp_option|config host|route121|office-pc'
无线设备启用私有地址后,匹配用的 MAC 可能变化;如果设备未获得固定租约或 tag 未命中,先检查 DHCP 租约文件和客户端当前 MAC,再判断 option 121 语法。
DHCP ACK 抓包:确认 option 121 真的发出去了
客户端路由表没有变化时,先确认 DHCP ACK 是否携带 option 121,而不是继续修改路由格式。OpenWrt 官方文档提供了使用 tcpdump 抓包并保存 pcap 文件的方法,见 OpenWrt tcpdump 与 Wireshark 抓包说明。
在 OpenWrt SSH 中,先确认 LAN 桥接口名称,再抓 DHCP 流量:
ip -br link
tcpdump -ni br-lan -vvv -s0 -w /tmp/dhcp-option121.pcap 'udp port 67 or udp port 68'
让测试客户端断开并重新连接,或执行系统提供的 DHCP 续租操作。完成后按 Ctrl+C 停止抓包,并在 Wireshark 中打开文件,使用显示过滤器:
dhcp.option.dhcp == 121 || dhcp.option.dhcp == 249
在 DHCP ACK 的选项列表中确认:option 121 的值包含目标网段和默认路由;如果配置了兼容项,还应看到 option 249。若抓包没有 121,检查 DHCP 服务区段、UCI 输出和 dnsmasq 日志;若抓包有 121 但客户端路由表没有目标路由,问题转到客户端兼容性或客户端 DHCP 处理。
抓包文件可能包含局域网地址和主机名,排查结束后可删除:
rm -f /tmp/dhcp-option121.pcap
Windows、Linux、macOS 如何验证生效
Windows
在 PowerShell 或命令提示符中执行:
ipconfig /release
ipconfig /renew
route print
确认 IPv4 路由表中有 192.168.50.0,下一跳为 192.168.1.2,默认路由仍指向 192.168.1.1。如果只配置了 option 249,必须以 Windows 实际出现的路由为准。
Linux
在 Linux 终端中重新连接网络后执行:
ip route
ip route get 192.168.50.10
预期能看到类似 192.168.50.0/24 via 192.168.1.2。如果默认路由消失,优先补齐 option 121 中的 0.0.0.0/0,192.168.1.1,再重新获取租约。
macOS
在终端执行:
networksetup -listallhardwareports
netstat -rn
根据实际硬件端口确认接口名称;检查目标网段和默认路由是否同时存在。不要直接假定无线接口一定是 en0。
配置后断网:回滚、非对称路由与防火墙排查
安全回滚,不要直接删除整个 dhcp_option 列表
uci delete dhcp.lan.dhcp_option 会删除该区段的全部同名选项,可能误删原有 DNS、网关或其他 DHCP 配置,不适合作为通用回滚。
优先使用配置备份恢复:
cp /etc/config/dhcp.bak-121 /etc/config/dhcp
uci commit dhcp
/etc/init.d/dnsmasq restart
如果只是本次尚未提交的修改,可使用:
uci revert dhcp
/etc/init.d/dnsmasq restart
如果已经提交且需要精确删除,应先查看索引:
uci show dhcp.lan | grep dhcp_option
输出可能类似 dhcp.lan.dhcp_option='...'、dhcp.lan.dhcp_option='...';按实际编号使用 uci delete dhcp.lan.dhcp_option[编号],删除后再次执行 uci show dhcp.lan | grep dhcp_option 核对,再提交并重启 dnsmasq。不同 UCI 输出中的索引以设备实际显示为准,不要盲删。
路由表正确但访问仍失败
option 121 只负责把路由交给客户端,不会自动开启旁路由的 IP 转发,也不会替代防火墙、NAT 或回程路由。Linux 内核文档说明,ip_forward 控制接口间转发;严格的 rp_filter 会在入接口不是最佳反向路径时丢弃数据包,复杂或非对称路由需要单独核对该行为,见 Linux 内核 IP Sysctl 文档。
典型的非对称路径是:客户端经 option 121 把请求送到旁路由,但目标网段返回流量却经主路由返回。状态防火墙可能看不到预期的双向连接,回包会被判为 INVALID 或被反向路径检查丢弃,表现为 TCP 三次握手卡住、连接建立后断流或只有单向访问。不要先关闭所有防火墙;应先在两条路径上分别抓包,确认请求和响应是否经过同一组网关,并查看防火墙日志中的 INVALID、DROP 和转发计数。
旁路由上可按顺序检查:
sysctl net.ipv4.ip_forward是否为1。- 防火墙是否允许 LAN 到目标接口的转发。
- 目标网段是否有返回客户端网段的路由。
- 主路由、旁路由和目标设备是否形成一致的去程与回程路径。
- 使用
tcpdump在 LAN 和目标接口同时观察 SYN、SYN-ACK 及后续数据包。
最后核对:2026年10月26日
- 只在实际提供 DHCP 的 LAN 区段配置 option 121。
- 目标网段使用 CIDR 前缀,例如
192.168.50.0/24。 - 下一跳必须是客户端所在二层网络可达的地址。
- option 121 中加入
0.0.0.0/0,主路由IP,避免支持该选项的客户端没有默认路由。 - option 249 只作为按实际客户端验证后的兼容补充。
- 重复执行
uci add_list前先用uci show检查,避免重复下发。 - 先抓 DHCP ACK,再看客户端路由表,最后检查旁路由转发、防火墙和回程路径。
- 回滚优先使用备份或按索引删除,不要直接清空整个
dhcp_option列表。
本文是路由配置网基于公开标准、dnsmasq 手册和 OpenWrt 项目资料整理的技术说明;不同客户端是否支持 option 121,必须以 DHCP 抓包和本机路由表为准。
常见问题
OpenWrt DHCP option 121 为什么会导致客户端断网?
因为支持 RFC 3442 的客户端收到 option 121 后可能忽略 option 3 中的默认网关。如果 option 121 没有包含 <code>0.0.0.0/0,主路由IP</code>,路由表可能只剩目标路由而没有默认路由。先抓 DHCP ACK,再补齐默认路由并重新获取租约。
OpenWrt DHCP option 121 和 option 249 要不要一起配置?
不应把两者同时配置理解为通用兼容方案。option 121 作为主要配置,option 249 只在目标 Windows 设备实测需要时补充;最终以 <code>route print</code> 是否出现目标路由为准。
UCI 多次 add_list 后重复下发怎么办?
先执行 <code>uci show dhcp.lan | grep dhcp_option</code>,确认是否已有完全相同的字符串。已提交的配置应按实际索引删除,或恢复事先备份;不要直接使用 <code>uci delete dhcp.lan.dhcp_option</code> 清空整个列表。
DHCP ACK 怎么确认包含 option 121?
在 OpenWrt 上执行 <code>tcpdump -ni br-lan -vvv -s0 -w /tmp/dhcp-option121.pcap 'udp port 67 or udp port 68'</code>,让客户端重新获取租约,再在 Wireshark 中使用 <code>dhcp.option.dhcp == 121 || dhcp.option.dhcp == 249</code> 过滤。
客户端路由表正确,但跨网段仍然连接不上怎么办?
继续检查旁路由的 <code>ip_forward</code>、防火墙转发、目标网段回程路由和非对称路径。若请求经旁路由出去、响应经另一网关返回,状态防火墙或严格反向路径检查可能丢弃回包,应通过两侧接口抓包确认去程和回程。
Android 或其他设备没有安装 option 121,是 OpenWrt 配错了吗?
不能直接这样判断。DHCP 客户端可以忽略不支持的选项,因此应先用电脑确认 DHCP ACK 是否含 121,再查看该设备自身是否有目标路由。若设备不支持,就不能仅靠 DHCP option 121 让它自动获得该路由。
相关阅读
参考资料
- RFC 3442:DHCPv4 无类别静态路由选项
- dnsmasq 官方手册:dhcp-option、dhcp-host 与 tag 规则(thekelleys.org.uk)
- OpenWrt option 121 默认网关与链路路由问题记录
- OpenWrt 官方文档:tcpdump 与 Wireshark 抓包(openwrt.org)
- Linux 内核文档:ip_forward 与 rp_filter