朋友们！TVBox 源总是失效？这个工具让你的追剧体验更稳定！

前几天有朋友问我：”小王，TVBox 的源总是失效，有没有什么办法让它更稳定？”，作为一个资深 TVBox 用户，我太懂这种感受了——刚找到一个好用的源，没几天就失效了，又要到处找新源，简直让人崩溃。

今天我要给大家推荐一个超级好用的开源项目——TVBox Source Aggregator，它是一个 TVBox 源聚合器，能将多个配置源合并成一个稳定的聚合地址，还能自动测速筛选、站点级去重，让你的追剧体验更稳定！

这两天我用了之后简直爱不释手，今天就来和大家唠唠这个神奇的工具，看看它是怎么解决 TVBox 源不稳定的问题的。

项目介绍

TVBox Source Aggregator 是一个专为 TVBox 设计的源聚合工具，它的核心价值在于：将多个 TVBox 配置源合并成一个稳定的聚合地址，自动处理源的问题。

✨ 核心特性

• 🚀 多源聚合：添加多个 TVBox 配置 JSON 地址，自动合并为一个
• 🔍 站点去重：不同源中的相同站点只保留一份，避免重复内容
• 🧠 Spider JAR 智能分配：自动处理 type:3 站点的 JAR 依赖冲突
• ⚡ 测速筛选：自动过滤不可达或高延迟的源，保证流畅体验
• 💻 管理后台：网页端添加/删除源，触发刷新，操作简单
• ⏰ 定时更新：每天自动重新聚合，客户端无感知
• 🛡️ 容错设计：聚合失败时保留上次有效缓存，确保服务不中断

🛠️ 技术栈

🎯 应用场景

• 家庭观影：在智能电视上使用 TVBox，享受稳定的视频源
• 个人追剧：在手机上使用 TVBox，随时随地看剧
• 源管理：集中管理多个 TVBox 源，避免源失效的困扰
• 技术爱好者：自建服务，掌控自己的观影体验

部署实战

部署方式一：Docker（推荐）

对于有服务器或 NAS 的用户，Docker 部署是最方便的方式：

1. 克隆仓库：

   1 2	git clone https://gitee.com/tengxiaobao/tvbox-source-aggregator.git cd tvbox-source-aggregator

2. 配置环境变量：

   1	cp .env.example .env

   编辑 .env 文件，至少修改 ADMIN_TOKEN 为你的管理密码

3. 启动容器：

   1	docker compose up -d

4. 访问管理后台：
   打开 http://你的IP:5678/admin，输入密码登录管理

部署方式二：一键脚本

适合没有 Docker 但有 Node.js 环境的用户：

1. 克隆仓库：

   1 2	git clone https://gitee.com/tengxiaobao/tvbox-source-aggregator.git cd tvbox-source-aggregator

2. 一键启动：

   • Mac 用户：双击 start.command 文件
   • Windows 用户：双击 start.bat 文件
   • 命令行用户：运行 node scripts/start.js

3. 后台运行（可选）：

   1 2 3

   # 使用 pm2 npm install -g pm2 pm2 start scripts/start.js --name tvbox

部署方式三：Cloudflare Worker（免费）

不需要自己的服务器，完全免费：

1. 准备环境：

   • Cloudflare 账号（免费）
   • Node.js 18+

2. 克隆仓库：

   1 2 3

   git clone https://gitee.com/tengxiaobao/tvbox-source-aggregator.git cd tvbox-source-aggregator npm install

   

3. 登录 Cloudflare：

   1	npx wrangler login

   

4. 创建 KV 存储：

   1 2	npx wrangler kv namespace create KV npx wrangler kv namespace create KV --preview

   

5. 设置密码：

   1 2	# 记得 your-admin-password 改为你自己的密码 echo "your-admin-password" | npx wrangler secret put ADMIN_TOKEN

   

6. 部署：

   1	npm run deploy

   

7. 自定义域名（推荐）

Workers 默认的 *.workers.dev 域名在部分网络环境下不可直接访问。如果你有托管在 Cloudflare 的域名：

1. 在 Cloudflare DNS 添加记录：AAAA tvbox 100:: （已代理）
2. 取消 wrangler.toml 中 routes 的注释，填入你的域名和 Zone ID

使用指南

添加源

1. 登录管理后台：打开 http://你的地址/admin，输入密码
2. 添加源：在输入框中填入 TVBox 配置 JSON URL，点击 Add
3. 管理源：可以删除不需要的源，或点击 Refresh 触发一次聚合
   

TVBox 配置

将你的聚合地址填入 TVBox 的接口地址：

1

http://你的地址:5678/

端点说明

我的使用感受

作为一个资深 TVBox 用户，我必须说 TVBox Source Aggregator 彻底改变了我的追剧体验。以前我总是为了源失效而发愁：

• 要么是刚找到的源没几天就失效了
• 要么是多个源之间重复内容太多
• 要么是有些源速度太慢，播放卡顿

现在有了 TVBox Source Aggregator，一切都变得超级简单：

1. 稳定可靠：多个源聚合，一个失效了还有其他的，再也不用担心源失效的问题
2. 自动去重：不同源中的相同站点只保留一份，界面更整洁
3. 智能测速：自动过滤高延迟的源，保证播放流畅
4. 管理方便：网页端管理后台，添加删除源超级简单
5. 多种部署方式：不管是有服务器还是没有服务器，都能找到适合自己的部署方式

前几天我用它部署了一个聚合源，添加了5个不同的 TVBox 源，聚合后的地址非常稳定，播放也很流畅，简直不要太香！

总结

今天和大家分享了 TVBox Source Aggregator 这个开源项目，它通过聚合多个 TVBox 配置源，解决了 TVBox 源不稳定的问题。无论是自动去重、智能测速还是多种部署方式，都让我们的追剧体验变得更加稳定和流畅。

TVBox Source Aggregator 的核心优势在于：多源聚合提高稳定性、站点去重避免重复内容、Spider JAR 智能分配解决依赖冲突、测速筛选保证流畅体验、管理后台操作简单、定时更新客户端无感知、容错设计确保服务不中断。

无论是家庭观影、个人追剧还是源管理，TVBox Source Aggregator 都能满足你的需求。最重要的是，它完全开源免费，让每个人都能享受稳定的 TVBox 观影体验。

项目资源

GitHub地址：https://github.com/qq148376839/tvbox-source-aggregator
Gitee地址：https://gitee.com/tengxiaobao/tvbox-source-aggregator

觉得项目不错的话，记得给作者点个star支持一下！

项目特色：TVBox 源聚合器，将多个配置源合并成一个稳定的聚合地址，支持自动测速筛选、站点级去重、Spider JAR 智能分配，提供多种部署方式。

互动时间

你是不是已经跃跃欲试了？赶紧按照文中的步骤部署 TVBox Source Aggregator，体验稳定的 TVBox 观影体验吧！

如果你用了之后有什么有趣的体验，或者有什么问题，欢迎在评论区和我交流。我会定期分享更多好用的开源工具，记得关注我哦！

今天的分享就到这里结束了，我们下一篇文章见。