共计 1848 个字符，预计需要花费 5 分钟才能阅读完成。
✏️写在前面：
用过 TVBox 的人大概都经历过换源的烦恼。今天分享一个开源项目，能彻底解决这个问题——多源自动聚合，一个地址永久可用。
事情是这样的。
用过 TVBox 的人大概都经历过这个循环：找到一个源，用了几天挺好，突然加载不出来，再去群里问、论坛翻帖子找新源，然后重复。
安装不难，配置不难，难的是持续有一个能用的源。
我一直在想，有没有一种方法能彻底解决这个问题？
最近发现了一个开源项目，思路很妙：既然单一源注定不稳定，那就同时用多个源，自动合并成一个。
🌿 01. 源为什么会失效
很多人觉得源失效是运气问题，但如果你看一下本质，会发现失效几乎是必然的。
每个源背后都有服务器在跑，域名、带宽、算力都要钱。多数源由个人维护，没有收入支撑，弃坑是迟早的事。再加上域名被污染、IP 被封、CDN 被限制，防不胜防。
一个源能稳定跑三个月以上，已经算是很幸运了。大多数免费源的生命周期在几周到两三个月之间。
🌿 02. 换个思路
既然单一源注定不稳定，那解决方案就不应该是”找到一个更好的源”，而是同时用多个源，自动合并成一个。
多个配置源 → 自动抓取 + 测速 + 筛选 → 站点级去重 + 智能合并 → 输出一个稳定的聚合地址
你在 TVBox 里只需要填这一个地址。背后的源哪个挂了、哪个新加了、哪个变慢了，全部自动处理。
对你来说，体验上的变化是：填一次地址，不用再管了。
🌿 03. 这个项目是什么
TVBox Source Aggregator，一个开源的 TVBox 源聚合工具。
| 💡 核心功能：
✅ 多源聚合：添加多个 TVBox 配置 JSON 地址，自动合并为一个 ✅ 站点去重：不同源中的相同站点只保留一份 ✅ Spider JAR 智能分配：自动处理 type:3 站点的 JAR 依赖冲突 ✅ 测速筛选：自动过滤不可达或高延迟的源 ✅ 管理后台：网页端添加/删除源，触发刷新 ✅ 定时更新：每天自动重新聚合，客户端无感知 ✅ 容错设计：聚合失败时保留上次有效缓存 |
🌿 04. 三种部署方式
作者提供了三种部署方式，你可以根据自己的情况选择：
Docker 部署（推荐）——最简单的部署方式，适合有服务器或 NAS 的用户。
|
完成。访问 http://你的IP:5678/admin 管理源。
一键脚本——适合没有 Docker 但有电脑的用户。Mac 用户双击 start.command，Windows 用户双击 start.bat，首次启动会自动检查环境、安装依赖、引导配置。
Cloudflare Worker——免费，不需要自己的服务器。适合有 Cloudflare 账号的用户，可以从外网访问。
🌿 05. 怎么用
部署完成后，你会得到一个专属地址和管理后台：
📍 专属后台地址
🔧 管理后台界面
打开管理后台 http://你的地址/admin，输入密码登录。
把你手上的 TVBox 配置 JSON 地址粘贴进去，点击 Add。多加几个，系统会自动去重合并。
点击 Refresh 触发一次聚合，等十几秒，访问首页确认配置已生成。
然后把聚合地址填进 TVBox 的接口设置：http://你的局域网IP:5678/
保存，返回首页，内容就出来了。
🌿 06. 几个细节
这个项目不是简单地把多个源拼接在一起，而是做了很多细节处理：
站点去重：不同源经常收录同一个站点，如果直接合并，同一个站会出现好几遍。需要按站点标识去重，保留一份。
Spider 引擎冲突：TVBox 的 type:3 站点依赖外部 JAR 文件，不同源可能用不同的 JAR。全局只能设一个默认 Spider，其余站点需要单独指定自己依赖的 JAR——这里做了智能分配。
解析规则合并：解析器、直播源、DNS 规则、广告过滤等字段各有各的去重逻辑。
这些细节决定了合并后的配置是不是真的能用，而不只是”看起来有很多站点”。
与其不断找新源，不如让多个源自动聚合成一个稳定地址。
🌿 07. 写在最后
这个项目解决的是一个很具体的问题：TVBox 源总是失效。
它的思路也很清晰：与其不断找新源，不如让多个源自动聚合成一个稳定地址。
如果你家里有 NAS 或者一台常开的电脑，部署一个试试。填一次地址，以后就不用再管了。
项目地址：https://gitee.com/tengxiaobao/tvbox-source-aggregator
有问题可以去 Gitee 提 Issue，作者回复挺快的。
