Files
MeshPort/docs/stability-testing.md
shenandshen c7cc2aa865 Fix VPN internet connectivity and simplify client setup
Initialize Android physical interfaces and preserve macOS scoped routes. Add redacted diagnostics, default DNS, ordered auto-save, simplified controls, scanner rotation settings, and native regression coverage. Restore vendored build sources and document validation and stability checks.
2026-10-12 06:51:25 -07:00

3.3 KiB

MeshPort 稳定性验证

当前已完成短时 macOS 联网及 Android 真机 TCP/UDP、DNS、HTTPS、启停和清理验证;尚未完成长时间后台与物理网络切换验收。短时通过不能替代稳定性验收。

测试安排

阶段 操作 观察与通过条件
启停回归 同一配置连接/断开 50 次,组网、代理、联合模式分别执行 无崩溃、无遗留 VPN;每次可重新连接;断开后普通上网恢复
连续通信 连续运行 1 小时,每 30 秒执行 HTTPS 请求、组网 TCP 和 UDP 回显 记录成功率、延迟和错误阶段;与未使用 MeshPort 的网络基线比较,区分公网故障与 APP 故障
后台运行 连续 8 小时,包含锁屏、切换 APP、恢复前台 后台连接符合预期;恢复后状态准确,能通信或明确报告连接失败;无永久卡在“已连接但无网”
网络变化 Wi-Fi 断开/恢复、两个 Wi-Fi 间切换、有移动数据的设备切换 Wi-Fi/移动网络,各 10 次 记录恢复时间;可自动恢复或明确提示重连;代理出站不进入自身 VPN
故障恢复 关闭测试代理/组网网关、使 DNS 不可达,再恢复服务 有可定位的日志;失败不偷偷切换出口或泄漏组网流量;恢复或重连后可用
资源与清理 比较启动前、运行中、重复启停后、停止后的资源 排除启动预热与缓存后,内存、线程、FD 不持续增长;停止后无测试 TUN、路由或 DNS 遗留

先执行短时测试,再逐步延长。不要用全部无响应的数据推断 APP 故障;应保留同一网络上的基线、测试节点可达性和发生时间。

使用现有测试

  • 应用内 UDP 质量页可记录 RTT、P95、抖动和未响应率,需要远端回显服务;它不能代表系统 VPN 的稳定性。
  • Android 系统组网与统一代理真机脚本见 Android 文档。使用 scripts/test-android-device.sh,结束时自动恢复普通 APP,避免 Flutter 直接测试后卸载用户 APP。
  • 当前统一代理真机脚本只重复两次启停;50 次、8 小时后台及网络切换仍需单独执行并记录。
  • macOS 检查连接前后的默认路由、物理 scoped route 和 DNS;只清理测试会话拥有的路由。

Android 采样

# 记录脱敏运行阶段,不采集全部系统日志。
adb -s DEVICE_SERIAL logcat -s MeshPortRuntime:I MeshPortVPN:I AndroidRuntime:E

# 在各阶段重复采样,比对 PSS、线程和 FD 趋势。
adb -s DEVICE_SERIAL shell dumpsys meminfo com.example.meshport_lab
adb -s DEVICE_SERIAL shell pidof com.example.meshport_lab
adb -s DEVICE_SERIAL shell ls /proc/APP_PID/fd
adb -s DEVICE_SERIAL shell ls /proc/APP_PID/task

部分设备限制读取 /proc,这时记录可获取的 meminfo 与进程状态;不要为了采样关闭设备安全保护。原始日志留在本机 outputs/validation,Git 只提交不含私人配置的验证摘要。

验收记录

每次记录 APP 构建号、系统版本、入口与功能、节点协议、网络类型、时长、请求数量/失败数量、延迟、内存趋势、恢复时间和遗留资源检查。测试报告区分“已通过”“失败”“未执行”;只有三种入口及目标平台的相关场景完成后,才对对应范围给出稳定性结论。