电视盒子圈子里流传最广、版本也最杂的，莫过于 TVBox。它不是某一部影视 App，而是一个开源的播放器框架，网上关于它的说法五花八门，"官网"满天飞，版本看得人眼晕。这篇专题把它的空壳原理、版本血缘、选型决策、安装配置、接口资源与安全避坑一次整理齐，收藏这一篇，装 TVBox 基本不用再到处翻帖子。

一、TVBox 到底是什么？

一句话：TVBox 不是"影视 App"，而是一个开源的播放器框架——它自己一部片子都没有，装上打开是空的，必须填入"接口地址"才能出内容。

它的前身是猫影视（CatVod），作者把代码开源到 GitHub 后，沿用了"套壳与视频源分离"的结构设计。设计理念是去中心化：软件本身不碰内容，从而规避内置资源带来的版权风险，同时把选择权完全交给用户。

TVBox 主页界面

▲ TVBox 系 App 的典型首页：海报墙 + 分类导航 + 遥控器十字操作

工作原理（"浏览器"类比）

把它想象成浏览器，接口地址就是你要输入的网址。浏览器本身没有网页，但能展示你访问的任何站点。整个链路走下来是这样的：

👤 填入接口地址（JSON/TXT）→📡 拉取远程配置→⚙️ 解析站点与播放链接→🖥️ 渲染首页与分类→🎬 内置播放器解码→▶️ 播放

部分版本还带自动换源：当前线路失效时，自动切到下一条可用线路，不用手动一条条试。

为什么这么多人用

特性	说明
🆓 完全免费	无会员、无付费墙
🚫 零广告	软件本体不捆绑任何广告与弹窗
🎨 高度自定义	换接口 = 换一整个 App，不装新软件
📺 点播 + 直播	一个 App 顶替"追剧 App + 直播盒子"
🧩 多端适配	智能电视 / 电视盒子 / 投影仪 / 安卓手机 / 平板
🔓 开源透明	代码公开可审计，无后门风险
📦 可挂私人库	支持 WebDAV、网盘等搭建私人影视库

二、核心概念速查表

刚接触时最容易被这几个词绕晕，先记下来：

名词	含义
壳（Shell）	TVBox App 本体，只负责解析与播放
源 / 接口	一个 JSON 或 TXT 链接，描述去哪找片、怎么播放
单仓 / 多仓	只用一个接口 vs 可同时挂多个接口仓库（推荐多仓）
仓库（Repo）	影视仓等版本里的"接口集合"概念，可一键切换
爬虫（Spider）	解析站点用的脚本，分 Java（jar）、JS、Python 三种
EPG	直播节目单（电子节目指南），配置后可在直播界面看预告
Leanback	Android TV 的大屏 UI 架构，为遥控器优化
ABI / 架构	armeabi-v7a = 32 位；arm64-v8a = 64 位

三、版本谱系：一张图看清血缘

所有 TVBox 分支的血缘关系可以归成一张表——鼻祖是猫影视，官仓封仓后，社区各分支都是从官仓源码生长出来的：

分支	仓库 / 地址	定位
🐱 猫影视 CatVod	—	鼻祖，已停更
📦 官仓原版	github.com/CatVodTVOfficial/TVBoxOSC	🔒 2022-07 封仓，所有分支的源头
🅀 Q版	github.com/q215613905/TVBoxOS	兼容性最好
🅃 T版	github.com/takagen99/Box	界面美观、功能多
🍯 蜂蜜版	github.com/FongMi/TV	从零重写、自动换源
🐱 猫影视复活版	github.com/catvod/CatVodOpen	Flutter、全平台
📚 影视仓	ysctvbox.github.io	多仓切换
🌌 Pluto Player	github.com/pluto-player/updates	不开源、TG 发布
📦 打包发布	github.com/o0HalfLife0o/TVBoxOSC	⭐ 最常用的 APK 出口（编译 Q+T）
🥤 OK影视	github.com/okcaptain/TV	蜂蜜版分支

⚠️ 重要认知：官仓早已停更，所以不存在"官方版 APK"。你在用的每一个 TVBox，都是第三方开发者按开源协议自行编译的分支。这也是版本如此之多的根本原因。

四、主流版本横向对比

