KJGX66F/FreeNodePanel

选用指南

AI 根据 README 整理 · 2026/11/3 23:11:55

适用场景

适合需要临时、轻量使用公共免费节点的场景，每次启动自动更新节点，生成订阅供v2rayN或Clash客户端使用。

查看 README 依据

# 免费公益节点面板（FreeNodePanel） 一个为纯小白设计的 Windows / 安卓一键节点工具：**下载、打开、复制订阅**，三步搞定。 它在本地聚合多个公开免费节点源（免费公益节点池 + 4 个外部公共源 + 你自己添加的自定义源），自动测活、去重，生成一份同时兼容 **v2rayN / v2rayNG** 与 **Clash 系（Clash Verge / FlClash / mihomo）** 的订阅。没有任何安装步骤，没有黑窗口，界面就是一个自动打开的本地网页（安卓版直接在 App 里打开）。 > 📢 **本项目免费开源，仅供学习测试，严禁商用。** 任何收费分发、捆绑销售、集成进营利产品/服务、收费代部署等行为都不被允许，详见 [许可证](LICENSE)。 > 免费节点寿命普遍只有几小时到几天。本工具的思路是：**每次打开自动更新一遍**，用最新的一批，而不是指望某批节点长期可用。 ## 界面预览  面板本体就是双击后自动打开的这个本地网页：订阅地址默认打码、节点总览、外部源状态一屏看完；右下角是托盘图标的右键菜单（打开面板 / 立即刷新 / 退出后台）。 ## 功能特性 - **零安装、零窗口**：单个 EXE（约 8 MB），双击不弹任何控制台窗口，浏览器自动打开操作面板

- 不要用公共节点登录重要账号（银行、支付、主邮箱、社交主号），不要传输敏感文件；节点运营者理论上能看到未加密的流量 - 遇到证书警告不要点「继续访问」；警惕节点推送的广告、假更新和假下载提示 - 重要账号开启两步验证；公共节点和付费/自建服务分开放在不同订阅里，不要混用 - 重要场合（会议、考试、支付）请预备可靠的自有服务，公共节点只适合临时、轻量用途 - 请遵守所在地法律法规，以及公司 / 学校网络的管理规定 ## 常见问题 **v2rayN 里很多节点测出来是 -1？** 正常。面板测活只是粗筛（能连接、能握手），v2rayN 的真实延迟测试走完整协议栈严格得多；再加上节点自然过期，一批里真正好用的通常就十几个。用法：更新订阅时勾选「移除现存服务器」，测速后按延迟排序，删掉 -1 的用前面的。 **Clash Verge 更新订阅报 502 / 拉取失败？** 十有八九是 Verge 里存的订阅地址已过期：如果你重置过密钥、或把 EXE 换到新文件夹运行过（会生成新密钥），旧地址会被面板拒绝（403），而 Verge 会把这个失败包装成代理 502 显示。把面板当前地址重新复制粘贴到 Verge 即可；面板地址可在浏览器打开验证——显示乱码文本 = 地址有效，显示「订阅地址无效」= 需要换新地址。实在不行，用面板的「下载 Clash 配置文件」本地导入。

目标用户

面向纯小白用户，提供一键式操作，无需安装步骤。

查看 README 依据

# 免费公益节点面板（FreeNodePanel） 一个为纯小白设计的 Windows / 安卓一键节点工具：**下载、打开、复制订阅**，三步搞定。 它在本地聚合多个公开免费节点源（免费公益节点池 + 4 个外部公共源 + 你自己添加的自定义源），自动测活、去重，生成一份同时兼容 **v2rayN / v2rayNG** 与 **Clash 系（Clash Verge / FlClash / mihomo）** 的订阅。没有任何安装步骤，没有黑窗口，界面就是一个自动打开的本地网页（安卓版直接在 App 里打开）。 > 📢 **本项目免费开源，仅供学习测试，严禁商用。** 任何收费分发、捆绑销售、集成进营利产品/服务、收费代部署等行为都不被允许，详见 [许可证](LICENSE)。 > 免费节点寿命普遍只有几小时到几天。本工具的思路是：**每次打开自动更新一遍**，用最新的一批，而不是指望某批节点长期可用。 ## 界面预览  面板本体就是双击后自动打开的这个本地网页：订阅地址默认打码、节点总览、外部源状态一屏看完；右下角是托盘图标的右键菜单（打开面板 / 立即刷新 / 退出后台）。 ## 功能特性 - **零安装、零窗口**：单个 EXE（约 8 MB），双击不弹任何控制台窗口，浏览器自动打开操作面板

使用方式

Windows版双击EXE自动打开本地网页面板，安卓版安装APK后在App内使用面板，通过复制订阅地址导入客户端。

查看 README 依据

- **安卓版同等功能**：同一套 Go 服务跑在手机本机，App 内直接打开面板；前台服务 + 常驻通知保活（通知在 = 服务在，类比电脑版托盘图标），订阅由同机的 v2rayNG / FlClash 直接拉 `127.0.0.1`；面板的一键导入按钮在 App 里自动变成「⚡ 一键导入 FlClash」 ## 快速开始（小白三步） 每次 Release 含两个资产：`FreeNodePanel-Windows.zip`（Windows 版）和 `FreeNodePanel-Android.apk`（安卓版），按设备二选一。 **Windows 版** 1. 到 [Releases](../../releases) 下载 `FreeNodePanel-Windows.zip`，解压 2. 双击 `免费公益节点面板.exe`（首次被 SmartScreen 拦截时点「更多信息 → 仍要运行」），等浏览器自动打开面板、顶部进度条走完 3. 点面板上的「复制订阅地址」： - **v2rayN**：订阅分组 → 添加订阅 → 粘贴 → 更新订阅 - **Clash Verge**：订阅页粘贴地址导入；若更新报错，先看下面常见问题，或改用面板的「⬇ 下载 Clash 配置文件」本地导入

