ZOYKUHot Board

mateo-ki/vpn-parserDokumentation

mateo-ki/vpn-parser open-source repository on GitHub

Sprach-Hinweis:Es ist keine lokalisierte Dokumentation verfügbar. Es wird das offizielle englische Original angezeigt.
Schnellinstallation
git clone https://github.com/mateo-ki/vpn-parser.git

VProxy

简体中文 | English

Rust + egui 编写的高性能现代化跨平台代理工作站:采集订阅、解析节点、驱动六大代理内核(Mihomo / sing-box / VP-Core / Xray / Meow / Shoes),并实测代理可用性与延迟。

VProxy 控制台主界面

  • Windows:安装包(Inno Setup)+ 便携版(Scoop 一键安装)+ 系统代理一键控制 + TUN 虚拟网卡模式(带管理员提权)
  • Linux:通用免安装 AppImage、Debian/Ubuntu deb 与 Fedora/RHEL rpm 全套发布包支持,提供本地混合代理端口(默认 127.0.0.1:9980)
  • OpenWrt:提供原生 .ipk 服务包(x86_64 / aarch64_generic)与通用 LuCI Web 控制面板 (luci-app-vproxy),集成 procd 守护与 UCI 配置,超轻量无头微服务常驻路由器(~20MB 内存),详见 OpenWrt 部署指南
  • macOS:原生 DMG 拖拽安装包与便携归档(Apple Silicon 与 Intel 架构支持);Mihomo TUN 通过独立后台服务授权,节点与 TUN 仍由界面控制,详见 macOS TUN

功能

采集

  • 订阅 URL(支持 YYYY-MM-DD 日期占位符)
  • Gist 搜索页发现:把 gist raw 直接登记成订阅源
  • Telegram 频道:读 t.me/s/<频道> 网页预览,裸节点链接和订阅链接都取,节点只增不删

测速与健康

  • 先 TCP 预筛,再经内核访问 Google generate_204 计延迟,可选下载吞吐探测
  • 出口健康条按最近 24 小时实测画,不看进程状态挂绿勾
  • 出口切换记录落库留 90 天,按本地日分组,含"该切但没找到替补"

选路

  • 内核层:PROXY(select) → 自动选择(url-test) → 漏网之鱼,换节点不重读配置
  • 应用层:故障转移调度器(EWMA + 断路器 + 滞后 + 最小切换间隔)
  • 替补池空了可自动补一轮低并发全量测速(默认关)

分流规则

  • GEOSITE / GEOIP / 域名 / 端口 / 进程名等匹配器,规则可增删改
  • 每条规则实际命中多少连接单独一页显示
  • 导入 / 导出:吃 mihomo 规则文本、JSON 数组、Clash Verge 扩展脚本,解析后先给预览再落库

代理与内核

  • 系统代理、TUN(提权交接后只留一个实例)、终端 HTTP_PROXY 三条都管
  • 内核缺失时开下载窗口:ghfast / gh-proxy / 官方直连 / 走代理 / 本地导入,一次只走一条
  • 按 exe 路径加防火墙允许规则;单实例互斥;托盘

软件自身

  • 关于页在线更新,稳定与预发两个通道(默认只跟稳定版)
  • 界面全中文、5 套浅色主题、Ctrl+K 命令面板、85%~140% 整页缩放
  • 本地 HTTP API(默认 127.0.0.1:8080,强制 bearer 鉴权)
  • 导出 mihomo / sing-box / xray 配置

协议

解析:ss vmess vless trojan hysteria2/hy2 socks5 http(s),以及 Clash/Clash Meta YAML、Base64 与混合文本里的分享链接。 连接(取决于内核):以上再加 tuic wireguard。anytls ssr mieru openvpn sstp 存得下但连不上,界面上会标出来而不是静默丢弃。

运行与打包

直接运行与编译

cargo run --release                 # 直接跑
cargo build --release               # 编译 release 二进制

Windows 安装 (Scoop 一键安装)

# 无需添加 bucket,直接通过 GitHub Raw 安装并自动配置便携数据持久化
scoop install https://raw.githubusercontent.com/mateo-ki/vproxy/main/vproxy.json

# 后续升级
scoop update vproxy

Windows 安装包 (Inno Setup)

# 编译 Inno Setup 安装向导,产物输出至 dist/
"<Inno Setup>\ISCC.exe" installer/vproxy.iss

Linux 全套发行包 (AppImage / deb / rpm)

# 在 Linux / WSL 环境下一键生成全套 Linux 发布包并归档至 dist/
bash scripts/build_linux_packages.sh

# 或在 Windows 下调用 PowerShell 包装脚本自动化构建
powershell scripts/build_linux_packages.ps1

OpenWrt 原生安装包 (.ipk)

# 交叉编译无头静态版本(以 x86_64 或 aarch64_generic 为例)
cross build --release --no-default-features --target x86_64-unknown-linux-musl