版本	维护者	安卓要求	界面	特色	上手难度
Q版	q215613905	4.x 起（老设备友好）	经典	直播回放、兼容性天花板	⭐⭐
T版	takagen99	5.0+	蓝黑 modern	界面最漂亮、更新频繁	⭐⭐
打包版	o0HalfLife0o	视分支	视分支	Q+T 通吃，APK 最全	⭐
蜂蜜版	FongMi	7.0+（旧版更低）	Leanback 极简	自动跳过失效线路	⭐⭐
猫影视	catvod	视平台	Flutter 简洁	Win / macOS / iOS / Android	⭐⭐⭐
影视仓	影视仓团队	6.0+（V3 兼容 4.x）	多仓管理	多仓源一键切换	⭐⭐
Pluto	pluto-player	9.0 建议	可切换手机/TV	多 jar、挂网盘	⭐⭐⭐

五、逐个详解与下载地址

📦 5.1 官仓原版（历史参考）

项目地址	github.com/CatVodTVOfficial/TVBoxOSC
状态	🔒 已封仓停更（2022 年 7 月）
定位	所有版本的祖源头，用于追溯代码与学习，不建议日常使用

网上流传的"TVBox 官方原版 APK"，几乎都是第三方拿这份源码自行打包的。

🅀 5.2 Q版（于俊版）

项目地址	github.com/q215613905/TVBoxOS
最低系统	Android 4.x 起
主打	支持直播回放；对老电视、老盒子兼容性最好
适合	家里是十年前的智能电视 / 低配盒子

🅃 5.3 T版（蓝黑版）

项目地址	github.com/takagen99/Box
最低系统	Android 5.0+
主打	界面重做、UI 美观、支持直播回放、更新最频繁
适合	设备不太老、在意颜值和新功能

⭐ 5.4 打包发布（最推荐的下载口）

项目地址	github.com/o0HalfLife0o/TVBoxOSC
下载地址	github.com/o0HalfLife0o/TVBoxOSC/releases
说明	这位大佬把 Q 版和 T 版两个分支都编译好并发布，省去你自己编译

常见文件名长这样：

TVBox_q215613905_20230902-0114.apk ← Q版
TVBox_takagen99_20260227-1116-arm64-generic.apk ← T版·64位·通用
TVBox_takagen99_20260227-1116-armeabi-hisense.apk ← T版·32位·海信专版

💡 generic = 通用版，hisense = 海信专版（解决海信电视装不上的问题）。

🍯 5.5 蜂蜜版 FongMi（强烈推荐）

蜂蜜版手机端换源界面

▲ 蜂蜜版手机端：片源分类与多线路换源，竖屏同样好用

源码仓库	github.com/FongMi/TV
APK 发布仓库	github.com/FongMi/Release
APK 目录直达	github.com/FongMi/Release/tree/main/apk/release
开发者官网	fongmi.eu.org
官方接口发布页	down.fongmi.eu.org
配套爬虫仓库	github.com/FongMi/CatVodSpider
包名	com.fongmi.android.tv（认准防伪）
最低系统	Android 7.0（kitkat 分支支持 4.x）

🌟 最大卖点：自动跳过失效线路。这在众多 TVBox 魔改版中是它独有的——播放源挂了会自动切到可用线路，不用手动一条条试。

其他亮点：内置 EXO / IJK 双播放内核，支持软硬解、4K；支持 HTTP/3、DLNA 投屏、语音搜索；片头片尾标记、音轨/字幕轨道记忆；直播支持自定义 EPG，兼容 p2p~p9p、mitv、zlive、tvbus 等协议；可挂载 WebDAV / 网盘建私人片库。

分支：github.com/okcaptain/TV（OK 影视分支）。

🐱 5.6 猫影视复活版 CatVodOpen

项目地址	github.com/catvod/CatVodOpen
下载地址	同仓库 Releases 页
平台	🖥️ Windows · 🍎 macOS / iOS · 🤖 Android
说明	猫影视重启项目，基于 Flutter，唯一覆盖 PC 与苹果端的分支

📚 5.7 影视仓（多仓首选）

官方下载页	ysctvbox.github.io
最低系统	Android 6.0+（V3 版本兼容 Android 4.x）
主打	多仓源：可同时挂多个仓库，一个源挂了切另一个，不用改配置
版本	TV 版（6.x 系列）/ 手机版（3.x 系列）/ V3（老设备）

⚠️ 网络上存在多个自称"影视仓官网"的站点（yingshicang.net、yscapp.cn 等），来源互相矛盾，无法确认哪个由作者本人维护。建议优先使用带 github.io 的下载页。

🌌 5.8 Pluto Player

