Files
MeshPort/docs/testing.md
T
shenleiandClaude Opus 5.5 dc1bfc99d2 Move mesh networking logic into the SDK and fix lifecycle bugs
SDK:
- Add build_config/migrate_config, mesh_cidrs, route_generation, health
  and start_bridged; expose abi_info (capability revision 2).
- Add wait_routes long-poll; stop wakes waiters, and context_free now
  stops the network immediately instead of waiting for waiters to time out.

Hosts:
- Dart: waitRoutes(), MeshProxySession route watcher, ABI capability check.
- Android: fix a deadlock where every VPN request waited on its own
  single-thread worker; requests are now async, status is served from a
  snapshot, and combined mode reports Partial when the mesh stops.
- macOS helper: mesh-only unified mode stops when the mesh is lost;
  installed_subnet_routes excludes the overlay.
- Lab: restore Partial sessions, write migrated profiles back, remove the
  unreachable TOML import dialog; native test now connects via the form.

Docs updated accordingly.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-15 18:17:42 +09:00

9.3 KiB
Raw Blame History

验证记录

Android 阶段(2026-10-10)

ARM64 Rust 原生库、JNI 桥接、Android debug/release APK 构建通过。OPPO PJZ110(API 37,4 KB 页面)已完成 Android Keystore 独立测试存储的保存/重新读取/删除,以及 SDK 经隔离公告子网的 TCP/UDP 回显。系统 VPN 授权后,Java 和 Dart 普通系统 Socket 的 TCP/UDP 回显、公告子网自动安装与撤销全部通过。修复了 JNI 绝对路径依赖、受保护 DNS resolver 功能缺失和 Android 网络注册时序。隔离 USB 夹具不覆盖公网打洞、长期后台运行或移动网络切换。

最新源代码 Flutter analyze 无问题、7 项 widget 测试通过(3 项依赖原生 macOS 库的测试跳过),Rust workspace 测试及 doc-tests 通过。正式客户端界面的新版 APK 已打包,设备离线时尚未安装;测试夹具已关闭。需要设备重新连接完成剩余测试。详见 android.md。

2026-10-09,macOS Apple Silicon。

已经通过:

  • Rust workspace 首次构建。
  • 打洞 UDP 连接即使上游 directly_connected_conns 为空仍判为直连;关闭连接、外网逻辑连接不误判。
  • 配置不允许 TUN、系统路由/DNS选项;未知字段拒绝;解析错误不泄漏密钥。
  • 两个实际 EasyTier 原生实例通过本机 UDP tunnel 连接,虚拟 IP TCP echo 与 UDP数据校验。
  • 实际通信后上传/下载计数增加、采样速率大于零、默认链路 RTT 测量成功。
  • 停止实例及3次重新创建/停止。
  • C ABI context 创建、停止态、非法/失效句柄、重复释放。
  • 穿透详细日志 opt-in 采集、保留节点 ID、过滤其他应用模块日志。
  • Dart后台isolate → C ABI → Rust → 两节点EasyTier UDP通信,校验字节与来源。
  • Flutter widget 初始未连接状态、设置入口。
  • Flutter 组网表单填写并保存 → 概览连接 → 实际原生引擎启动 → 状态显示 → 断开连接(native_connect_test.dart)。
  • C 示例编译并读取原生实例状态。
  • Flutter Redmi_AX6 打洞直连显示 7.5 ms 实测 RTT,排除错误中继标签。
  • Flutter 节点 RTT、路由估算、流量速率和中继统计范围显示测试;已有直连但实际路由经中继时正确区分。
  • Flutter macOS debug 构建。

注意:首次 UDP测试发现上游只接收已发送过的远端会话报文;测试按上游会话模型显式预热,不把它当成通用 UDP监听。游戏服务端的普通 socket 回包路径仍需实际服务器验证。

运行命令:

scripts/cargo-local.sh test --workspace --locked
scripts/cargo-local.sh clippy --workspace --all-targets --no-deps --locked -- -D warnings
cd apps/meshport_lab
flutter analyze
flutter test
# 包含真实原生引擎的测试(先构建 Rust 库)。未设置环境变量时这些测试显示为 skip。
MESHPORT_LIBRARY="$(cd ../.. && pwd)/target/debug/libmeshport_ffi.dylib" \
MESHPORT_PROXY_LIBRARY="$(cd ../.. && pwd)/target/debug/libmeshport_proxy.dylib" \
flutter test
dart run tool/native_smoke.dart ../../target/debug/libmeshport_ffi.dylib

最后一条从 apps/meshport_lab 执行,也可传入 Rust 库的绝对路径。

后续:真实游戏服务器发布版互通、网络切换/中继故障、长时内存与并发、用户态UDP首次入站支持、异步ABI、移动端打包与真机测试。

跨国优化第一轮回归

已通过:Rust workspace 12 个测试及 doc-tests;策略阈值、持续时间、冷却、候选限制与失效回退;两个实际 EasyTier 实例同时建立 TCP/UDP,确认 UDP 被选择,关闭 UDP 后选择 TCP。Dart → C ABI → 实际 overlay 质量采样验证成功回包、下一跳及超时结果。Flutter analyze 无问题,包含原生导入的 6 个测试全部通过;更新后的 macOS debug 包构建和签名通过。

Clippy 使用 --no-deps 检查 MeshPort 工作区且 -D warnings 通过。保留的上游源码在 Rust 1.99 下有 8 条既有弃用/未使用警告。

尚未完成真实跨国线路的长期对比、满负载游戏测试、UDP 黑洞恢复时延测试以及全部候选路径的端到端自动探测;本机功能测试不证明公网加速效果。

