sing-box项目中Teredo隧道适配器对IPv6连接的影响分析

问题背景

在Windows平台上使用sing-box的TUN模式时，部分用户遇到了一个特殊的IPv6连接问题。当配置文件中inbound为TUN且outbound为direct时，IPv6连接会在运行10-15秒后出现异常，表现为远程IPv6网站访问失败，而本地IPv6网络测试正常。

现象描述

用户报告的具体现象包括：

1. 初始阶段：sing-box启动后，IPv6连接完全正常，可以成功访问远程IPv6网站
2. 异常阶段：运行约10-15秒后，IPv6连接开始失败，出现"Connection was reset"错误
3. 本地测试：局域网IPv6 HTTP访问和iperf3测试均正常，问题仅出现在远程IPv6连接

问题定位

经过深入排查，发现问题与Windows系统中的Teredo隧道适配器有关：

1. 在正常状态下，ipconfig命令会显示"隧道适配器 Teredo Tunneling Pseudo-Interface"
2. sing-box启动后，该适配器会暂时消失，此时IPv6连接正常
3. 约10多秒后，Teredo适配器重新出现，IPv6连接随即失败

技术分析

Teredo是微软实现的一种IPv6过渡技术，它允许IPv6/IPv4主机通过IPv4网络访问IPv6资源。当sing-box的TUN模式运行时，可能会与Teredo适配器产生以下交互：

1. 网络栈接管：sing-box的TUN模式接管了系统的网络栈，暂时抑制了Teredo适配器
2. 适配器恢复：Windows系统检测到Teredo服务异常，尝试重新启动该适配器
3. 路由冲突：恢复的Teredo适配器与sing-box的TUN模式产生路由冲突，导致IPv6连接异常

解决方案

对于遇到此问题的用户，可以采取以下解决方案：

1. 临时方案：在需要使用sing-box时，手动禁用Teredo服务

   netsh interface teredo set state disabled
   

2. 永久方案：对于不需要Teredo服务的用户，可以彻底禁用该功能
   • 通过"控制面板-程序和功能-启用或关闭Windows功能"禁用Teredo
   • 或在组策略中禁用相关设置

总结

这个案例展示了Windows特定网络功能与网络工具之间可能产生的兼容性问题。对于网络工具开发者而言，需要特别关注Windows平台特有的网络组件和服务的交互行为。对于终端用户，了解系统底层网络组件的工作原理有助于快速定位和解决类似问题。

在sing-box的实际部署中，建议用户检查系统是否存在类似的隧道适配器，并根据实际需求合理配置系统网络功能，以确保网络工具的正常运行。