AdGuardHome客户端排行中IPv6设备显示异常问题分析

问题现象

在AdGuardHome v0.108.0-b51版本中，用户发现客户端排行列表中的IPv6设备地址会自动附加"%br-lan"标识。这个现象在之前的v0.108.0-b50版本中并不存在。

具体表现为：

1. 客户端排行列表中IPv6地址显示为类似"fe80::xxxx:xxxx:xxxx:xxxx%br-lan"的格式
2. 点击这些带有%br-lan标识的客户端时，无法正常查看该客户端的日志记录
3. 需要手动删除%br-lan后缀才能正常查看日志

技术背景

这个问题的出现与IPv6地址的"区域索引"(zone index)有关。在IPv6网络中，当一个主机有多个网络接口时，相同的IPv6地址可能出现在不同的网络接口上。为了区分这些地址，IPv6引入了区域索引的概念：

• 区域索引通常以百分号(%)开头，后面跟着接口名称或索引号
• 例如"fe80::1%eth0"表示在eth0接口上的链路本地地址fe80::1
• 在Linux系统中，常见的接口名称包括eth0、wlan0、br-lan等

问题原因

经过分析，这个问题是由于AdGuardHome在v0.108.0-b51版本中对IPv6地址处理逻辑的变更导致的：

1. 新版本开始保留IPv6地址中的区域索引信息
2. 但在客户端排行和日志查询的交互逻辑中没有做相应的适配
3. 导致带有区域索引的IPv6地址无法被正确识别和查询

解决方案

AdGuardHome开发团队已经确认这个问题，并在即将发布的v0.108.0-b52版本中修复了此问题。修复内容包括：

1. 正确处理IPv6地址的区域索引
2. 确保带有区域索引的IPv6地址能够被正确查询
3. 保持客户端排行和日志查询功能的一致性

临时解决方法

对于需要使用v0.108.0-b51版本的用户，可以采取以下临时解决方案：

1. 手动删除IPv6地址中的"%br-lan"后缀后再进行查询
2. 或者回退到v0.108.0-b50版本

总结

这个案例展示了在软件开发过程中，即使是看似简单的变更也可能引入意想不到的问题。AdGuardHome团队对IPv6地址处理的改进初衷是好的，但在实现过程中遗漏了对相关功能的全面测试。这也提醒我们，在网络相关的软件开发中，需要特别注意IPv6的各种特殊情况和边界条件。