TVBox 是什么？空壳原理、接口配置与衍生版本 APK 选型指南

CHAPTER 6TVBox 与它的家族

6.1先建立最重要的一个认知：TVBox 是个空壳

这是所有误解的源头。很多人第一次装完 TVBox，打开一看，一片空白，什么都没有，然后就以为装错了或者软件坏了。

它没坏。这就是设计。

TVBox 自己不提供任何影视内容，也不提供任何直播源。它是一个播放器框架，一个界面容器。它打开的时候会去读一份配置文件（圈子里叫「接口」），从里面拿到「有哪些站点、每个站点的接口地址是什么、有哪些直播源、有哪些解析器」，然后把这些东西渲染成你看到的界面。

所以圈子里有句话：TVBox 本身没有内容，内容全在接口里。换个接口，整个软件的内容就换了一套。这也是为什么同一款 TVBox，不同人打开长得完全不一样。

6.2把配置接口解剖开

接口本身就是个 JSON 文件，托管在某个服务器上，你在软件里填一个网址，它就去把这份 JSON 拉下来。结构大致长这样（省略了大量同类项）：

{
  "spider": "https://.../jar/spider.jar;md5;abcdef123...",

  "sites": [
    {
      "key": "csp_XiaoYa",
      "name": "小雅",
      "type": 3,
      "api": "http://.../api.php/app",
      "searchable": 1,
      "quickSearch": 1,
      "filterable": 1
    },
    {
      "key": "cms_hongniu",
      "name": "红牛资源",
      "type": 1,
      "api": "https://.../api.php/provide/vod/",
      "searchable": 1
    }
  ],

  "lives": [
    {
      "name": "默认直播",
      "type": 0,
      "url": "https://.../live.txt",
      "playerType": 1,
      "epg": "https://.../epg.xml.gz",
      "logo": "https://.../logo.png"
    }
  ],

  "parses": [
    { "name": "解析A", "type": 1, "url": "https://.../jx?url=", "ext": {"flag":["qq","youku"]} }
  ],

  "flags": ["youku","qq","iqiyi","mgtv"],
  "wallpaper": "https://.../wallpaper.jpg"
}

几个字段值得单独说。

• spider：TVBox 最核心的机制。它是一个 jar 包，里面装着各种「爬虫」类。有些站点没法用通用接口描述（比如需要复杂登录、加密，或者要直接对接网盘 API），就得靠这个 jar 里的专用类去处理。jar 后面那串 ;md5; 是校验值，用来确认你下到的包没被篡改。这一步同时也是安全风险点，后面会讲。
• type（sites 里的）：决定用什么方式跟站点通信。1 通常对应苹果 CMS 那套采集接口；3 是 AppYs / csp 那类以 /api.php/app 结尾的 JSON 接口；0 表示这是个需要靠解析器去处理网页的站点；4 表示交给 jar 里的自定义类处理。不同魔改版对 type 的处理略有差异，具体还得看你手上配置的说明。
• searchable / quickSearch：能不能被搜到、能不能被首页快速搜到。quickSearch: 1 的站点会出现在你输入关键词时的即时结果里，一般只有响应快的站才会开。
• lives 里的 type：0 一般是直接给一个 m3u / txt 的地址（最常见）；其它取值用于「需要先请求接口再解析出列表」的情况。这一项在各版本里差异最大，也最容易配错。
• playerType：指定用哪个播放内核，常见是 IJK 或 EXO。有些源在一个内核下花屏、在另一个内核下正常，所以这个值有时候是「修好一个源」的关键。

6.3界面长什么样：真机截图

下面这几张是这些软件在真机上的实际界面。电视端、电脑版、手机端的布局差别很大，但操作逻辑是同一套——对着真实截图找按钮，比在电视上用遥控器瞎按快得多。

先看首页。这是你配好接口之后打开看到的东西。

然后是直播页，这个界面和点播页是两套逻辑。左边选分组，中间选台，右边看画面，底下是节目单。

接下来是设置页。这是整套流程里唯一需要你动手输入的地方，也是最容易卡住的地方。

最后一张是播放出问题时要用的界面，以及手机端的布局。

6.4衍生版本全景：血缘、逐个详解与官方地址

这是整篇里最实用的一节。因为 TVBox 这个圈子最大的坑不是技术，是版本混乱——你搜出来的十个「TVBox」，可能是十个不同人改的十个不同软件，功能、稳定性、甚至安全性都不一样。

先说一个必须先建立的认知：官仓早在 2022 年 7 月就封仓停更了，所以严格意义上不存在「官方版 APK」。你现在用的每一个 TVBox，都是第三方开发者按开源协议自行编译的分支。这就是版本如此之多的根本原因。

6.5主流版本一览表

6.6怎么选：三十秒决策

如果只想要一个答案：新设备用蜂蜜版 FongMi，老设备用 Q 版。这两个覆盖了绝大多数场景，其他的等你有明确需求了再说。

6.7下载 APK：看懂文件名才不会下错

在这些项目的发布页里，同一个版本会有一堆文件，名字都是一长串英文加下划线。这个命名是有规律的：用途 + 爬虫引擎 + CPU 架构。看懂就不会下错。

举个例子：leanback-python-armeabi_v7a.apk 读出来就是「电视版 · 带 Python 爬虫 · 32 位」——这是大部分电视的通用选择。

6.8关于「官网」的真相

这一节的内容建议你读完就记住，能帮你躲掉很多坑。

你在搜索引擎里搜任何一个 TVBox 衍生版的名字加「官网」，都会出来一堆看起来很像样子的站点。但实际情况是：绝大多数衍生版根本没有官网。这些作者普遍只维护一个代码仓库，不建站。那些「XX 官网」，基本是 SEO 站点（靠关键词排名赚流量）自己挂的名号，跟作者本人没关系。

确实由作者自己建站的，目前能确认的就那么几个：蜂蜜版和 OK 影视的 fongmi.eu.org、它的接口发布页 down.fongmi.eu.org、影视仓的 ysctvbox.github.io。其余的一律按「来源不明」处理。

另外提醒一句：网上被大量称为「TVBox 官网」的某个 clbug.com 域名，连收录它的导航站自己都标注了「可能并非真正的官网」。而 TVBox 的官仓 2022 年就已经封仓了——一个已经停止维护的项目，是不可能有一个作者在运营的官网的。这个逻辑一想就通了。

6.9TVBox 和 Kodi 不是一回事

因为两者都能看直播和点播，常被拿来比。它们的关系其实很远。

一句话：Kodi 是「你自己建一个电视台」，TVBox 是「租一个别人的电视台，房东随时可能跑路」。