Skip to content

v0.1.3 — 修 issue #1:在转发就说在转发 + 经本地口计数

Choose a tag to compare

@7icence1Z 7icence1Z released this 12 Nov 10:28
· 5 commits to main since this release

修的是 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 下真的数出入口字节、
    这份字节记到进程头上、端口不在集合里就一个字节都不算。