# 使用轻量级打包脚本生成 OpenWrt .ipk
./packaging/openwrt/make_ipk.sh target/x86_64-unknown-linux-musl/release/vproxy x86_64 dist

数据都在程序目录的 data/ 下:主库 vproxy.db(订阅源、设置、遥测),节点按源分片存 data/subscriptions/*.db。

OpenWrt 部署与微服务联动

VProxy 原生支持 OpenWrt 路由器环境(X86 软路由及 ARM64 路由器),作为轻量级本地微服务运行(常驻私有工作集内存仅约 20MB ~ 30MB),自动为 OpenClash、PassWall、SSR-Plus 等插件提供纯净、低延迟、自动保活的优质节点池。

  • 快速安装:下载对应架构的 .ipk 与通用 LuCI 插件包,在路由器中执行 opkg install ./vproxy_*.ipk ./luci-app-vproxy_*.ipk;
  • 原生 LuCI 管理面板:安装后在路由器后台「服务」➔「VProxy」即可进行节点池监控、真握手测速、订阅增删与参数调优;
  • 配置与自启:配置文件为 /etc/config/vproxy,由 procd 守护(/etc/init.d/vproxy)支持异常崩溃 5 秒自愈复活;
  • 插件联动:在 OpenClash 订阅地址填入 http://127.0.0.1:8080/api/export/clash?quality_only=true&limit=60,即可自动拉取最高质量的实测可用节点;
  • 完整使用指南:详见 OpenWrt 部署与微服务联动指南。

上手

  1. 订阅源页加一条源(或跑一次 Gist / Telegram 发现),点拉取
  2. 节点池点一个节点作为出口 → 启动代理(没装内核会自动开下载窗口)
  3. 浏览器打不开境外时,先看表头那行实测健康,而不是看它有没有绿

已知边界

  • Windows TUN 提权执行用户目录内的内核;macOS Mihomo TUN 在管理员授权后安装并运行受保护的内核副本,其他 macOS 内核的 TUN 暂不支持
  • url-test 只看"到测试 URL 的 HTTP 延迟",不看带宽也不看落地 IP 信誉
  • 免费共享订阅失效极快,测通数量长期偏低是常态

免责声明

  1. 用途限制与合规性:本项目是一个基于 MIT 许可证开源的客户端网络调试与代理管理技术工具,仅供计算机网络原理学习、网络协议分析及科研教学使用。使用者在使用本项目时,必须严格遵守所在国家与地区的法律法规,严禁将本项目用于任何违反法律、行政法规或危害网络安全的行为。因违反法律法规使用本项目所产生的一切直接或间接法律责任及后果,均由使用者自行承担,本项目作者、贡献者及分发者概不承担任何连带责任。
  2. 服务免责:本项目自身不提供、不分发、不托管、亦不转售任何代理节点、网络线路、VPN 专线或跨境数据加速服务。软件内展示或使用到的所有节点、订阅链接及网络规则,均由使用者本人自行收集、添加及配置。
  3. 零遥测与数据隐私安全:本项目严格贯彻无遥测原则,代码中不包含任何后台统计、埋点追踪或数据收集上报模块。用户配置、订阅源地址、节点数据库、分流规则以及测速与切换记录均仅保存在用户本地设备的数据目录(data/)中,数据绝不上传云端,且卸载程序不会强制删除本地个人配置与数据库。
  4. 联网动作透明度:本软件在默认常规运行中的网络请求仅限于主动发起的“数据取回”:包括拉取用户添加的订阅源内容、检测本地公网出口 IP、向官方仓库检查并下载软件更新、下载开源代理内核与 GeoIP/GeoSite 规则库,以及进行分流可用性探测时的公共 DNS 域名解析。
  5. 用户主动触发的外发行为:除上述常规取回外,仅在以下两处需要用户明确主动配置或手动点击时,才会产生单次网络请求:① 用户主动配置并点击将测通节点发布至自建 Web 后台;② 用户主动点击发起 IP 风险与归属地画像检测(请求第三方权威接口 ipinfo.io、ip-api.com、ipwho.is 查询该 IP)。
  6. 第三方内核与规则免责:本项目调用的代理内核(VP-Core、Mihomo、sing-box、Xray、Meow、Shoes 等)与 Geo 规则数据库均为独立分发的开源项目,按各自开源许可证独立维护,其功能、安全性与网络稳定性完全由对应上游项目负责。软件界面所呈现的延迟、吞吐速率及健康度均为用户本机运行时的瞬时探测采样值,不构成对任何节点长期可用性、连接质量或稳定性的保证。

社区

本开源项目已链接并认可 LINUX DO 社区。

许可证

MIT License,条款见 LICENSE。第三方内核(mihomo / sing-box / xray)与 Geo 规则库按各自的许可证分发,本仓库只调用其可执行文件、不重新授权它们。

Dokumentationsspiegel archiviert aus dem offiziellen GitHub-Repository · GitHub-Repository aufrufen
Snapshot-Datum: 2026-11-08