Files
MeshPort/docs/optimization.md
T

44 lines
3.3 KiB
Markdown
Raw 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 秒。
UDP 优先作用于同一节点已经建立的连接,保留 TCP 作为备用。尚未首次 ping 确认的打洞连接不会抢占已确认连接。连接选择最多每 5 秒刷新;路由选择缓存 2 秒,通过流量或状态采样驱动阈值评估。策略不会凭空建立配置中没有的备用通道。
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 目标,检查结果再调阈值。配置修改需断开重连。
## 后续范围
独立候选路径探测与端到端反馈、完整专用中继池搜索、拥塞/排队感知、MTU 探测、游戏流优先和跨国长时故障测试尚未实现。此轮没有部署或购买中继服务器。