电视盒子圈子里流传最广、版本也最杂的，莫过于 TVBox。它不是某一部影视 App，而是一个开源的播放器框架，网上关于它的说法五花八门，"官网"满天飞，版本看得人眼晕。这篇专题把它的空壳原理、版本血缘、选型决策、安装配置、接口资源与安全避坑一次整理齐，收藏这一篇，装 TVBox 基本不用再到处翻帖子。
它的前身是猫影视（CatVod），作者把代码开源到 GitHub 后，沿用了"套壳与视频源分离"的结构设计。设计理念是去中心化：软件本身不碰内容，从而规避内置资源带来的版权风险，同时把选择权完全交给用户。
▲ TVBox 系 App 的典型首页：海报墙 + 分类导航 + 遥控器十字操作
把它想象成浏览器，接口地址就是你要输入的网址。浏览器本身没有网页，但能展示你访问的任何站点。整个链路走下来是这样的：
部分版本还带自动换源：当前线路失效时，自动切到下一条可用线路，不用手动一条条试。
| 特性 | 说明 |
|---|---|
| 🆓 完全免费 | 无会员、无付费墙 |
| 🚫 零广告 | 软件本体不捆绑任何广告与弹窗 |
| 🎨 高度自定义 | 换接口 = 换一整个 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 | 蜂蜜版分支 |
| 版本 | 维护者 | 安卓要求 | 界面 | 特色 | 上手难度 |
|---|---|---|---|---|---|
| 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、挂网盘 | ⭐⭐⭐ |
| 项目地址 | github.com/CatVodTVOfficial/TVBoxOSC |
| 状态 | 🔒 已封仓停更（2022 年 7 月） |
| 定位 | 所有版本的祖源头，用于追溯代码与学习，不建议日常使用 |
网上流传的"TVBox 官方原版 APK"，几乎都是第三方拿这份源码自行打包的。
| 项目地址 | github.com/q215613905/TVBoxOS |
| 最低系统 | Android 4.x 起 |
| 主打 | 支持直播回放；对老电视、老盒子兼容性最好 |
| 适合 | 家里是十年前的智能电视 / 低配盒子 |
| 项目地址 | github.com/takagen99/Box |
| 最低系统 | Android 5.0+ |
| 主打 | 界面重做、UI 美观、支持直播回放、更新最频繁 |
| 适合 | 设备不太老、在意颜值和新功能 |
| 项目地址 | github.com/o0HalfLife0o/TVBoxOSC |
| 下载地址 | github.com/o0HalfLife0o/TVBoxOSC/releases |
| 说明 | 这位大佬把 Q 版和 T 版两个分支都编译好并发布，省去你自己编译 |
常见文件名长这样：
▲ 蜂蜜版手机端：片源分类与多线路换源，竖屏同样好用
| 源码仓库 | 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） |
其他亮点：内置 EXO / IJK 双播放内核，支持软硬解、4K；支持 HTTP/3、DLNA 投屏、语音搜索；片头片尾标记、音轨/字幕轨道记忆；直播支持自定义 EPG，兼容 p2p~p9p、mitv、zlive、tvbus 等协议；可挂载 WebDAV / 网盘建私人片库。
分支：github.com/okcaptain/TV（OK 影视分支）。
| 项目地址 | github.com/catvod/CatVodOpen |
| 下载地址 | 同仓库 Releases 页 |
| 平台 | 🖥️ Windows · 🍎 macOS / iOS · 🤖 Android |
| 说明 | 猫影视重启项目，基于 Flutter，唯一覆盖 PC 与苹果端的分支 |
| 官方下载页 | ysctvbox.github.io |
| 最低系统 | Android 6.0+（V3 版本兼容 Android 4.x） |
| 主打 | 多仓源：可同时挂多个仓库，一个源挂了切另一个，不用改配置 |
| 版本 | TV 版（6.x 系列）/ 手机版（3.x 系列）/ V3（老设备） |
| 更新仓库 | github.com/pluto-player/updates |
| 发布渠道 | Telegram 频道 |
| 状态 | ❗ 不开源 |
| 主打 | 手机 / 电视模式一键切换、多 jar 支持、内置 WebDAV 网盘、画中画、自定义壁纸 |
因不开源，无法审计代码，仅推荐给愿意承担风险的高级用户。
| 项目 | 地址 | 说明 |
|---|---|---|
| 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-* 开头 | 同作者出品，与电视版体验一致 |
| 项目 | 地址 | 说明 |
|---|---|---|
| 多仓版 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 合集（含接口源） |
不想啃版本说明，直接对号入座：
| 你的情况 | 推荐版本 |
|---|---|
| 电视 / 盒子，Android 4.x 老设备 | Q版 / 影视仓 V3 / FongMi kitkat 分支 |
| 电视 / 盒子，Android 5~6 | Q版 / T版 |
| 新设备，想省心、不想到处找源 | 🍯 蜂蜜版 FongMi（自动跳过失效线路） |
| 想同时挂多个源 | 📚 影视仓（多仓一键切换） |
| 在意界面颜值 | 🅃 T版 takagen99 |
| 懒得挑 | 📦 o0HalfLife0o 打包页（Q+T 都有） |
| 安卓手机 / 平板 | mobile 竖屏版 或 FongMi 手机版 |
在 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 位——这是大部分电视的通用选择。
从上面各版本的 GitHub Releases 页面下载，比对包名与体积。
| 设备 | 方法 |
|---|---|
| 智能电视 / 盒子 | APK 拷进 U 盘 → 插电视安装；或用「当贝市场 · 远程推送」输入电视 IP 推送 |
| 安卓手机 | 浏览器下载 → 开启「允许安装未知应用」→ 安装 |
| 电脑 | 用安卓模拟器（如雷电）安装 |
电视端若提示"未知来源"，在设置里开启「允许安装未知来源应用」。
▲ ① 打开 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 |
不是坏了，是没配接口。TVBox 是空壳，必须填接口地址才会有内容。若已填但仍空白：切换其他数据源，或退出 App 重新进入等待加载。
换线路：播放页一般有"换源"选项，手动切一条；换接口：设置里粘贴新的接口地址（不用卸载重装）；优先选蜂蜜版，它会自动跳过失效线路。
软件本体纯净，但采集型接口源可能自带贴片广告、水印或画质瑕疵——这取决于源，播放器规避不了。选干净的源（如网盘型）会好很多。
切换版本时建议清除应用缓存或卸载重装，否则容易出各种异常。配置地址可以提前截图保存。
可以。点播和直播的配置地址是通用的，配一次两端都能用。
不要用"一键清理"类工具清 App 数据。部分版本支持云端账号同步，可在设置里开启。
播放器切换硬解（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 及各衍生版本是开源播放器框架，其性质类似 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 |
