Repository navigation
v0.1.3 — 修 issue #1:在转发就说在转发 + 经本地口计数
修的是 issue #1:
客户端明明在转发,面板却说"没在转发"。顺手把"读不到它的字节数"从死路变成活路 ——
不用让用户去开 v2rayN 的统计口,就能数出"应用 → 客户端本地口"这条回环连接上的字节。
修复
- "在转发"和"没在转发"分成两件事判。以前只要控制器 / 统计口读不到,就写「没在走隧道」,
可系统代理明明指着客户端自己开的本地口。现在先收集"它在转发"的证据(_forwarding_proxy()):
系统代理开着 + 客户端身份还在 + 那个端口确实在听 + 端口属于它(或它的内核进程,两层父进程、
进程名都能对上);拿到证据就判部分走 VPN,理由改成"在转发,但字节数读不到" ——
只说读不到,不断言它没干活。 - 证明不了的时候也不再顺口下结论:只说"读不到它的流量 · 按网卡统计",
不再写"本地代理口 / 控制器都连不上"这种没验证过的话。 - 端口在听、但不是它的进程开的(别的程序占着)→ 不当证据,不猜。
新增
- 经本地口计数:不给统计口也能数出"进了客户端"的字节。系统代理模式下,应用是先连
127.0.0.1:10809再由客户端转发出去的,那条回环 TCP 连接上过的字节就是入口字节。
管理员下对"远端端口 = 客户端本地代理口"的已建立连接做 eStats 差分(hostflow.py的新入参
proxy_ports),得到split.client。- 不碰客户端配置、不重启它的内核、不要求它开统计口;Clash 关了 API、v2rayN 关了统计口都一样能数。
- 入口 ≠ 隧道:客户端按规则可能把一部分直接放出去,所以面板只把它当"上限"报
(「经客户端 …」,进程行染中性色),不拿它冒充"经代理"、也不拿它做差算"不走代理"。 - 只数 TCP(UDP/QUIC 本来就不经 HTTP 代理口),且只在系统代理模式成立 ——
TUN 模式没有回环代理连接,那种情况也不需要(网卡本身就是隧道网卡)。 - 每进程行跟着变准:以前浏览器走代理时它那行几乎是 0;现在把入口字节并回它的行,
并单独标出其中多少经过本地代理口。 - 发布字段:
split.client(入口字节)+split.src="loop";此时split.proxy/split.direct
为null—— 真分账要客户端统计口,src="api"才是那个来源。
- 第 15 档诊断多一种说法:管理员下数到入口字节时,说「客户端在转发(经本地口计数)」,
不再说"读不到字节数",也不说成"分账"。 flow admin的收益从"每进程速率"扩成"每进程速率 + 进客户端的字节"(后者只在系统代理模式下有)。
复核修正(Codex review)
PR #2 的自动审查提了三条,逐条核对后都成立,已经改掉:
- 把入口字节当隧道流量(P1):有路由规则的客户端会把
geosite:cn之类直接放出去,
入口字节里混着"过客户端但没走隧道"的量。改成只发split.client,文案与染色都不再声称走 VPN。 - 端口集合把不该算的端口算进来(P2):
ProxyEnable=0时注册表里残留的地址、
以及远端(非回环)代理地址的端口,都可能匹配上无关的本机服务。改成只认
"系统代理开着且指向本机"或"客户端自己报告的本地口",并且只有拿到转发证据才使用这堆字节。 - 前端读不到"有没有入口数据"(P2):
Collector._publish()发布的host里不含proxy字段,
前端却拿host.proxy判断,真机上永远是 false。改成从split.src === "loop"+split.client判断;
mock 也去掉了那个只在演示数据里存在的字段,避免示意图掩盖问题。
收尾:面板与命令行
修复
- VPN 关掉之后琥珀色折线不再消失(面板):主曲线以前整条按"此刻"的状态上色,隧道一断就从琥珀翻成
青色,历史跟着被改写。改成每个采样点记下"当时走哪条路",按连续段上色 —— 关掉 VPN 之后琥珀不再长新点,
旧点留在原处、随窗口继续向左滑出去,看得出"那段时间走的是隧道"。 - 采集器掉线不再冒充"现在":窗口里那一帧若是旧的(被 kill / 崩了 / 端口改了),顶栏出现
「采集器未连接 · 最后 21:03:10」,判定与读数变淡,直到新的快照进来才恢复。以前会一直挂着上一帧的
「部分走 VPN」,看上去像"kill 了客户端还在走 VPN"。 - 进程表缓存里的死进程不算"在转发"(
providers._alive()):_table()缓存 30 秒、_ports()缓存
15 秒,客户端被 kill 之后缓存里还留着它的名字和端口归属。现在转发证据必须挂在活着的 PID 上,
免得"进程都没了,面板还说在走 VPN"。 flow status会连带把面板也拉起来:runStatus()是异步的,没退出就落到了下面的psRun()。
改成取完状态直接return。
新增
flow status(别名flow stat):读一次/api/state打印一屏 —— 模式、判定、诊断、通道、
网卡、大盘与分账、累计、出口 IP、客户端与节点;-p可指定端口。采集器没起时说清"没在运行"并退出 1。
flow --help/flow -h/flow help里列出来了。flow --version(别名-v、version):直接从包里的package.json读版本与包名,不依赖采集器、不碰 Windows 检查,flow -v在管道/CI 里也能用。tools/check_js.py:把面板内联<script>抠出来跑node --check。面板 JS 语法错只会表现为
"连接中…"停在原地,这个闸能在打包前拦住。tools/mock_state.py加MOCK_OFF_AT=<次数>:手工看"VPN 关掉之后"的曲线(前 N 帧琥珀、之后直连)。tools/test_diag.py加 2 项:进程表缓存里名字对得上、但 PID 已死 → 不算在转发;PID 活着 → 才算。
文档
- README 整体按 v0.1.3 现状改:命令表加
flow status/flow --help与一小段用法(含退出码);
面板那节写清"曲线按采样点当时的判定留色"和"连不上采集器时的顶栏提示";
本机模式那节补第三种情形(管理员下的经本地口计数)、权限表加一行、结论表第 15 档写清两种说法、
数据来源表加"进客户端的字节(本机模式)"、split字段说明、
排障表加"开了 VPN 但面板说直连"和"没有 VPN 却写部分走 VPN"、边界里写清入口计数的适用面
(只 TCP / 只系统代理模式 / 入口≠隧道);版本节与顶部一行改成已发布 v0.1.3。 tools/test_diag.py:16 组构造证据 + 9 组异常分类 + 16 组本机 / 在转发 / 入口计数(共 41 项)。
入口计数 7 项:端口集合的准入与排除(含注册表残留、远端代理地址)、假 eStats 下真的数出入口字节、
这份字节记到进程头上、端口不在集合里就一个字节都不算。