AdGuardHome在ESXi虚拟机中的UDP校验和问题分析与解决

在虚拟化环境中运行AdGuardHome时，用户可能会遇到UDP校验和异常的问题。本文将详细分析这一现象的原因，并提供有效的解决方案。

问题现象

当AdGuardHome在ESXi虚拟机上运行时，使用HTTP/3(基于QUIC)协议与上游DNS服务器(如8.8.8.8)通信时，tcpdump抓包显示大量"bad udp cksum"警告信息。尽管DNS查询看似正常工作，但这些校验和错误可能暗示着潜在的网络性能问题。

典型错误示例：

12:51:08.337629 IP 10.20.0.15.63821 > 8.8.8.8.443: [bad udp cksum 0x1b11 -> 0xec0c!] UDP, length 197

根本原因分析

通过ethtool检查发现，ESXi虚拟机的网络接口默认启用了多项硬件加速功能，包括：

• 接收/发送校验和卸载(rx/tx-checksumming)
• 分段卸载(tso/gso)
• 大型接收卸载(lro/gro)

这些功能在物理机上能提升性能，但在虚拟化环境中可能导致UDP校验和计算异常。特别是QUIC协议对UDP数据包有严格要求，任何校验和错误都可能影响连接稳定性。

解决方案

通过ethtool禁用相关网络加速功能可解决此问题：

/sbin/ethtool -K 网卡名 \
    rx off tx off \
    tso off gso off \
    sg off gro off \
    rxvlan off txvlan off \
    rxhash off \
    tx-checksum-ipv6 off \
    tx-checksum-ipv4 off

应用此配置后，tcpdump显示UDP校验和恢复正常：

12:53:45.006803 IP 10.20.0.15.63821 > 8.8.8.8.443: [udp sum ok] UDP, length 33

技术背景

1. QUIC与HTTP/3：作为新一代传输协议，QUIC基于UDP实现，相比TCP具有更快的连接建立速度和更好的多路复用能力。

2. 虚拟化网络特性：ESXi的vmxnet3虚拟网卡提供了多种硬件加速功能，但在特定场景下可能与上层协议不兼容。

3. 校验和卸载：网络接口卡(NIC)的校验和卸载功能将校验和计算从CPU转移到网卡，可能在某些虚拟化配置中产生不一致。

最佳实践建议

1. 在虚拟化环境中运行AdGuardHome时，建议全面检查网络接口的加速功能设置。

2. 对于QUIC/HTTP3连接，可尝试设置环境变量QUIC_GO_DISABLE_ECN=true作为替代解决方案。

3. 定期监控网络性能，在确保稳定性的前提下，可以尝试逐步重新启用某些加速功能以优化性能。