Files
MeshPort/docs/p2p-investigation.md
T

5.6 KiB
Raw Blame History

P2P 差异调查(2026-10-09)

已观察到的证据

读取运行中的 MeshPort 界面:DIG-US 有直接链路,其余目标显示中继/路由估算。原版日志只有加载、启动、停止八条界面操作事件,没有原生连接事件,也没有 UDP 打洞失败细节。

用户提供的 EasyTier GUI 日志:两条初始 TCP 连接先超时、后成功;随后到节点 3157594741 建立 UDP 连接。它证明 GUI 建立了 UDP 隧道;是否由打洞建立,需要确认该地址不是手动配置的初始节点。新增连接时 latency_us 为零、包数为一,属于初始统计,不能当成打洞失败或零延迟。

代码对比

  • UDP 穿透由上游 CoreUdpHolePunchService 创建并在原生实例启动时启动;不依赖 TUN,也不是因为本项目关掉默认 Cargo feature 就整体消失。TCP 穿透 feature 明确编译开启。
  • MeshPort 普通 listeners 为空;上游 GUI 默认包含 TCP/UDP 11010。空监听影响普通主动直连/同局域网连接,不能直接推断 UDP 打洞被禁用;UDP 打洞服务会另建自己的监听。
  • MeshPort 明确禁用 UPnP 且不编译其映射适配器;GUI 默认未禁用。这可能影响某些 NAT 的成功率,但目前没有证据证明 GUI 的成功链路使用了 UPnP。当前保留此限制,避免默认改变用户路由器端口映射。
  • MeshPort 使用固定的 2.7.0 开发版上游提交;已从本机 /Applications/easytier-gui.app/Contents/Info.plist 确认 GUI 为 2.4.5;服务器实际版本未知。比较两版官方源码,UdpHolePunchRpc 的方法名和顺序仍一致,不能仅凭版本不同认定信令不兼容。
  • MeshPort macOS Debug 包已有 network.client/server;Release 只有 client。本次补齐 Release 的 server entitlement。用户正在运行 Debug 包,所以此修复不能作为当前故障根因。
  • 首版使用 latency_first=true,GUI 上游默认 false。选择路由和建立直连是不同问题;即使存在直连,延迟策略也可能选择另一条路径。

参考官方配置:https://easytier.rs/guide/network/configurations.html 参考官方 P2P 文档:https://easytier.rs/guide/network/p2p-optimize

本次改动

状态增加 UDP/TCP NAT 类型、STUN 更新时间、显式 STUN 配置、实际 TCP/UDP 普通监听地址、有效 P2P 开关和连接协议。STUN 配置 null 表示采用上游默认,空数组表示明确不给探测服务器;NAT Unknown 本身不区分尚未探测、探测失败或禁用。

在实例启动之前订阅原生事件,保留最多 100 条连接/监听事件,带 sequence;Flutter 刷新时去重写入日志。网络密钥从错误文本中脱敏。此事件流不是完整 tracing:UDP 打洞算法的内部重试/失败原因可能仍需额外 tracing 采集。复制网络诊断不含配置中的密钥,但包含节点名称、IP 等网络信息。

尚未确认

尚未取得故障发生时 MeshPort 的 NAT 结果及原生穿透内部错误,没有在用户真实网络复现并证明修复成功。本机双节点测试只证明网络模块与新增诊断工作,不证明跨 NAT 打洞。

下一轮按相同网络、初始节点和目标对比:先确认 NAT 是否完成检测、有效 P2P 禁用开关、到 3157594741 的 UDP 连接是否出现;再验证 GUI 使用的版本、STUN 和 UPnP。保持两个客户端分别运行,避免同时运行造成端口或路由干扰。

第二轮诊断

用户提供的状态:本地 UDP NAT 为 Symmetric,STUN 已更新,UDP/TCP/对称 NAT 打洞禁用开关均为 false。仅有到两个服务器的 TCP 连接;Redmi_AX6(3157594741)不存在直接连接。此前的约 2 秒 handshake timeout 是原生连接事件,未记录目的节点,不能据此认定是 UDP 打洞超时。

当前核心对 hard-symmetric → cone 有尝试路径,hard-symmetric → symmetric 不作为 UDP 客户端尝试。需要结合对端 NAT 分类判断是否触发;因此状态新增对端 NAT、版本和 P2P 通告开关。

还发现诊断把 latency_first 所选 next-hop 和普通模式 cost 混用了;已修正 cost 使用同一策略。UI 根据所选 next-hop 区分“当前直连”和“中继但有直连可用”,避免把已经存在的 TCP 直连误当成当前路由。

Lab 在创建网络前显式调用 diagnostics_enable,开启穿透模块 DEBUG 级详细 tracing,进程内保留最多 200 条、单条最多 4 KiB。用于观察 RPC 失败、端口预测、发包后等待超时。该操作不替换宿主已存在的 subscriber,默认 SDK 不自动启用;详细日志包含节点/网络地址信息。仍没有在真实故障网络确认根因或证明修复成功。

第三轮:确认 Redmi_AX6 已打洞成功,修正显示错误

最新诊断出现“连接建立 节点 3157594741 协议 udp”,RTT 7.497 ms,路由 cost=1,next_hop_peer_id 等于目标自身。因此 Redmi_AX6 当前有 UDP 物理直连;此前认为它始终打洞失败的判断不适用于本次状态。其他目标的失败日志不能代替它的当前状态。

根因是 MeshPort 错用了上游 directly_connected_conns:easytier-core/src/peers/conn/peer.rs 的 get_directly_connections 会明确 filter 掉 is_hole_punched() 的连接。空列表并非没有物理直连。

修正 peers.direct 判断为本地 peer-map 有默认连接且存在存活 TCP/UDP 隧道,排除只有 foreign logical 连接的节点。新增 hole_punched 字段,展示“直连 · 打洞建立”;是否当前走直连继续核对路由下一跳,显示 7.5 ms 实测 RTT。加入 Rust 回归测试覆盖打洞、关闭和 foreign 状态;Flutter 覆盖本次 Redmi_AX6 的路由与显示。