ProxyNodeHub README

The project's README from github.com/wanvfx/ProxyNodeHub. As one markdown file: README.md.

ProxyNodeHub

GitHub 免费节点仓库监控与聚合工具

English | 中文

　　

软件主界面

⭐ 如果 ProxyNodeHub 对你有用，请务必点一个 Star，这是我持续维护这个项目最大的动力。

项目简介

ProxyNodeHub 用于发现 GitHub 上活跃的免费节点仓库：分析活跃度、去重分散的节点、直接给出可用的订阅链接。点一次「搜索并分析」，剩下的梳理工作全部由它完成。

不必再逐个仓库翻找、比对、手动拼接订阅。它会挑出更新最勤、维护最稳的仓库，合并去重后一次导出；也能翻出那些藏在角落、不易察觉的冷门仓库——在免费节点这个领域，冷门往往意味着负载低、活得久，那才是真正好用的宝藏节点。

功能特性
六层探测引擎 特征库学习 → 硬编码映射 → 文件树筛选 → 常见路径探测 → README 解析 → 兜底候选
并发搜索 8 个关键词并发请求 GitHub REST API
活跃度评分 提交频率 + 均匀度 + 自动化 + 隐蔽度，100 分制
节点去重 以 server:port 为键去重，合并导出订阅
四种处理模式 🚀 极速 / ⚖️ 标准 / 🔍 深度 / 🐢 兼容，各自独立并发度
自动代理 13 个加速镜像，自动测速、失效回退、5 分钟结果缓存
搜索历史过滤 已搜索仓库自动跳过（1–30 天可调）
收藏管理 独立视图，重启后保留
特征库学习 自动记住探测成功过的路径，下次更快
日志持久化 日志滚动保存，保留天数可调，一键清理

运行环境

快速开始

  1. 从 Releases 获取构建包——无任何前置依赖请选 ProxyNodeHub_v0.0.1_self-contained.zip。
  2. 解压到任意目录，运行 ProxyNodeHub.exe。
  3. 按 F5（或点击「搜索并分析」）开始搜索与分析。

GitHub 秘钥为可选项，但建议填写：匿名搜索 API 每小时限额 60 次，填入后可提升至 5000 次。秘钥经 Windows 凭据管理器按用户加密存储。

编译

# 自包含版（单文件，约 68 MB，内含运行时）
dotnet publish src/ProxyNodeHub.csproj -c Release -r win-x64 -p:SelfContained=true -o dist/self-contained

# 框架依赖版（约 3 MB，需目标机安装 .NET 8 运行时）
dotnet publish src/ProxyNodeHub.csproj -c Release -r win-x64 -p:SelfContained=false -o dist/framework-dependent

需要 .NET 8 SDK 及 Windows Desktop 工作负载。

关于体积：自包含版无法裁剪。WinForms 不支持 PublishTrimmed（NETSDK1175），因此约 65 MB 是 .NET 8 WinForms 单文件发布的下限。

快捷键

快捷键 功能
F5 开始 / 取消搜索
Ctrl+C 复制最佳订阅链接
Ctrl+L 切换详情面板
Ctrl+D 切换收藏夹
Ctrl+F 聚焦筛选框
Esc 关闭弹窗

配置说明

工具学到的所有状态都放在可执行文件之外，位于 %AppData%\ProxyNodeHub\：

文件 / 路径 用途
known_repos.json 随 EXE 一起分发——已知仓库到订阅路径的映射
searched_repos.json 搜索历史，按条目设置过期时间
log.txt 日志滚动保存，启动时按保留天数清理
特征库 JSON 探测成功过的路径，供 L1 层复用

项目结构

