直连还是经隧道 · 经由哪块网卡 · 从哪个公网 IP 出口
24 秒全程:开场简介 → 面板(隧道与直连两条链)→ 片尾安装说明。真实界面渲染,图中数据均为虚构值,由 tools/mock_state.py 生成,可复现。
配乐:Disfigure — Blank(NoCopyrightSounds,免费使用,署名即授权)
2K 完整版(24 秒,含本机模式与逐进程速率)
本程序是仅在本机运行的小型监控面板,用于回答一个问题:**当前时刻的流量是直连还是经隧道转发、经由哪块网卡、从哪个公网 IP 出口。**它同时统计三条数据线 —— 网卡总量、经代理、不经代理 —— 并按实际出口为站点着色;未启用客户端时依据网卡与进程继续统计,客户端未提供统计接口时从其本地代理端口取样。适用于 Windows 10/11,仅使用 Python 标准库,无第三方依赖,无遥测。当前版本 v0.1.5(2026-11-18),变更详见 CHANGELOG。
和它们的分工:任务管理器只给网卡总量,代理客户端的面板只给「走了代理的那部分」,netstat 只给一张连接列表。这里把三条线对齐到同一条时间轴上 —— 同一秒里走的是哪块网卡、经不经隧道、从哪个公网 IP 出去,曲线上每一点的颜色就是那一秒的判定。
npm i -g @7icence1z/flow-tracking # 需要 Node 16+,仅负责调度
flow # 启动采集器并打开面板| 命令 | 作用 |
|---|---|
flow / flow stop |
启动 / 停止采集器 |
flow status(flow stat) |
一屏显示模式、判定、诊断、分账与出口,不打开面板;采集器未运行时以状态码 1 退出 |
flow admin |
以管理员身份启动。仅管理员可见每进程速率,flow 本身不请求提权 |
flow --port 7718 / -h / -v |
指定端口(flow status -p 7718 同样可用)/ 用法 / 版本 |
npx @7icence1z/flow-tracking@latest |
不安装直接运行;省略 @latest 会使用 npx 缓存中的旧版本 |
运行前提为 Python 3.10 及以上(仅使用标准库)与 Edge 或 Chrome;窗口以 --app= 模式启动,独立 profile,已启动时不重复打开,start.ps1 另支持 -Port / -Width / -Height / -DefaultProfile。不使用 npm 时无需 Node:
powershell -ExecutionPolicy Bypass -File .\start.ps1 # 亦可双击 start.cmd;-Stop 停止更新由包管理器完成,不提供 flow update:全局安装执行 npm i -g @7icence1z/flow-tracking@latest,git 副本执行 git pull。
每进程速率需要管理员权限:先 flow stop,再 flow admin(或右键以管理员身份运行 start.cmd)。普通权限的采集器不会被提权实例接管,必须先停止;原因见本机模式。
- 顶部判定:经隧道 / 部分经隧道 / 直连 / 本机直连 / 隧道统计不可读。副标题显示节点名与隧道出口 IP,小字标注判定依据(系统代理注册表、控制器模式、客户端身份)
- 两条数据泳道:本机 IP → 网卡 → 节点 → 出口。网卡由内核路由判定(对目标执行
connect()并读回源地址),不依网卡名推测;右侧为实时速率与承载 17 条 · rule · TUN 关 - 吞吐与分账:0.5 秒一帧、120 秒曲线(本机模式枚举连接,为 1 秒一帧)。总量取自网卡累计字节(
GetIfTable2);经代理 121 KB/s · 不经代理 8.5 KB/s中后者为差值估算。曲线按各采样点当时的判定着色:关闭 VPN 后琥珀段既不消失也不增长,只随窗口左移滑出 - 通道探测:代理与直连分别请求同一目标,另设国内对照点;失败归因为 DNS / 拒绝 / 重置 / 超时 / TLS,并显示最近 96 次结果刻度。卡头 ✎ 可改探测目标、对照目标与间隔(5~120 秒),保存即生效
- 诊断结论:右上角结论由证据计算得出,悬停可查看支撑证据
- 站点:按域名归并的 ↓↑ 速率,颜色对应实际出口(琥珀 = 隧道,青色 = 直连);「+ 域名」写入
config.json - 语言与连接状态:顶栏 中 / EN 切换(英文采用英式拼写,记于浏览器本地,亦支持
?lang=en);连续 6 秒无新帧时显示采集器未连接 · 最后 21:03:10,读数变淡表示为旧帧
未检测到客户端时自动切换为本机模式:统计网卡总量、连接数以及按进程归并的 TCP 连接关系(剔除回环)。客户端在运行但字节数不可读时(典型为 v2rayN 关闭统计接口),区分三种情形:
- 系统代理指向客户端自身开放的本地端口 → 判定
部分经隧道,副标题「在转发 · 字节数不可读」。此时已能证明其在转发,故不表述为「未在走隧道」 - 管理员权限下沿「应用 → 本地端口」的回环 TCP 读取进入客户端的字节(
split.client),改述为「客户端在转发(经本地口计数)」,副标题「经它的本地口计数,隧道份额未知」。入口字节不等于隧道流量,该值仅为上限 - 无法证明时,判定
本机直连,理由仅表述为「读不到它的流量」,不对其行为作出断言
权限决定统计粒度,这是唯一需要选择之处:
| 项目 | 普通权限 | 管理员 |
|---|---|---|
| 网卡总量 / 连接数 / 谁在连谁 | ✅ | ✅ |
| 每进程 ↓↑ 与曲线 | ❌ 仅统计连接 | ✅ 内核 eStats 差分(仅 TCP 净荷) |
| 经代理 / 不走代理分账 | ❌(客户端接口提供的另计) | ❌ 需客户端统计接口;可得者为下一行 |
| 进客户端的字节(经本地口) | ❌ | ✅ 回环代理口 eStats 差分,仅系统代理模式;入口 ≠ 隧道 |
| 页脚 | 普通权限 · 仅统计连接 |
管理员:逐进程速率,系统代理模式下加 + 经客户端字节 |
eStats 在普通权限下返回 5 时立即退回仅统计连接,不重试、不推测(覆盖见 tools/test_estats.py);UDP/QUIC 不计入进程行。客户端在运行但未连接节点亦归入此类。
客户端自动发现,无需配置:端口归属(GetExtendedTcpTable)→ GET /version 识别 Clash API → 依内核命令行定位配置 → 解析节点表(块状与行内 {…} 两种写法都认),每一步均带存活校验;客户端退出后身份信息一并清除。
| 客户端 | 判定 | 节点名 | 逐条连接 | 字节 |
|---|---|---|---|---|
| Clash Verge / Mihomo Party / FlClash / mihomo / 机场定制 | ✅ | ✅ | ✅ | ✅ 按域名 |
sing-box(开启 clash_api) |
✅ | ✅ | ✅ | ✅ 按域名 |
| v2rayN(Xray 内核) | ✅ | ✅ 读取 guiNDB.db |
❌ | ✅ 按出口 |
| 其它 Xray 壳 / WireGuard / OpenVPN / Tailscale | ✅ | 无法识别时显示地域 | ❌ | 网卡 + 出口 |
| 未运行任何客户端 | ✅ 本机直连 | — | ✅ 按进程 | 网卡总量 |
节点名照客户端给的显示;名字等于没说时(proxy、自动选择、只有一面国旗)改用「地域 · 协议」,如 日本 · VLESS,悬停可看原名、地址与判定依据。名字只来自证据 —— 连接表 → 出口 IP → 配置里的默认分组 → 全局模式 → 分组选择 → 唯一节点,一级都判不出就只显示出口地域,不拿配置里第一个节点或上一次的节点去猜;多个分组各选不同节点时会额外注明。
可见度如实标注为连接级(按域名)、出口级(v2rayN 读其 metrics.listen 的 /debug/vars 做差分,仅有「经代理 / 直连」两行)、仅网卡与本机级;无逐域名数据时如实说明,不以总量代填。
采用排除法:自底层向上逐层判定,层级越低者优先报出。红色仅用于「声称在用但不可用」的情形,「当前确实未在使用隧道」一律以中性灰表示。
共 15 种结论:链路正常 · 目标被墙而代理正常 · 目标需要进出隧道 · ⟨网卡⟩ 链路不通 · DNS 解析有问题 · 链路通但外面不通 · VPN 本地代理口未开启 · 代理口被其他程序占用 · VPN 未连接节点(灰)· VPN 拒绝连接 · ⟨隧道网卡⟩ 链路不通 · 代理侧 DNS 失败 · VPN 隧道或节点异常 · 客户端在转发但读不到字节数(灰)· 仅统计本机流量(灰)。悬停结论可查看支撑证据,flow status 输出同一结论。
| 工具 | 每进程流量 | 区分经隧道 / 直连 | 网卡与出口 IP | 客户端未运行时 |
|---|---|---|---|---|
| GlassWire / NetLimiter(商业) | ✅ | ❌ 经隧道的流量计入客户端进程,重复计量 | ❌ | ❌ |
| TrafficMonitor(含每进程插件) | ✅ | ❌ | ❌ | ✅ 仅速率 |
| Clash Verge Rev 连接页 | 逐条连接 | 逐条连接可见策略链 | ❌ | ❌ |
| proxytop(macOS 终端) | ✅ | ✅ | ✅ 接口级 | ❌ 仅 macOS |
| 本程序 | ✅ 需管理员 | ✅ 网卡总量 − 统计接口 | ✅ | ✅ 本机模式 |
差异不在界面,而在分账(不经代理的字节由网卡总量与经代理之差得出,客户端无统计接口时以本地代理入口字节兜底并标注为上限)、出口归属(同时给出网卡与公网出口 IP)与客户端缺席时的可用性(覆盖未安装、未启动、未开 API、未开 TUN 四种情形)。本程序不替代上述工具:Clash 面板给出逐条连接,本程序给出按进程的分账与出口,二者互补。
资源占用、数据来源与自检方式记录于 docs/IMPLEMENTATION.md:常态下不启动任何子进程,进程表、端口归属与网卡数据均直读内核表。
| 键 | 默认值 | 说明 |
|---|---|---|
port |
7717 |
面板端口,仅绑定 127.0.0.1 |
controller |
127.0.0.1:7892 |
Clash 控制器地址;留空则完全自动发现 |
mixed_port |
127.0.0.1:7890 |
出口 IP 探测与「代理通道」所用端口;v2rayN 读自身配置,此项仅作兜底 |
sites |
["chatgpt.com","openai.com"] |
单独监控速率的域名(后缀匹配),「+ 域名」修改此项 |
probe_interval |
10 |
探测间隔(秒),取值 5~120 |
probe_target / control_target |
chatgpt / baidu | 双通道探测目标 / 直连泳道的对照目标;仅接受 http(s),不可指向本机 |
环境变量:FLOW_PORT、FLOW_CONTROLLER。修改后需重启采集器;探测三项为例外,经卡头 ✎ 修改后立即生效。
接口:/(面板)、/api/state(快照 JSON)、/api/stream(SSE,0.5 秒一帧)、/?poll=1(退化为轮询)、POST /api/sites({"action":"add"|"remove","domain":…})、POST /api/probe({"target","control","interval"},三项均可省略;出错返回 400 与中英两版 msg)。快照中需关注的字段:
flow:""(Clash 系,连接级)/xray(出口级)/host(本机模式)path:{active, reason, sysproxy},active取vpn/mixed/direct/downdiag:{state, label, why, evidence},后三者为{zh, en}split:{nic, proxy, direct, client, src};src为api(数值来自统计接口)或loop(client为入口字节,此时proxy/direct为null)
其余 probe / tunnel / client / iface / route / node / egress / probes / sites / extras / hist 按名称读取;tools/peek.py 是上述接口的命令行查看器。
仅监听 127.0.0.1(局域网内其他主机无法连接);仅读取本机状态(注册表、进程表、网卡统计、配置,SQLite 以只读方式打开);对外请求仅有出口 IP 探测与通道探测,不携带身份信息;不写日志、不收集、不上传;面板不引用任何外部资源(无 CDN、字体与统计脚本)。
server.py 采集 + HTTP/SSE(标准库,单文件)
providers.py 客户端发现 / 配置解析 / 订阅感知 / Xray 统计口
hostflow.py 本机模式:GetIfTable2 + GetExtendedTcpTable + GetAdaptersAddresses + 管理员 eStats(纯 ctypes)
diag.py 网关(ICMP)/ DNS 对比 / 按网卡握手 / 错误归类
web/index.html 面板(单文件,内联 CSS/JS,手写 SVG)
start.ps1, start.cmd 启动器 / 双击入口
package.json, bin/flow.js npm 包装(flow 仅将参数转交 start.ps1)
config.json 配置
docs/ 四张示意图(Clash / v2rayN / 本机 / 本机+管理员)
tools/ peek.py 查看快照 · mock_state.py 生成演示数据 · test_* 自检(含 test_node.py 75 项)· check_js.py JS 语法检查
| 现象或问题 | 原因与处理 |
|---|---|
| 是否必须使用管理员权限 | 否。仅「每进程速率」与「进客户端的字节」需要;进程卡只有连接数、无速率即表示当前为普通权限,执行 flow stop → flow admin 即可 |
| 为什么「不走代理」是估算值 | 它恒等于网卡总量与经代理之差,含加密与帧开销,略微偏高,不应视为精确的直连流量 |
| 杀毒软件提示或 SmartScreen 拦截 | 未签名的 Python 脚本与 PowerShell 启动器常被拦。可核对源码后本地运行,或提交 issue 附 flow status 输出 |
| 面板不刷新或一直显示旧帧 | SSE 被拦截时改用 http://127.0.0.1:7717/?poll=1;顶栏显示 采集器未连接 则采集器已退出 |
| 提示「本地控制器没有响应」 | 客户端未启动,或未开启 REST API(Clash 系需勾选「外部控制」) |
| 已启用 VPN,面板仍显示「直连」 | 流量未交给客户端:系统代理关闭、TUN 关闭或 7890 无连接。请在客户端启用「系统代理」或「TUN」 |
| 未启用 VPN,面板却显示「部分经隧道」 | 先确认顶栏未显示 采集器未连接(否则为旧帧);flow status 中 direct 表示直连。客户端进程残留时须同时满足「系统代理开启、本地端口在监听、进程存活」三项方判定为在转发 |
站点速率持续为 0 B/s |
该秒无流量,或该站点走直连(Clash 系不统计直连流量) |
| 中文乱码 / 启动器报语法错误 | .ps1 须以带 BOM 的 UTF-8 保存(仓库内文件已含 BOM,编辑后勿丢失) |
| 如何更新与卸载 | 更新:npm i -g @7icence1z/flow-tracking@latest;卸载:npm rm -g @7icence1z/flow-tracking。git 副本执行 git pull |
| 是否支持 macOS / Linux | 否。依赖 Windows 内核网络表(GetIfTable2 / GetExtendedTcpTable / GetAdaptersAddresses)与 netsh |
- 「经代理」仅来源于客户端统计接口(Clash
/connections、Xray/debug/vars);不走代理恒为网卡总量与经代理之差,属估算值(含加密与帧开销,略微偏高) - 「经本地口」统计入口字节,并非隧道流量:系统代理模式下应用先连接客户端本地端口,eStats 仅表示进入客户端的流量,客户端可能按规则将部分流量直接转发,故该值仅为上限;且仅覆盖「系统代理 → 本地端口」——TUN 模式无回环代理连接,UDP/QUIC 不经 HTTP 代理端口
- 粒度与精度取决于权限与客户端:逐进程、逐域名字节需内核 eStats 或 DNS 缓存,二者均需管理员(非管理员
SetPerTcpConnectionEStats返回 5,ipconfig /displaydns需提升权限);eStats 仅统计 TCP 净荷。可见度随客户端而异:Clash 至域名,Xray 至出口,WireGuard 仅有网卡与出口 IP,不以总量分摊到域名后冒充精确值 - 诊断采用排除法,并非抓包:可区分「链路 / DNS / 隧道 / 目标」四层,无法区分物理链路故障与路由器故障;一轮约 15 秒,证据为快照;公共 DNS 固定为
223.5.5.5 - 适配范围与平台:v2rayN 依据其生成配置的格式适配(以构造样本与假统计接口验证,未覆盖所有版本;
guiNDB.db结构变化后仅退回显示地址);客户端未连接节点时无法区分「未连接」与「已连接但不通」,按最可能的解释以灰色呈现。仅支持 Windows,只读、不修改系统代理与路由,终止采集器不影响任何系统状态
以 MIT 发布:可自由使用、修改与再分发,须保留版权与许可声明;软件按原样提供,不附带任何担保。本程序不包含第三方代码。