# 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 文档](android.md)。使用 `scripts/test-android-device.sh`,结束时自动恢复普通 APP,避免 Flutter 直接测试后卸载用户 APP。 - 当前统一代理真机脚本只重复两次启停;50 次、8 小时后台及网络切换仍需单独执行并记录。 - macOS 检查连接前后的默认路由、物理 scoped route 和 DNS;只清理测试会话拥有的路由。 ## Android 采样 ```sh # 记录脱敏运行阶段,不采集全部系统日志。 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 构建号、系统版本、入口与功能、节点协议、网络类型、时长、请求数量/失败数量、延迟、内存趋势、恢复时间和遗留资源检查。测试报告区分“已通过”“失败”“未执行”;只有三种入口及目标平台的相关场景完成后,才对对应范围给出稳定性结论。