Skip to content

v0.1.2 — 诊断结论 + 本机模式 + 流量分账

Choose a tag to compare

@7icence1Z 7icence1Z released this 12 Nov 04:56
· 10 commits to main since this release

这一版把面板从"给你三行探测结果"推到"告诉你到底该怀疑谁",同时补上两个长期缺口:
没开 VPN 时也能看流量(本机模式,管理员权限下还有每进程速率),
以及关掉节点后不再一直误报"隧道异常"。

新增

  • 诊断结论(diag.py,新文件,纯标准库)。右上角那句话由证据算出来,不是标题:
    链路 → DNS → 隧道 → 目标,从底层往上排,越底层的问题越先报。结论十四档:
    链路正常 / 目标被墙但代理正常 / 目标需要进出隧道(TUN)/ ⟨网卡⟩ 链路不通 / DNS 解析有问题 /
    链路通但外面不通 / VPN 本地代理口没开 / 代理口被占不是客户端 / VPN 没连上节点(灰)/
    VPN 拒绝连接 / ⟨隧道网卡⟩ 链路不通 / 代理侧 DNS 失败 / VPN 隧道或节点异常 /
    没在走隧道或没有代理客户端,只看本机流量(灰)。
    每档都带证据(对照 www.baidu.com 通 40ms、直连目标 超时、代理通道 不通),鼠标停上去就能看。
  • 本机模式(hostflow.py,新文件,纯 ctypes)。检测不到代理客户端(没系统代理、没 TUN、没控制器)时,
    面板照样监测:GetIfTable2 读网卡 InOctets/OutOctets 给真实 ↓↑ 与累计;
    GetExtendedTcpTable(TCP_TABLE_OWNER_PID_ALL) 拿已建立连接,按进程归并成"谁开着几条连接、连着几个远端 IP"。
    + 域名 收起、站点卡变「进程」、诊断结论写"只看本机流量",不假装知道隧道的事。
  • 管理员权限下的逐进程速率。本机模式以前只数连接不数字节,因为逐进程字节要内核 eStats,
    普通权限下 SetPerTcpConnectionEStats 回 5(ACCESS_DENIED)。现在采集器先用 IsUserAnAdmin 认权限:
    管理员启动时给每条已建立 TCP 连接开统计(SetPerTcpConnectionEStats),1 Hz 差分出每个进程真实的 ↓↑
    (GetPerTcpConnectionEStats 的 DataBytesIn/Out),于是「进程」表和「站点」表长得一模一样 ——
    曲线、速率、累计都有。普通权限保持原样:第一次 Set 拿到 5 就立刻关掉这条路,不重试、不报错、不编数字。
    升级方式:右键 start.cmd →「以管理员身份运行」,不用改配置。
  • 分账:开着 VPN 时直连和隧道一起数。网卡总量每帧都采,和客户端报的"经代理字节"相减,得到"不走代理"那部分。
    实时吞吐的大盘改成网卡总量(真实全机),旁边写 经代理 121 KB/s · 不走代理 8.5 KB/s,两条泳道各挂自己的速率。
    差值含 UDP/QUIC 帧开销,按估算对待。
  • 失败病因分类:探测失败不再显示 URLError,而是 DNS 失败 / 拒绝连接 / 连接重置 / 超时 / 网络不可达 /
    TLS 错误 / 绑不上网卡。URLError 会把真正病因包在 .reason 里,剥一层再判。
  • 网关探测:每条路各自那块网卡的网关单独 ping 一次(只看退出码,不解析输出,中英文 Windows 都稳)。
    这是"Wi-Fi / 网线断了"和"上游断了"的分界线。
  • DNS 双向对比:系统解析器问一次,再绕开它直接 UDP 问 223.5.5.5 一次。
    两边地址对不上就标"疑似污染";系统解析失败而公共 DNS 能解析,就指向本地 DNS 配置。
  • 按网卡绑定握手:把源地址钉到某块网卡再 connect() 目标 443,Wi-Fi 和有线各自独立成一格。
    带源地址的连接会按该地址选路由,所以测的是这块网卡自己的路,而不是"系统默认走哪条就测哪条"。

