AdGuardHome IPv6 SLAAC配置问题分析与解决方案

问题背景

在AdGuardHome v0.107.55版本中，用户报告了一个关于IPv6 SLAAC(无状态地址自动配置)功能失效的问题。当用户启用DHCP服务器并设置ra_allow_slaac选项为true时，设备无法通过路由器通告(RA)正确配置IPv6地址，而是退回到使用链路本地地址。

技术分析

IPv6 SLAAC是IPv6网络中设备自动配置地址的重要机制，它依赖于ICMPv6路由器通告报文。路由器通告报文包含多个选项字段，其中源链路层地址选项(Source Link-Layer Address Option)是关键部分。

通过tcpdump抓包分析发现，AdGuardHome发送的ICMPv6报文存在格式错误。具体表现为源链路层地址选项的长度字段被硬编码为1，而实际上应该根据接口的MAC地址长度动态计算。这个错误导致设备无法正确解析路由器通告报文，从而无法完成自动地址配置。

根本原因

该问题可追溯到代码提交bfc7e16，其中源链路层地址选项的长度计算存在缺陷。在routeradv.go文件中，长度字段被固定设置为1，而实际上应该根据网络接口的硬件地址长度动态确定。

正确的实现应该参考radvd项目的做法，根据接口类型计算适当的长度值。例如，对于以太网接口，MAC地址长度为6字节，因此选项长度应为8字节(1字节类型+1字节长度+6字节地址)。

解决方案

修复方案包括两个主要部分：

1. 动态计算源链路层地址选项长度：

   • 获取网络接口的硬件地址长度
   • 根据地址长度计算选项总长度
   • 正确填充ICMPv6报文中的长度字段

2. 修正代码注释与实际实现的差异：

   • 更新注释以准确反映实际实现
   • 确保文档与代码行为一致

影响评估

该问题影响所有使用AdGuardHome DHCPv6 SLAAC功能的用户，特别是在IPv6网络环境中。修复后将恢复正常的IPv6地址自动配置功能，使设备能够通过路由器通告正确获取IPv6地址。

技术细节补充

IPv6 SLAAC工作流程：

1. 设备发送路由器请求(RS)
2. 路由器响应路由器通告(RA)
3. 设备根据RA中的前缀信息自动生成IPv6地址
4. 设备通过重复地址检测(DAD)确认地址唯一性

源链路层地址选项结构：

• 类型(1字节)：通常为1
• 长度(1字节)：以8字节为单位的选项总长度
• 链路层地址(可变长度)：发送者的MAC地址

结论

AdGuardHome中的IPv6 SLAAC功能由于ICMPv6报文格式错误而失效。通过动态计算源链路层地址选项长度并修正相关代码，可以恢复该功能的正常工作。这一修复对于依赖IPv6自动地址配置的网络环境尤为重要。