更新仓库	github.com/pluto-player/updates
发布渠道	Telegram 频道
状态	❗ 不开源
主打	手机 / 电视模式一键切换、多 jar 支持、内置 WebDAV 网盘、画中画、自定义壁纸

因不开源，无法审计代码，仅推荐给愿意承担风险的高级用户。

📱 5.9 手机版 / 竖屏版

项目	地址	说明
TVBoxOS-Mobile	github.com/XiaoRanLiu3119/TVBoxOS-Mobile	竖屏手机版，最常用
TVBoxOS_Portrait	github.com/takagen99/TVBoxOS_Portrait	T 版作者维护的竖屏版
MBox	github.com/kukuqi666/TVBoxOS-Mobile	竖屏手机版（MBox）
FongMi 手机版	Release 仓库中选 mobile-* 开头	同作者出品，与电视版体验一致

🧩 5.10 其他衍生与跨平台

项目	地址	说明
多仓版 Box	github.com/mlabalabala/box	多仓源实现
弹幕版	github.com/lppsuixn/Box	支持弹幕
桌面多平台版	github.com/Greatwallcorner/TV-Multiplatform	基于 FongMi 的 PC 端
配套爬虫	github.com/Greatwallcorner/CatVodSpider	桌面版配套
ZyPlayer（桌面）	github.com/Hiram-Wong/ZyPlayer	独立实现的桌面聚合播放器
APK 集合仓	github.com/youhunwl/TVAPP	影视仓、月光宝盒等打包收集
APK 集合仓	github.com/gunlh/TVboxAPP	TV 版 App 合集（含接口源）

六、30 秒选版决策树

不想啃版本说明，直接对号入座：

你的情况	推荐版本
电视 / 盒子，Android 4.x 老设备	Q版 / 影视仓 V3 / FongMi kitkat 分支
电视 / 盒子，Android 5~6	Q版 / T版
新设备，想省心、不想到处找源	🍯 蜂蜜版 FongMi（自动跳过失效线路）
想同时挂多个源	📚 影视仓（多仓一键切换）
在意界面颜值	🅃 T版 takagen99
懒得挑	📦 o0HalfLife0o 打包页（Q+T 都有）
安卓手机 / 平板	mobile 竖屏版或 FongMi 手机版

🏆 不想折腾的终极答案：新设备 → 蜂蜜版 FongMi；老设备 → Q版。

七、APK 文件名解码表

在 FongMi 等仓库里，文件名是「用途 + 引擎 + 架构」拼起来的，看懂了就不会下错：

片段	含义	怎么选
leanback-*	电视 / 盒子横屏版	大屏设备选它
mobile-*	手机竖屏版	手机、平板
armeabi_v7a	32 位	绝大多数电视、老盒子
arm64_v8a	64 位	新设备、安卓虚拟机
java	jar + js 爬虫	常规够用，体积小
python	jar + js + py 爬虫	兼容接口更多，体积大
release	正式版	✅ 推荐
dev	内测版	尝鲜用
kitkat	安卓 4.x 专用	极老设备
generic	通用版	常规电视
hisense	海信专版	海信电视装不上时试

举例：leanback-python-armeabi_v7a.apk → 电视版 · Python 引擎 · 32 位——这是大部分电视的通用选择。

❓ 装不上提示"不兼容"或"解析包错误"？90% 是架构选错：把 64 位的包装进了 32 位电视，换 armeabi_v7a 再试。仍不行则是系统版本太老，去找 kitkat 分支或影视仓 V3。

八、安装与首次配置（图文教程）

第一步：下载 APK

从上面各版本的 GitHub Releases 页面下载，比对包名与体积。

🔧 GitHub 打不开怎么办？使用 gh-proxy 类镜像加速，在原链接前加前缀，例如：
gh-proxy.com/https://github.com/FongMi/Release/blob/main/apk/release/leanback-python-armeabi_v7a.apk
⚠️ 镜像属第三方中转，非作者维护，仅作备用。

第二步：安装到设备

设备	方法
智能电视 / 盒子	APK 拷进 U 盘 → 插电视安装；或用「当贝市场 · 远程推送」输入电视 IP 推送
安卓手机	浏览器下载 → 开启「允许安装未知应用」→ 安装
电脑	用安卓模拟器（如雷电）安装

电视端若提示"未知来源"，在设置里开启「允许安装未知来源应用」。

第三步：配置接口（最关键的一步）

TV 端设置入口

▲ ① 打开 App，找到右上角「设置」入口

