sinspired/subs-check-pro repository overview

⁠Subs-Check⁺ PRO

High-performance proxy subscription checker.

⁠🚀 网络代理质量检测工具

测活、测速、媒体解锁，网络质量检测工具。采用全新设计，适配 PC 和手机设备的现代 WebUI 配置管理界面，自动生成 mihomo 和 sing-box 订阅，集成 sub-store 前端和后端，支持一键复制分享，可在高并发运行时保持低内存占用；支持自动无缝版本更新。

同时也提供了基于 Wails v3 现代化框架开发的跨平台本地图形界面客户端 subs-free⁠，已支持 Android 手机 和 Windows Linux Mac。

⁠✨ 特性

• ⚡ 自适应流水线高并发模式⁠
• 🗺️ 增强位置标签⁠
• 🎲 智能节点乱序⁠
• 🕒 保存并加载历次可用节点⁠
• 📊 统计订阅链接总数、可用节点数量、成功率⁠
• 🚦 自动检测本地代理环境⁠
• 🎁 自动检查更新，无缝升级新版本⁠
• 📦 自动生成开箱即用的 sing-box 配置⁠
• 🔒 优化文件分享，支持分享码⁠
• 📣 消息通知：节点状态/版本更新/GeoDB 更新⁠
• 🔋 优化内存占用⁠
• ♾️ 支持检测百万-千万量级的节点库，依然保持较低的内存占用
• 💻 支持 Windows Linux macOS 多平台部署
• 📱 支持 Android 手机 APP
• 🐳 支持 docker 部署
• 🖥️ 全新跨平台现代桌面客户端：可搭配基于 Wails v3 开发的 subs-free⁠ 完美实现本地图形化免命令操控（支持 Windows, macOS, Linux）
• 📱 全新设计的 WebUI 管理界面，优化小屏设备访问体验
• ✏️ 升级配置编辑器，支持自动补全与高亮，内置预览与配置分析，GUI 式编辑
• 🧩 集成 sub-store 前端，WebUI 一键管理
• 6️⃣ 支持 IPv6 代理节点
• 🔗 适配多种非标订阅格式，提高获取订阅成功率
• 📡 支持检测 isp 类型、原生/广播IP、住宅/机房
• 📂 内置文件管理页面（/files），方便查看与下载生成文件
• 📈 检测结果分析报告（/analysis），含地理位置与协议分布可视化
• 🚧 本项目现接受 issue 反馈

⁠📖 教程（Wiki）

• 🐳 Docker 部署⁠
• 🔁 WatchTower 自动更新与通知⁠
• 📘 Cloudflare Tunnel 外网访问⁠
• 📗 通知渠道配置（Apprise）⁠
• 📙 订阅使用方法⁠
• 📕 内置文件服务⁠
• 📖 自建GitHub代理（支持提高api速率和gist加速）⁠

⁠📣 使用交流，功能讨论，issue 反馈，新版本通知

• Telegram 群组：subs-check性能版⁠⁠

• Telegram 频道：关注频道⁠⁠

⁠📸 预览

⁠✨ 现代 WebUI 管理界面

http://localhost:8199/admin

⁠🖥️ subs-free⁠ 跨平台客户端

已支持 Android 手机 和 Windows Linux Mac。

⁠💻 桌面端

⁠📱 手机 APP

正常版	Lite 版

➡️ 立即前往体验：subs-free 仓库⁠

⁠📊 检测结果分析报告

http://localhost:8199/analysis

⁠⚡ 自动生成 singbox 订阅，支持一键分享

⁠🛠️ 快速开始

⁠💻 桌面端 UI 运行（推荐）

直接前往 subs-free⁠ 下载适配你当前系统（Windows / macOS / Linux）的安装包，开箱即用，无须配置复杂的命令行参数。

⁠🌏 WebUI 控制面板

WebUI 集成了配置编辑、订阅分享、订阅管理，内置文件服务，检测结果分析报告，日志查看等功能，请务必使用 WebUI 作为主要管理入口

