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

54 lines
4.8 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 跨国线路优化:第一轮
MeshPort 使用本地定制的 EasyTier 核心,保持现有网络协议。修改位于 vendor/easytier,不要求现有服务端同步修改。混合版本、公网链路仍需实测。
## 线路策略
Flutter「设置 → 连接」默认选自适应。引擎只影响通过 MeshPort SDK 发起的通信,不创建 TUN 或改变系统路由。
```toml
[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 探测、游戏流优先和跨国长时故障测试尚未实现。此轮没有部署或购买中继服务器。