Repository navigation
v0.1.2 — 诊断结论 + 本机模式 + 流量分账
这一版把面板从"给你三行探测结果"推到"告诉你到底该怀疑谁",同时补上两个长期缺口:
没开 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环境变量、以及"本机模式完全拿不到字节数"(管理员下能拿)。