请主动修改 config.yaml api-key 作为 WebUI 访问密码，如未设置，请查看终端日志获取 api-key

浏览器输入 http://localhost:8199/admin 或 http://127.0.0.1:8199/admin 访问 WebUI

注意 8199 为默认监听端口，如已修改，请替换为实际端口

⁠📦 二进制文件运行

下载 Releases 中适合的版本，解压后直接运行：

./subs-check-pro.exe -f ./config/config.yaml

记录 api-key，访问 WebUi

http://localhost:8199/admin

⁠🐳 Docker 运行（最简）

docker run -d \
  --name subs-check-pro \
  -p 8299:8299 \
  -p 8199:8199 \
  -v ./config:/app/config \
  -v ./output:/app/output \
  --restart always \
  ghcr.io/sinspired/subs-check-pro:latest

💡 记录 api-key，访问 WebUi

http://localhost:8199/admin

⁠🪜 优化系统代理和 GitHub 代理设置（可选）

可使用网上公开的github proxy 或使用 GitHub 项目 CF-Proxy⁠ 自建 GitHub 代理

# 优先级 1.system-proxy;2.github-proxy;3.ghproxy-group
# 即使未设置,也会检测常见端口(v2ray\clash)的系统代理自动设置

# 系统代理设置: 适用于拉取订阅、消息推送、文件上传等等。
# 写法跟环境变量一样，修改需重启生效
# system-proxy: "http://username:[email protected]:7890"
# system-proxy: "socks5://username:[email protected]:7890"
system-proxy: ''
# Github 代理：获取订阅使用
# github-proxy: "https://ghfast.top/"
github-proxy: ''
# GitHub 代理列表：程序会自动筛选可用的 GitHub 代理
ghproxy-group:
# - https://ghp.yeye.f5.si/
# - https://git.llvho.com/
# - https://hub.885666.xyz/
# - https://p.jackyu.cn/
# - https://github.cnxiaobai.com/

# HTTP 代理示例
export HTTP_PROXY=http://username:[email protected]:7890
export HTTPS_PROXY=http://username:[email protected]:7890

# SOCKS5 代理示例
export HTTP_PROXY=socks5://username:[email protected]:7890
export HTTPS_PROXY=socks5://username:[email protected]:7890

# SOCKS5H 代理示例
export HTTP_PROXY=socks5h://username:[email protected]:7890
export HTTPS_PROXY=socks5h://username:[email protected]:7890

# Github Proxy，获取订阅使用，结尾要带的 /
# github-proxy: "https://ghfast.top/"
github-proxy: 'https://proxy.custom-domain/'

⁠🌐 自建测速地址（可选）

# 100MB
speed-test-url: https://custom-domain/speedtest?bytes=104857600
# 1GB
speed-test-url: https://custom-domain/speedtest?bytes=1073741824

⁠⚙️ Cloudflare Tunnel 外网访问

完整配置请见 Wiki：Cloudflare Tunnel⁠

⁠🔔 通知渠道配置

完整文档请见 Wiki：通知渠道⁠

⁠🌍 域名相关

⁠💾 保存方法

见 Wiki：保存方法⁠

⁠📲 订阅使用方法

完整文档请见 Wiki：订阅使用方法⁠

⁠🌐 内置文件服务

完整文档请见 Wiki：内置文件服务⁠

⁠📱 安卓手机命令行运行

完整文档请见 Wiki：安卓手机命令行运行⁠

⁠✨ 新增功能与性能优化详情

完整说明请见 Wiki：新增功能与性能优化详情⁠

⁠🤝 贡献与开发

• 欢迎提交 PR 与 Issue，一起完善项目。

git clone https://github.com/sinspired/subs-check-pro
cd subs-check-pro

⁠🙏 鸣谢

beck-8⁠、Sub-Store⁠、bestruirui⁠

⁠⚖️ 免责声明

本工具仅供学习和研究使用，不鼓励或支持任何非法活动。使用者应自行承担风险并遵守相关法律法规。