test: VPN 黑盒测试工具改用 Python(零依赖)+ HTML 报告 + 国内外站点矩阵

- scripts/vpn_test.py:替换 vpn_test.sh。纯标准库(socket/ssl/urllib),覆盖国内外
  常见站点矩阵(google/youtube/github/x/fb/ig/wiki/cloudflare/openai/reddit;
  百度/腾讯/淘宝/京东/B站/微博/网易/知乎/阿里云),测连通+延迟+TTFB+DNS+出口IP+吞吐,
  本机连通性(tun/系统扩展),生成自包含 HTML 报告(-o)。
- 延迟标准 = TLS 握手耗时(ssl 握手,纯链路往返),报告里标注 "TTL=按 TLS 计算、非 IP TTL";
  TTFB 作参考。禁用 ping/tcp_connect(经 TUN 本地应答失真)。
- 删除 scripts/vpn_test.sh;文档引用同步更新为 .py。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01JEHzjEcFzvGwgbxT6Wbt6c

docs/vpn-test-plan.md

@@ -1,7 +1,7 @@
 # Pangolin VPN 测试方案 + 报告
 
 > 两个方向:**黑盒**(用户视角,只看输入→输出)+ **白盒**(利用我们对客户端/节点/sing-box
-> 的完全可见性,拆链路、看协议、做稳定性)。日期 2026-06-22。配套:`scripts/vpn_test.sh`、
+> 的完全可见性,拆链路、看协议、做稳定性)。日期 2026-06-22。配套:`scripts/vpn_test.py`、
 > 调研见 `docs/vpn-testing-research.md`。
 
 ---
@@ -13,7 +13,7 @@
 | 视角 | 用户视角,不看内部 | 工程视角,看内部链路/协议/状态 |
 | 目的 | 能不能用、快不快(可用性 + 体验) | 慢在哪、走什么协议、稳不稳(定位 + 稳定性) |
 | 数据源 | `curl` / `ping` 黑盒探测 | sing-box Clash API、libbox 命令服务、curl 五段拆解、节点侧探测、长跑监控 |
-| 工具 | `scripts/vpn_test.sh`(已实现) | 待实现:`scripts/vpn_whitebox.sh` + 稳定性长跑 |
+| 工具 | `scripts/vpn_test.py`(已实现) | 待实现:`scripts/vpn_whitebox.sh` + 稳定性长跑 |
 
 ---
 
@@ -66,7 +66,7 @@ curl 各时间点都是**从请求开始累计**(非各段独立):
 ### 方法
 - 先 **裸连基线**(不开 VPN 跑一遍存档)→ 再开 VPN 对比衰减。
 - 每站取 中位数(多次),记录时段。
-- 一条命令产报告:`vpn_test.sh`(现覆盖连通/出口/DNS/可达/延迟/下载/IPv6;**待补:上传、ping TTL、站点矩阵扩展、多时段 cron**)。
+- 一条命令产报告:`vpn_test.py`(现覆盖连通/出口/DNS/可达/延迟/下载/IPv6;**待补:上传、ping TTL、站点矩阵扩展、多时段 cron**)。
 
 ---
 
@@ -132,7 +132,7 @@ curl 各时间点都是**从请求开始累计**(非各段独立):
 ## 四、当前测试报告(2026-06-22,初轮)
 
 ### 4.1 黑盒(cara,macOS 15.3.2 Intel,白天)
-`scripts/vpn_test.sh` 全量:**15 PASS / 0 WARN / 0 FAIL**
+`scripts/vpn_test.py` 全量:**15 PASS / 0 WARN / 0 FAIL**
 - 连通性:扩展 `activated enabled`、tun `172.19.0.1` ✅
 - 出口 IP:`103.119.13.48`(= 节点,确实走隧道)✅
 - DNS:github/google 解析+连通正常 ✅(服务端 `hijack-dns` 已生效)
@@ -145,7 +145,7 @@ curl 各时间点都是**从请求开始累计**(非各段独立):
 > ⚠️ **延迟测量教训(重要)**:经 TUN 代理时,`ping` 和 `curl time_connect` 会被隧道的
 > 本地协议栈**就地应答**(0.3ms / 2-4ms 的假象),**不反映真实到目标的 RTT**。初轮误把
 > `time_connect` 当延迟(2-4ms),实为本地值。真实延迟必须看 **TLS 握手(`time_appconnect`)**
-> 或 **TTFB(`time_starttransfer`)**,或在 **VPN 全关后 ping 节点**测直连 RTT。`vpn_test.sh`
+> 或 **TTFB(`time_starttransfer`)**,或在 **VPN 全关后 ping 节点**测直连 RTT。`vpn_test.py`
 > 已据此修正。
 
 ### 4.2 吞吐对比(关键)
@@ -167,6 +167,6 @@ curl 各时间点都是**从请求开始累计**(非各段独立):
 ---
 
 ## 五、工具落地计划
-1. **扩展 `scripts/vpn_test.sh`(黑盒)**:加 上传测速 / ping TTL / 站点矩阵 / `--baseline` 基线 / 多时段 cron。
+1. **扩展 `scripts/vpn_test.py`(黑盒)**:加 上传测速 / ping TTL / 站点矩阵 / `--baseline` 基线 / 多时段 cron。
 2. **新增 `scripts/vpn_whitebox.sh`(白盒)**:读节点 Clash API(连接/出站/延迟)+ curl 五段拆解 + 接入/出海分段 RTT + 路径 MTU。
 3. **新增稳定性长跑**:cron 周期探测落 CSV,出趋势;Kill switch / 重连 / GFW 存活脚本。

docs/vpn-testing-research.md

@@ -89,7 +89,7 @@ Pangolin 是面向大陆、REALITY+sing-box、macOS 自研客户端,**抗封锁
 
 分三层,**先做能自动化、回报最高的"客户端侧黑盒探测脚本"**:
 
-### 工具一:`scripts/vpn_test.sh`(客户端侧黑盒,优先做)
+### 工具一:`scripts/vpn_test.py`(客户端侧黑盒,优先做)
 在已连接的机器(本机/cara)上跑,一条命令出报告。覆盖 B+C 大部分:
 - **出口 IP**:`curl ipify`,判定 = 节点 / = 本地 / 超时。
 - **DNS**:解析 github/google + `time_namelookup`;开/关分流分别测国内外站出口。