src/
├── Program.cs               # 入口点
├── MainForm.cs              # 主窗体、工具栏、表格、日志面板
├── SubscriptionFinder.cs    # 六层探测引擎
├── GitHubService.cs         # GitHub HTTP + 代理镜像 + 测速
├── FeatureLibrary.cs        # 特征库 + 仓库分类器
├── CustomFeatureLibrary.cs  # 自定义特征码
├── NodeParser.cs            # 节点解析 / 去重 / 合并
├── KnownRepoLoader.cs       # known_repos.json 加载器
├── SearchHistory.cs         # 搜索历史持久化
├── LogStore.cs              # 日志持久化 + 保留天数
├── Settings.cs              # 设置、缓存、收藏
├── Models.cs                # 数据模型
├── Theme.cs                 # 颜色令牌
├── Fonts.cs                 # 字体系统
├── ModernButton.cs          # 按钮控件
├── BufferedGridView.cs      # 双缓冲表格
├── Win32Interop.cs          # Win32 互操作
├── LanguageFilter.cs        # 语言过滤
├── ExportDialog.cs          # 导出对话框
├── FeatureLibraryDialog.cs  # 特征库管理
├── AboutDialog.cs           # 关于对话框
├── ProxyNodeHub.csproj
├── known_repos.json         # 已知仓库映射
└── logo.ico / logo.png      # 应用图标

技术栈

作者

Zoyaya — github.com/wanvfx

许可协议

基于 MIT License 发布。

ProxyNodeHub (wanvfx/ProxyNodeHub)

Searching Database…

464 ·GitHub
ProxyNodeHub
这是什么？ProxyNodeHub 是一个 Windows 桌面工具，扫描 GitHub 上活跃的免费代理节点仓库，为它们的活跃度打分，对找到的节点去重，并一键输出可直接使用的订阅链接。
这是命令行工具，还是图形界面桌面应用？它是一个用 C# WinForms 基于 .NET 8 构建的 Windows 桌面图形应用，不是命令行工具，也不是网络服务。
怎么让它跑起来？从 Releases 页面下载一个版本——没装 .NET 就选自包含 .zip，否则选依赖框架版——解压到任意位置，运行 ProxyNodeHub.exe，然后按 F5（或点击“搜索并分析”）开始。
需要装 .NET，或者要 GitHub API 密钥吗？自包含版不需要额外安装，依赖框架版在 Windows 10+ x64 上需要 .NET 8 Desktop Runtime。GitHub 令牌可选但推荐，因为它能把搜索 API 限额从每小时 60 次提高到 5000 次。
安装上有什么我应该知道的坑吗？自包含版无法裁剪体积，因为 WinForms 不支持 PublishTrimmed，所以它保持在 65MB 左右；应用仅支持 Windows（x64），没有 macOS 或 Linux 版本。
我的 GitHub 令牌存在哪里？如果你输入了 GitHub 令牌，它会经过加密，通过 Windows 凭据管理器按用户存储，而不是明文保存。
活跃度评分是怎么算的？每个候选仓库按 100 分制评分，综合提交频率、提交均匀度、自动化痕迹，以及仓库有多“隐蔽”（低流量），偏向安静维护的仓库——这类仓库的节点通常没那么过载。
节点去重是怎么做的？从不同仓库抓来的节点在合并进最终导出的订阅链接之前，以“server:port”为键去重。
四种处理模式是什么？可以在 Fast、Standard、Deep 和 Compatible 四种模式中选择，每种以各自的搜索并发级别运行。
六层检测引擎是怎么找到订阅链接的？它依次经过特征库学习、硬编码路径映射、文件树过滤、常见路径探测、README 解析和后备候选列表，在仓库里定位可用的订阅文件。
What are similar projects?quiver-launcher, netch, IntentRoute-AI, BibaYanji, CircuitLordVRModInstaller, douyin-favorite-MyLike, SteamTools, RunCat365
Which topics is it in?deduplication, github-api, subscription, cache, logging, censorship-circumvention, dotnet, c#, csharp, github, windows-app, proxy
Creator
wanvfx
Size
3 MB
Stars
464
Updated
CommitOct 08Release20261005Oct 05
Age
18d
Commits · 90 Days