手机端配置点播直播接口

▲ ② 进入设置 → 找到「点播」/「配置地址」

操作路径：打开 App → 设置（右上角齿轮/三横）→ 点播 / 配置地址 → 粘贴接口地址 → 确定 → 返回首页，海报墙自动加载 ✅

三种填法：

方式	说明
扫码推送	电视上点配置会弹出二维码和 IP（形如 192.168.x.x:9978），手机浏览器扫码/访问即可远程填写——电视端最省事的方式
手机同步	先在手机上配好，再同步到电视
本地文件	把 JSON 下载到存储卡，填本地路径即可离线加载

第四步：装直播（可选）

在设置中找到直播配置项，填入直播源地址（支持 M3U / TXT / JSON），可自定义 EPG 节目单地址。

九、接口源仓库清单

⚠️ 接口由社区志愿者维护，平均生命周期约一个月，失效是常态，需要定期更换。

维护者 / 仓库	地址
饭太硬	www.饭太硬.top/tv/
肥猫	肥猫.net/tv
OK 接口	ok321.top/ok
摸鱼儿	我不是.摸鱼儿.top
王二小放牛娃	tvbox.王二小放牛娃.xyz
liucn 单仓	raw.liucn.cc/box/m.json
liucn 多仓	raw.liucn.cc/box/dm.txt
1771245847 单仓	cdn.jsdelivr.us/gh/1771245847/TvBox/tvbox.json
1771245847 多仓	cdn.jsdelivr.us/gh/1771245847/TvBox/tvbox.txt
wzh15802 多仓	raw.githubusercontent.com/wzh15802/tvbox/main/tv.json
FongMi 专用配置	raw.githubusercontent.com/gaotianliuyun/fongmi/main/json/config.json

📌 打开 GitHub 慢时，把 raw.githubusercontent.com 换成 raw.gitmirror.com，或整体加 gh-proxy.com/ 前缀。

十、常见问题 FAQ

Q1：装完打开一片空白 / 首页不显示，是坏了吗？

不是坏了，是没配接口。TVBox 是空壳，必须填接口地址才会有内容。若已填但仍空白：切换其他数据源，或退出 App 重新进入等待加载。

Q2：播放卡顿 / 加载失败怎么办？

换线路：播放页一般有"换源"选项，手动切一条；换接口：设置里粘贴新的接口地址（不用卸载重装）；优先选蜂蜜版，它会自动跳过失效线路。

Q3：软件无广告，为什么片子里还有广告？

软件本体纯净，但采集型接口源可能自带贴片广告、水印或画质瑕疵——这取决于源，播放器规避不了。选干净的源（如网盘型）会好很多。

Q4：换版本需要注意什么？

切换版本时建议清除应用缓存或卸载重装，否则容易出各种异常。配置地址可以提前截图保存。

Q5：手机和电视能用同一个配置吗？

可以。点播和直播的配置地址是通用的，配一次两端都能用。

Q6：收藏的剧集重启后全没了？

不要用"一键清理"类工具清 App 数据。部分版本支持云端账号同步，可在设置里开启。

Q7：4K 音画不同步、频繁卡顿？

播放器切换硬解（ExoPlayer）、降低清晰度档位、关闭后台占网速的软件。

十一、安全与合规（必读）

🛡️ 下载安全三条铁律

#	规则
1️⃣	只从本文列出的 GitHub 地址获取。第三方软件站、网盘里的安装包存在被二次打包、植入广告甚至恶意代码的风险
2️⃣	装完核对包名与体积是否与仓库一致（蜂蜜版包名：com.fongmi.android.tv）
3️⃣	任何要求"加 QQ 群 / 关注公众号 / 扫码"才能拿到安装包的所谓"官网"，直接绕开

🌐 关于"官网"的真相

绝大多数 TVBox 衍生版没有官网——作者普遍只维护 GitHub 仓库，不建站。搜索引擎里那些"XX官网"大多是 SEO 站点自己挂的名号。确实由作者自建的站点仅有：

版本	站点
FongMi 蜂蜜/OK影视	fongmi.eu.org
FongMi 接口发布	down.fongmi.eu.org
影视仓	ysctvbox.github.io
喵影视	www.miaotvs.cn

❗ 特别提醒：tvbox.clbug.com 在网上被大量称为"TVBox 官网"，但连收录它的导航站都自行标注"可能并非真正的官网"。TVBox 官仓 2022 年已封仓，不存在作者维护的官网。