修复

  • 关掉节点连接之后,无论 VPN 软件开没开都一直显示"隧道异常"。三处病根一起治:
    ① 客户端壳还在、但控制器/代理口读不到时,采集器原本只把这一帧标成失败,面板就卡在 path.active="down",
    而 down 在界面上被写成「隧道异常」—— 现在失败帧会回落到本机模式(flow="host"),网卡速率照数,
    文案改成 ⟨客户端⟩ 在跑,但读不到它的流量(没连节点,或控制器没开);
    ② providers.py 发现客户端进程在、但控制器和统计口都读不到时不再保留旧身份(Registry._clear),
    软件关掉后不会继续去问一个不存在的控制器;
    ③ 界面上 down 改叫「隧道读不到」,并把"客户端在跑但没连节点"归到中性灰档
    (nopx「没在走隧道,只看本机流量」),红色只留给"说在用、但用不了"。
  • 能连上代理口、但隧道里 0 条连接(典型的"没选节点")以前会报成红色「VPN 隧道/节点异常」,
    现在改判中性灰「VPN 没连上节点」,并说明"连上节点这一格会自己变绿"。
  • 本机模式下不再显示那句红色的 控制器 … · 在线,页脚改成 本机模式 · 普通权限:只数连接 /
    本机模式 · 管理员:逐进程速率;VPN 泳道写 隧道未启用,不再是空着的 ?。

界面

  • 「通道探测」卡片右上角换成诊断结论:一句话 + 颜色(青=正常 / 琥珀=目标被墙 / 红=链路、DNS、隧道问题 / 灰=没在用隧道),
    鼠标停上去能看到支撑它的证据。
  • 判定多了 本机直连;站点卡标题变「进程」,右上角按权限写 只数连接 · 不数字节(要管理员权限)
    或 按进程归并 · 1s 采样 · 管理员权限。
  • 实时吞吐大盘改为网卡总量 + 分账;累计改为网卡累计(本次 ↓ ↑);
    连接数的 title 里区分"经代理 N 条 / 本机共 M 条"。
  • 探测失败的那一栏显示中文病因,title 里是原始错误;探测刷新时间挪到刻度行右侧(5/5 成功 · 11:09)。

测试与工具

  • tools/test_diag.py:14 组构造证据过归因判定 + 9 组异常过分类,离线、不发包、秒级跑完。
    含"没有代理客户端"两例、"壳在但没连节点"、"能连控制器但隧道 0 条连接"、"隧道里有连接却打不通(仍报红)"。
    每条用例自己 patch 客户端身份,结论与本机装的客户端无关。
  • tools/test_estats.py:eStats 结构体核对(20 / 1 / 96 字节,字段顺序)+ 普通权限退化
    • 管理员下真读一次(自己开一条连接,验证字节在涨)。
  • tools/test_xray.py:用构造的 v2rayN 配置 + 假统计口验证解析与出口级分账。
  • tools/mock_state.py 支持 MOCK_DIAG=ok|target|vpn|link|dns|nopx、MOCK_HOST=1、MOCK_HOST=1 MOCK_ELEV=1,
    四张示意图都能复现。
  • 新增 docs/panel.png / docs/panel-xray.png / docs/panel-host.png / docs/panel-host-admin.png 四张示意图。
  • start.ps1 非管理员时打一行提示,告诉你右键提权能多看到什么。

文档

  • README 重写:判定五档的真实触发条件、两条泳道各字段的含义、分账怎么算、
    客户端支持矩阵(判定 / 节点名 / 逐条连接 / 字节流量四列)、四种可见度、
    两种权限的差别(本机模式)、数据来源表、快照字段表、隐私声明、排障表、
    以及按主题重排的 19 条边界(权限与可见度 / 精度 / 适配 / 诊断 / 平台)。
  • 修掉几处与代码不符的说法:flow 的真实取值("" / xray / host)、
    并不存在的 FLOW_MIXED / FLOW_SITES 环境变量、以及"本机模式完全拿不到字节数"(管理员下能拿)。