macOS 系统组网阶段(2026-10-10)

已通过 Rust workspace 13 项测试及 doc-tests、Flutter analyze、Flutter 8 项测试(包含 Unix 控制通道并发请求顺序及关闭清理)、macOS debug 构建和 codesign 深度校验。

系统模式自检曾完成真实 OS TCP/UDP → utun → EasyTier 的回显,并检查停止删除接口、默认路由不变。重复自检发现网卡初始化系统命令存在间歇性等待;macOS 命令已改为后台线程等待,避免依赖 Tokio 的进程信号通知;helper 增加原生操作 60 秒退出保护。最终代码连续两轮特权自检均通过:普通 OS TCP/UDP 经 utun 回显正确,停止后接口删除,启动期间及停止后默认路由保持不变。结果记录在 /tmp/meshport-system-vpn-final.log,阶段日志 PID 23903、23924。Clippy --no-deps -D warnings 通过。

Keychain 调用已编译,尚未执行保存/恢复的 GUI 端到端测试。此阶段的 Android/iOS 系统模式尚未实现(Android 最新验证见本文开头);真实游戏、跨国长期压测和故障切换仍需后续验证。

指定远端子网修复(2026-10-10)

Rust 13 项测试及 doc-tests、Flutter 8 项测试、analyze、Clippy --no-deps -D warnings、macOS 构建与签名通过。系统模式开启显式私有子网接入,拒绝默认路由、公网网段及本机接口网段重叠。

在 v2rayN TUN 开启时,特权自检为 10.253.78.0/24 添加 MeshPort 路由,经普通 OS TCP/UDP 完成额外子网的回显;确认目标路由指向测试 utun,停止后该接口及子网路由清理,默认路由不变。记录 /tmp/meshport-subnet-self-test.log。这验证的是本机额外子网路由和数据面;Redmi_AX6 发布的真实局域网及屏幕共享仍需用新版重连实测。当前显式接入,不自动接受全部节点发布的子网。

自动公告子网接入(2026-10-10)

此版本取代上一阶段的手动子网列表。应用内与系统模式使用相同的私有 IPv4 /16~/32、32 项上限、虚拟网段和本机接口冲突过滤规则。runtime.subnet_routes 配置与 UI 字段均已删除。

应用内集成测试使用真正的发布节点:将 loopback 服务映射发布为 10.253.79.0/24,SDK 客户端自动学习后通过该子网完成 TCP 和 UDP 双向回显;发布节点清空公告后确认接入列表消失。测试节点启用独立 packet proxy host capability,生产客户端无需启用子网发布或 KCP/QUIC。

系统特权自检通过自动公告学习安装额外子网路由,经普通 OS TCP/UDP 回显;发布节点清空公告后确认路由删除,停止后 utun 消失,默认路由不变。记录 /tmp/meshport-auto-system-final.log。该自检的服务位于另一节点的虚拟 IP,应用内映射子网测试另外覆盖了后端服务访问。

此前实际 Redmi_AX6 子网 192.168.21.0/24 的屏幕共享端口已验证返回 RFB 握手;用户确认访问问题已解决。新版在真实网络中的自动接入仍需用新客户端重连验证,已有真实验证使用的是手动路由版本。

最终检查:Rust 工作区 16 项测试及 doc-tests、Clippy --no-deps -D warnings、Flutter 8 项测试(含最终原生库导入)、analyze、macOS 构建和严格签名验证通过。独立应用 outputs/macos/MeshPortLab-20261010121113.app。

代理 TUN 先启动时的物理网卡连接(2026-10-10)

macOS 网络地址收集不再追加默认出口探测到的 TUN 地址;IPv6 使用同一物理网卡过滤。networksetup 硬件检测改用阻塞线程池等待。诊断增加 bind_device 和接口候选地址。

在 v2rayN utun58(172.18.0.1)保持开启时运行 scripts/cargo-local.sh test -p meshport-easytier physical_bootstrap_with_existing_tun -- --ignored --nocapture,通过物理地址启动独立测试网络并完成 EasyTier TCP 握手,同时断言候选不包含任何 utun 地址。测试不修改 OS 路由。这是本机真实套接字回归,不能替代用户远端节点在相同启动顺序下的互通验证。记录 /tmp/meshport-tun-bootstrap.log。

配置保存与 MeshPort 品牌(2026-10-10)

设置页增加独立保存、重新载入和删除;启动自动回填,不自动连接。保存的未编辑高级 TOML 原样保留。Flutter 测试覆盖未连接保存、重建界面后回填名称/密钥/节点/IP、保持断开、删除,以及高级参数保留。测试调用真实 FFI,钥匙串 MethodChannel 使用隔离内存替身,不覆盖用户已有钥匙串配置。原生 macOS Keychain 实现随应用编译,真实钥匙串跨重启访问授权仍以设备实测为准。

FFI 测试验证普通 validate 不返回密钥,只有显式 include_profile 才返回表单所需字段。应用正式名称为 MeshPort;macOS/iOS/Android/Windows 图标及 Flutter 页头配置为已设计图标。其他平台尚未打包验证。

最终验证:Flutter 10 项测试及 analyze、FFI 3 项测试、Clippy --no-deps -D warnings、macOS 构建和严格签名验证通过。已打开正式应用,窗口标题为 MeshPort,页头为新图标,设置页顶部“保存配置”按钮可见。独立应用 outputs/macos/MeshPort-20261010144609.app(0.1.0 预览版)。实机检查未保存测试配置,避免污染用户配置。