TVBox源管理系统（附2026最新接口地址）

文章目录

- - 概述
  - 开源地址和内容
TVBox-Suite
- 项目特点
- 版本差异
- - [normal 版本](#normal 版本)
  - [python 版本](#python 版本)
- 目录结构
- 核心组件
- - 构建脚本 (build_apk.sh)
  - [Web 目录](#Web 目录)
  - 工具脚本 (script 目录)
- [TVBox 源管理系统](#TVBox 源管理系统)
- 核心修改
- 配置说明
- - 默认设置
- 运行环境
- 贡献
- 许可证
- 项目地址
- - 附录（2026最新接口地址）

概述

构建一套完整的 TVBox 源管理系统，通过 script 和 web 目录的工具实现视频源的批量管理、优化处理和自动化运维，需要基于云服务器 或者本地NAS系统。

云服务参见：阿里云服务器系列。

本地NAS系统同样推荐类Linux环境，可全功能迁移。最低要求则是支持Python的Web系统。（旧手机可以为改造本地NAS系统，但可能需要对部分文件进行适用低Python版本的定制化处理。等有空了我把本地NAS情况总结为文章后再更新链接）

TVBox概述、catvod、TVBox源格式等基础内容参见：https://blog.csdn.net/zhiyuan411/article/details/140672669

开源地址和内容

项目开源地址：https://github.com/zhiyuan411/TVBox-Suite

TVBox-Suite

TVBox-Suite 是一个自用定制版 TVbox 项目，包含专属源管理页面、TVbox 资源整合处理脚本等周边工具，纯个人定制使用。

该项目不仅提供了基于 TVbox 的增强改进（主要是防御性编程的健壮性提升）的定制版本，还构建了一套完整的 TVBox 源管理系统，通过 script 和 web 目录的工具实现视频源的批量管理、优化处理和自动化运维。

项目特点

支持多种视频源
内置多种播放器（系统播放器、IJK播放器、Exo播放器）
支持搜索功能
支持历史记录
支持 DNS 配置
支持多版本构建（normal 和 python 版本）

版本差异

normal 版本

功能：提供基础的视频播放和搜索功能
体积：体积较小，适合对应用大小有要求的场景
性能：启动速度快，运行流畅
适用场景：日常视频播放，不需要 Python 爬虫功能的用户

python 版本

功能：包含 normal 版本的所有功能，同时支持 Python 爬虫
体积：体积较大，包含 Python 运行时环境
性能：启动速度略慢，但功能更丰富
适用场景：需要使用 Python 爬虫功能的用户，对功能完整性有要求的场景

目录结构

复制代码

TVBox-Suite/
├── app/             # 应用主代码
├── build_apk.sh     # 构建脚本
├── gradle/          # Gradle 配置
├── quickjs/         # QuickJS 引擎集成
├── README.md        # 项目说明
├── script/          # 工具脚本目录
└── web/             # Web 资源目录

核心组件

构建脚本 (build_apk.sh)

build_apk.sh 是项目的核心构建脚本，提供了完整的编译和打包流程：

功能：
- 自动检测和配置 Java 环境
- 清理之前的构建产物（可选）
- 编译并构建 debug 版本的 APK
- 自动复制构建产物到 web 目录
- 提供友好的构建过程输出
构建流程：
1. 检查当前 Java 环境
2. 清理之前的构建（如果指定 --clean 参数）
3. 编译并构建 debug 版本的 APK
4. 检查构建结果并显示生成的 APK 文件
5. 复制 APK 文件到 web 目录
产物管理：
- tvbox.apk：Python 版本（arm64）
- tvbox-old.apk：Python 版本（armeabi）
- tvbox2.apk：Normal 版本（arm64）
- tvbox2-old.apk：Normal 版本（armeabi）

使用方法：

bash 复制代码

# 清理并构建
./build_apk.sh --clean

# 增量构建
./build_apk.sh

Web 目录

web 目录是项目的重要组成部分，用于存放和管理各种资源：

资源管理：
- APK 文件：构建完成后，各版本的 APK 文件会被自动复制到该目录
- 图片资源 ：pic/ 子目录存放了应用所需的图片资源
- 配置文件 ：包含 tv.json、tv.m3u、tv.txt 等应用配置文件
Web 界面：
- 提供了多个 HTML 文件，如 4p.html、app.html、s.html 等
- 可能用于提供应用的 Web 控制界面或配置界面
工具和数据：
- 包含 xbspider.jar 等工具文件
- 存储了 input.txt 相关文件，可能用于测试或配置
功能作用：
- 作为应用资源的集中存储目录
- 提供 APK 文件的下载和分发功能
- 可能用于应用的远程配置和管理
- 支持应用的 Web 相关功能

工具脚本 (script 目录)

script 目录包含多个工具脚本，用于辅助项目的开发和维护：

merge-sources 子目录：
- 功能：用于合并和处理视频源配置
- 脚本：
  - mergeSources.py 系列脚本：不同版本的视频源合并工具
  - filterBadApiUrls.sh：过滤无效的 API URL
  - validate_sites.py：验证站点配置的有效性
  - update.sh：更新脚本
- 输出：生成 output_lives.json、output_lives.m3u、output_lives.txt 等配置文件
random-sites 子目录：
- 功能：随机生成站点配置
- 脚本：randomSites.py
- 配置：包含 blacklist.txt 和 whitelist.txt，用于控制站点的包含和排除
samples 子目录：
- 功能：提供各种配置文件的示例
- 示例：api.py.sample、crontab.sample、nginx.conf.sample 等
功能作用：
- 自动化处理视频源配置，提高配置管理效率
- 验证和过滤无效的视频源，提升应用稳定性
- 提供配置文件示例，方便开发者参考和使用
- 辅助项目的持续集成和自动化构建