部署要求

Windows版需Windows系统，安卓版需arm64机型；从源码构建需Go 1.23或更高版本，安卓APK构建需JDK 17和Android SDK。

查看 README 依据

> ⚠️ **从 v0.1.x 原型版（测试包）升级到正式版是例外**：正式版换用了正式发布签名，与原型版的测试签名不同，安卓不允许不同签名覆盖安装——请**先卸载原型版、再装正式版**（仅此一次，以后正式版之间都能直接覆盖）。卸载会清掉原型版数据，装好正式版后到面板**重新复制一次订阅地址**到 FlClash / v2rayNG 即可。 ## 从源码构建 需要 Go 1.23 或更高版本，无其他依赖（仅 `gopkg.in/yaml.v3`）。 ```powershell # Windows（或直接双击 build.bat） $env:CGO_ENABLED = "0" go build -trimpath -ldflags "-s -w -H windowsgui" -o "免费公益节点面板.exe" . ``` ```bash # Linux / macOS 交叉构建 Windows 版（或直接 ./build.sh） CGO_ENABLED=0 GOOS=windows GOARCH=amd64 \ go build -trimpath -ldflags "-s -w -H windowsgui" -o "免费公益节点面板.exe" . ``` 直接 `go run .` 也可以在本机调试运行（非 Windows 平台没有托盘，其余功能一致）。

### 安卓 APK 需要 JDK 17、Android SDK（build-tools + platform）和 Go，然后： ```bash cd android-app && ./build.sh # 产物：android-app/build/FreeNodePanel-android.apk ``` 打包是纯 build-tools 手工管线（aapt2 / javac / d8 / apksigner），无 Gradle 依赖。工具链按环境变量定位（`JAVA_HOME`、`ANDROID_SDK_ROOT` / `ANDROID_HOME`、`GOROOT` 或 PATH），GitHub Actions 的 Release 流水线也是走同一脚本构建 APK 的。 > 说明：正式版 APK 的签名钥匙**不在仓库里**。本地构建请通过环境变量提供（`KEYSTORE_FILE`、`KEYSTORE_PASS`、`KEY_PASS`、`KEY_ALIAS`，见 `build.sh` 注释）；Release 流水线从仓库 Secrets 解码钥匙、在 runner 临时目录里签名，密码全程不回显。这样每次发布构建出的 APK 签名一致，升级时才能直接覆盖安装、不丢订阅数据。 ## 工作原理

已知限制

免费节点寿命短，仅适合临时轻量用途；公共节点不适合登录重要账号或传输敏感文件；未购买代码签名证书，首次运行可能触发SmartScreen提示。

查看 README 依据

- 不要用公共节点登录重要账号（银行、支付、主邮箱、社交主号），不要传输敏感文件；节点运营者理论上能看到未加密的流量 - 遇到证书警告不要点「继续访问」；警惕节点推送的广告、假更新和假下载提示 - 重要账号开启两步验证；公共节点和付费/自建服务分开放在不同订阅里，不要混用 - 重要场合（会议、考试、支付）请预备可靠的自有服务，公共节点只适合临时、轻量用途 - 请遵守所在地法律法规，以及公司 / 学校网络的管理规定 ## 常见问题 **v2rayN 里很多节点测出来是 -1？** 正常。面板测活只是粗筛（能连接、能握手），v2rayN 的真实延迟测试走完整协议栈严格得多；再加上节点自然过期，一批里真正好用的通常就十几个。用法：更新订阅时勾选「移除现存服务器」，测速后按延迟排序，删掉 -1 的用前面的。 **Clash Verge 更新订阅报 502 / 拉取失败？** 十有八九是 Verge 里存的订阅地址已过期：如果你重置过密钥、或把 EXE 换到新文件夹运行过（会生成新密钥），旧地址会被面板拒绝（403），而 Verge 会把这个失败包装成代理 502 显示。把面板当前地址重新复制粘贴到 Verge 即可；面板地址可在浏览器打开验证——显示乱码文本 = 地址有效，显示「订阅地址无效」= 需要换新地址。实在不行，用面板的「下载 Clash 配置文件」本地导入。

**关掉面板网页，订阅还能更新吗？** 能。网页只是遥控器，后台独立运行并每 3 小时自刷新。彻底停止用面板的「退出后台」按钮、托盘右键菜单或 `停止后台.bat`。电脑关机 / 重启后后台不会自启，重新双击 EXE 即可。 **手机能用吗？** 能，用安卓版：从 Releases 下载 `FreeNodePanel-Android.apk` 装到手机上，服务和电脑版一样跑在手机本机（`127.0.0.1` 是每台设备各自的本机地址，所以电脑的订阅地址没法直接给手机用，必须在手机上跑一份）。步骤见上面「快速开始 · 安卓版」。 **杀毒软件 / SmartScreen 报警？** 本程序未购买代码签名证书，未签名的单文件程序首次运行出现 SmartScreen 提示是普遍现象。介意的话可以从源码自行构建，代码全部在本仓库。 ## 免责声明 本项目仅供学习与技术研究。节点内容均来自上述公开网络渠道，本项目不生产、不存储、不控制任何节点，不对其可用性、速度与安全性作任何担保。使用本项目请遵守您所在地区的法律法规，由此产生的一切后果由使用者自行承担。 ## 许可证