⚖️ 合规提示

TVBox 及各衍生版本是开源播放器框架，其性质类似 U 盘、DVD 机——软件本身不持有任何内容，合法性完全取决于你填入什么接口。请仅用于播放自有片源或已获授权的内容（如自建 WebDAV 私人影视库），勿用于观看未经授权的版权内容。

附录：地址速查总表

🔧 播放器项目

名称	项目地址	下载/发布地址
官仓原版	github.com/CatVodTVOfficial/TVBoxOSC	已封仓
Q版	github.com/q215613905/TVBoxOS	仓库 Releases
T版	github.com/takagen99/Box	仓库 Releases
打包发布 ⭐	github.com/o0HalfLife0o/TVBoxOSC	/releases
蜂蜜版源码	github.com/FongMi/TV	—
蜂蜜版 APK ⭐	github.com/FongMi/Release	/tree/main/apk/release
OK 影视分支	github.com/okcaptain/TV	—
FongMi 爬虫	github.com/FongMi/CatVodSpider	—
猫影视复活版	github.com/catvod/CatVodOpen	/releases
影视仓	—	ysctvbox.github.io
Pluto Player	github.com/pluto-player/updates	Telegram
手机版	github.com/XiaoRanLiu3119/TVBoxOS-Mobile	仓库 Releases
多仓版	github.com/mlabalabala/box	—
弹幕版	github.com/lppsuixn/Box	—
桌面版	github.com/Greatwallcorner/TV-Multiplatform	仓库 Releases
ZyPlayer	github.com/Hiram-Wong/ZyPlayer	仓库 Releases

📡 接口源

名称	地址
饭太硬	www.饭太硬.top/tv/
肥猫	肥猫.net/tv
OK	ok321.top/ok
摸鱼儿	我不是.摸鱼儿.top
liucn 单仓	raw.liucn.cc/box/m.json
liucn 多仓	raw.liucn.cc/box/dm.txt
1771245847	cdn.jsdelivr.us/gh/1771245847/TvBox/tvbox.json
wzh15802 多仓	raw.githubusercontent.com/wzh15802/tvbox/main/tv.json

📅 信息整理于 2026 年 9 月。开源项目地址变动频繁，作者删库、改名、转私有均属常见，若链接失效，搜索项目名查看是否有镜像或 fork。本页仅供技术学习与交流，请遵守当地法律法规，仅用于播放自有或已授权内容。

合规提示：文中涉及的示例均为公开渠道获取的技术内容，仅用于说明原理与工具用法。请在合法范围内使用，不要传播、售卖或用于商业用途。

电视盒子 TV工具影视资源开源项目

继续读

TVBox影视盒子版本大全：主流版本的区别、特色与安装推荐上一篇去看

TVBox 完全指南：版本怎么选、APK 怎么下、接口怎么填，一篇讲透

一、TVBox 到底是什么？

工作原理（"浏览器"类比）

为什么这么多人用

二、核心概念速查表

三、版本谱系：一张图看清血缘

四、主流版本横向对比

五、逐个详解与下载地址

📦 5.1 官仓原版（历史参考）

🅀 5.2 Q版（于俊版）

🅃 5.3 T版（蓝黑版）

⭐ 5.4 打包发布（最推荐的下载口）

🍯 5.5 蜂蜜版 FongMi（强烈推荐）

🐱 5.6 猫影视复活版 CatVodOpen

📚 5.7 影视仓（多仓首选）

🌌 5.8 Pluto Player

📱 5.9 手机版 / 竖屏版

🧩 5.10 其他衍生与跨平台

六、30 秒选版决策树

七、APK 文件名解码表

八、安装与首次配置（图文教程）

第一步：下载 APK

第二步：安装到设备

第三步：配置接口（最关键的一步）

第四步：装直播（可选）

九、接口源仓库清单

十、常见问题 FAQ

Q1：装完打开一片空白 / 首页不显示，是坏了吗？

Q2：播放卡顿 / 加载失败怎么办？

Q3：软件无广告，为什么片子里还有广告？

Q4：换版本需要注意什么？

Q5：手机和电视能用同一个配置吗？

Q6：收藏的剧集重启后全没了？

Q7：4K 音画不同步、频繁卡顿？

十一、安全与合规（必读）

🛡️ 下载安全三条铁律

🌐 关于"官网"的真相

⚖️ 合规提示

附录：地址速查总表

🔧 播放器项目

📡 接口源

继续读

相关推荐