Files
MeshPort/docs/optimization.md
shenandshen b656c1896a fix: improve SDK UDP throughput and transport selection
Yield during UDP receive bursts to let session consumers drain bounded queues. Prioritize measured RTT over protocol preference and enlarge user-space subnet TCP buffers with validated limits.

Add packet-level throughput diagnostics, transport selection coverage, and investigation records. SDK regression suite: 21 tests passed; local delay and throughput experiments documented.
2026-10-15 23:53:10 -07:00

4.8 KiB
Raw Permalink Blame History

跨国线路优化:第一轮

MeshPort 使用本地定制的 EasyTier 核心,保持现有网络协议。修改位于 vendor/easytier,不要求现有服务端同步修改。混合版本、公网链路仍需实测。

线路策略

Flutter「设置 → 连接」默认选自适应。引擎只影响通过 MeshPort SDK 发起的通信,不创建 TUN 或改变系统路由。

[optimization]
mode = "adaptive"
min_improvement_ms = 15.0
min_improvement_ratio = 0.15
hold_seconds = 10
cooldown_seconds = 30
prefer_udp = true
relay_peer_ids = []
  • adaptive:存在可用直连时,候选中继估算至少改善 15 ms 且 15%,持续 10 秒才切换;切换后冷却 30 秒。路径失效优先恢复可用路径。
  • direct:有直连便使用,否则接受上游中继候选。
  • latency:接受上游延迟优先候选,候选不可用时回退直连。
  • hop:有直连便使用,否则按上游最少跳数候选选择。

没有 optimization 时,保留原 flags.latency_first 的含义:true 使用 adaptive,false/缺省使用 hop。显式 mode 优先决定该 flag。阈值范围:毫秒 0–1000、比例 0–0.9、持续时间 0–300 秒、冷却 0–600 秒。

同一节点已建立的连接先按确认状态、再按实测 RTT 选择;UDP 偏好仅用于 RTT 相同时的选择,不会为了 UDP 放弃延迟更低的 TCP。尚未首次 ping 确认的打洞连接不会抢占已确认连接。连接选择最多每 5 秒刷新;路由选择缓存 2 秒,通过流量或状态采样驱动阈值评估。策略不会凭空建立配置中没有的备用通道,也不保证最低 RTT 的连接具有最高吞吐。

relay_peer_ids 最多 64 项,约束本机普通 peer-map 中上游候选的第一跳,空列表不限制。它不是完整的中继池调度器:上游最优候选不在列表时,不搜索第二优候选;没有直连可能暂时不可达。也不约束远端后续转发或所有 foreign-network 转发。建议第一轮留空。

实测质量

「测试 → 测量线路质量」复用 UDP socket,先预热,再发送 60 次带唯一序号的 echo,单次默认超时 1 秒,样本间隔 500 ms。需要目标虚拟 IP 上运行协作 UDP echo 服务,可以使用 meshport-test-server。任意游戏端口不能直接作为 echo 服务。

统计中位 RTT、P95(nearest-rank)、相邻有效 RTT 差值均值及未收到有效回包比例。超时也可能由 I/O 错误或 echo 服务不可用导致,不等同于纯链路丢包。迟到、其他来源及不匹配内容的回包不会被计为有效样本。按采样前下一跳分组;前后下一跳不同的样本单列。仅检测采样前后变化,不能证明途中没有短暂切换。

状态 routes.next_hop_peer_id 显示本机实际选择;candidate_next_hop_peer_id 保留上游候选,estimated_latency_ms 仍是上游候选路径估算;直连 RTT 从 peers.latency_ms 读取。optimization_basis 明确为 link_rtt_and_route_estimate。

当前自动选路比较直连的选中连接 RTT 与上游路径估算,并未将端到端 P95/抖动/丢包自动反馈到路由器,也未强制逐条候选路径探测。先分别使用 direct/adaptive 测量同一 echo 目标,检查结果再调阈值。配置修改需断开重连。

用户态子网 TCP 缓冲

SDK 数据面使用接收 1 MiB、发送 512 KiB 的 TCP 缓冲;用户态子网转发使用接收 1 MiB、发送 128 KiB。子网转发原来的收发各 16 KiB,在较高 RTT 下可能限制单连接吞吐。直接使用 512 KiB 发送缓冲时,本地低延迟短下载出现回退,因此子网转发采用较小的发送缓冲。增大缓冲不能解决丢包、重传或链路选路问题。

子网缓冲按 socket 分配,收发合计约 1.125 MiB,尚在握手中的连接也会分配;100 个 socket 的缓冲约占 112.5 MiB,不含其他对象。该修改作用于运行此代码、启用用户态子网转发的网关。仅更新本机 MeshPort 不会扩大远端原版 EasyTier 网关的窗口,内核转发路径也不受此处修改影响。尚需真实远程链路验证,不能仅凭本地模拟结果承诺带宽。

UDP 接收调度

UDP 接收循环每连续接收 32 个报文主动让出调度,避免突发收包时会话队列的消费任务长时间得不到运行机会。保持原有 128 槽队列和丢包策略,不阻塞共享 UDP socket 等待某个节点。该调整在本地加密 SDK 链路的延迟测试中减少了队列满丢包和重复 TCP 数据序号;仍需实际网络、多节点持续负载验证,不能保证所有丢包或现场延迟问题均被消除。

后续范围

独立候选路径探测与端到端反馈、完整专用中继池搜索、拥塞/排队感知、MTU 探测、游戏流优先和跨国长时故障测试尚未实现。此轮没有部署或购买中继服务器。