High-performance proxy subscription checker.
测活、测速、媒体解锁，网络质量检测工具。采用全新设计，适配 PC 和手机设备的现代 WebUI 配置管理界面，自动生成 mihomo 和 singbox 订阅，集成 sub-store 前端和后端，支持一键复制分享，可在高并发运行时保持低内存占用；支持自动无缝版本更新。
同时也提供了基于 Wails v3 现代化框架开发的跨平台本地图形界面客户端 subs-check-pro-gui。
- ⚡ 自适应流水线高并发模式
- 🗺️ 增强位置标签
- 🎲 智能节点乱序
- 🕒 保存并加载历次可用节点
- 📊 统计订阅链接总数、可用节点数量、成功率
- 🚦 自动检测本地代理环境
- 🎁 自动检查更新，无缝升级新版本
- 📦 自动生成开箱即用的 sing-box 配置
- 🔒 优化文件分享，支持分享码
- 📣 消息通知：节点状态/版本更新/GeoDB 更新
- 🔋 优化内存占用
- ♾️ 支持检测百万-千万量级的节点库，依然保持较低的内存占用
- 💻 支持
WindowsLinuxmacOS多平台部署 - 🐳 支持
docker部署 - 🖥️ 全新跨平台现代桌面客户端：可搭配基于 Wails v3 开发的 subs-check-pro-gui 完美实现本地图形化免命令操控（支持 Windows, macOS, Linux）
- 📱 全新设计的 WebUI 管理界面，优化小屏设备访问体验
- ✏️ 升级配置编辑器，支持自动补全与高亮，内置预览与配置分析，GUI 式编辑
- 🧩 集成
sub-store前端，WebUI 一键管理 - 6️⃣ 支持
IPv6代理节点 - 🔗 适配多种非标订阅格式，提高获取订阅成功率
- 📡 支持检测
isp类型、原生/广播IP、住宅/机房 - 📂 内置文件管理页面（
/files），方便查看与下载生成文件 - 📈 检测结果分析报告（
/analysis），含地理位置与协议分布可视化 - 🚧 本项目现接受 issue 反馈
- 🐳 Docker 部署
- 🔁 WatchTower 自动更新与通知
- 📘 Cloudflare Tunnel 外网访问
- 📗 通知渠道配置（Apprise）
- 📙 订阅使用方法
- 📕 内置文件服务
- 📖 自建GitHub代理（支持提高api速率和gist加速）
-
Telegram 群组：subs-check性能版
-
Telegram 频道：关注频道
Tip
功能更新频繁，请务必查看最新的 配置文件示例 以获取最新功能支持。
Note
查看新增功能及设置方法： 新增功能与性能优化详情
http://localhost:8199/admin
如果你更喜欢原生的桌面应用程序，可以使用全新开发的客户端。它拥有完美的跨平台系统级适配、更低的系统资源开销以及极度现代化的精致 GUI 交互界面。
➡️ 立即前往体验：subs-check-pro-gui 仓库
http://localhost:8199/analysis
 |
 |
 |
 |
 |
首次运行会在当前目录生成默认配置文件。完整安装与部署见 Wiki： 安装与部署
直接前往 subs-check-pro-gui 下载适配你当前系统（Windows / macOS / Linux）的安装包，开箱即用，无须配置复杂的命令行参数。
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 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
代理设置见 Wiki：系统与 GitHub 代理
自建测速地址：Speedtest
可使用网上公开的github proxy 或使用 GitHub 项目 CF-Proxy 自建 GitHub 代理
展开查看
# 优先级 1.system-proxy;2.github-proxy;3.ghproxy-group
# 即使未设置,也会检测常见端口(v2ray\clash)的系统代理自动设置
# 系统代理设置: 适用于拉取订阅、消息推送、文件上传等等。
# 写法跟环境变量一样，修改需重启生效
# system-proxy: "http://username:password@192.168.1.1:7890"
# system-proxy: "socks5://username:password@192.168.1.1: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/如果拉取非Github订阅速度慢，可使用通用的 HTTP_PROXY HTTPS_PROXY 环境变量加快速度；此变量不会影响节点测试速度
# HTTP 代理示例
export HTTP_PROXY=http://username:password@192.168.1.1:7890
export HTTPS_PROXY=http://username:password@192.168.1.1:7890
# SOCKS5 代理示例
export HTTP_PROXY=socks5://username:password@192.168.1.1:7890
export HTTPS_PROXY=socks5://username:password@192.168.1.1:7890
# SOCKS5H 代理示例
export HTTP_PROXY=socks5h://username:password@192.168.1.1:7890
export HTTPS_PROXY=socks5h://username:password@192.168.1.1:7890如果想加速github的链接，可使用网上公开的github proxy
可使用 GitHub 项目 CF-Proxy 自建 GitHub 代理，可直接复制 worker.js 到 Cloudflare 的 workers。
# Github Proxy，获取订阅使用，结尾要带的 /
# github-proxy: "https://ghfast.top/"
github-proxy: "https://proxy.custom-domain/"展开查看
⚠️ 注意： 避免使用 Speedtest 或 Cloudflare 下载链接，因为部分节点会屏蔽测速网站。
- 将 worker.js 部署到 Cloudflare Workers。
- 绑定自定义域名（避免被节点屏蔽）。
- 在配置文件中设置
speed-test-url为你的 Workers 地址。 - 建议使用
speed-test-url: random使用随机测速地址，避免对单个测速源造成负担。
# 100MB
speed-test-url: https://custom-domain/speedtest?bytes=104857600
# 1GB
speed-test-url: https://custom-domain/speedtest?bytes=1073741824完整配置请见 Wiki：Cloudflare Tunnel
完整文档请见 Wiki：通知渠道
见 Wiki：保存方法
完整文档请见 Wiki：订阅使用方法
完整文档请见 Wiki：内置文件服务
完整说明请见 Wiki：新增功能与性能优化详情
- 欢迎提交 PR 与 Issue，一起完善项目。
git clone https://github.com/sinspired/subs-check-pro
cd subs-check-pro
本工具仅供学习和研究使用，不鼓励或支持任何非法活动。使用者应自行承担风险并遵守相关法律法规。