subHub

公共订阅与配置源聚合入口。项目会把多个公开来源规范化、去重并生成可直接使用的订阅/配置文件。

当前第一类输出是 TVBox 配置；后续可以继续扩展到 IPTV、代理订阅、其它客户端配置等类型。

当前可用输出

TVBox

推荐使用 GitHub Pages 固定入口，客户只需要填写一次。Pages 启用后地址为：

https://sakurabytecore.github.io/subHub/tvbox.json

如果该地址暂时返回 404，说明仓库 Pages 还未在 Settings 中启用；本仓库已经提交 GitHub Actions 部署配置和 gh-pages 备用分支。

CDN 备用链接：

https://cdn.jsdelivr.net/gh/SakuraByteCore/subHub@refs/heads/main/tvbox.json
https://fastly.jsdelivr.net/gh/SakuraByteCore/subHub@refs/heads/main/tvbox.json
https://gcore.jsdelivr.net/gh/SakuraByteCore/subHub@refs/heads/main/tvbox.json
https://raw.githubusercontent.com/SakuraByteCore/subHub/main/tvbox.json

当前内容

当前生成结果见 manifest.json。截至最近一次生成：

• TVBox 站点源：206 个
• TVBox 直播源：10 个
• TVBox 解析接口：29 个
• TVBox 规则：20 条
• 首个站点：drpy_js_豆瓣，显示名覆盖为 subHub | 搜索入口，用于兼容客户端已记住的旧 key。

当前来源

来源配置见 sources.json：

• qist (tvbox): https://qist.wyfc.qzz.io/jsm.json
• jinenge (tvbox): https://jinenge.us.kg/app/tvbox/tvbox.json

使用方法

1. 复制上面的对应输出链接。
2. 打开支持该配置类型的客户端。
3. 在配置/接口/订阅地址处粘贴链接。
4. 保存并刷新。

TVBox 合并规则

• drpy_js_豆瓣 保持原 key 不变，显示名覆盖为 subHub | 搜索入口，避免客户端记住旧 key 后继续显示旧标题。
• sites: 优先按 key 去重；同 key 但内容不同会给后加入的源加来源前缀，尽量保留两边内容。
• lives: 按 name + url 去重。
• parses、rules、doh: 按 name 去重；冲突时保留高优先级来源，低优先级来源自动改名保留。
• hosts、flags、ads: 按字符串集合去重。
• 相对路径会按原始订阅 URL 转换成绝对 URL，避免合并后 ./jar/...、./lib/... 这类路径失效。
• 顶层 spider 默认使用优先级最高来源；其它来源依赖的 spider 会尽量作为站点级 jar 写入，兼容性取决于客户端实现。

自动更新

GitHub Actions 会定时运行 scripts/build_tvbox.py，重新抓取 TVBox 来源并生成：

• tvbox.json: TVBox 可直接使用的订阅配置
• manifest.json: 本次生成的来源状态和合并统计

也可以本地手动执行：

python3 scripts/build_tvbox.py

添加来源

编辑 sources.json，新增一条来源记录：

{
  "id": "example",
  "name": "Example",
  "type": "tvbox",
  "url": "https://example.com/tvbox.json",
  "priority": 30,
  "enabled": true,
  "note": "Optional note"
}

然后运行：

python3 scripts/build_tvbox.py

确认输出文件正常生成后提交即可。

后续扩展方向

当前仓库没有把边界锁死在 TVBox。后续可以按类型增加新的生成器和输出文件，例如：

• dist/iptv.m3u
• dist/mihomo.yaml
• dist/sing-box.json
• dist/tvbox.json

根目录的 tvbox.json 会先保留，避免破坏已经在用的订阅地址。

说明

本仓库只做订阅聚合与格式整理，来源内容归原作者所有。若某来源不允许公开转载或继续聚合，请联系维护者移除。