TVBox 之外,中文圈还有一批更接地气的壳。这一篇逐个上手影视仓、OK影视、酷9:怎么装、怎么配、哪些设置能碰哪些别碰,以及它们和 TVBox 之间到底怎么选。
TVBox 火了之后,围着它长出来两条方向完全不同的路。
一条是把整套东西搬过来,做本地化改造——影视仓走的是这条。它没动架构,改的是界面、多仓体验和预置功能,本质上是 TVBox 的一个成熟分支。你学会 TVBox,基本等于已经学会它了。
另一条是只把其中一块拆出去,单独做成一个软件——酷9 走的是这条。它不要点播,不谈仓库,不碰接口生态,就做一件事:把直播放好。所以打开酷9,你找不到影视墙,也找不到「配置地址」那个输入框,很多人第一次用会以为下错了版本。
还有第三条路,跟前两条完全不是一回事:干脆绕开 TVBox 这一整套,用一个国外正规播放器。TiviMate 走的就是这条——界面做得极精致,回看、录制、多画面都有,但核心功能要付费,而且它只认标准的 m3u 和 Xtream Codes 登录,国内那种「接口配置」它一概不认。
这一章一共讲四个客户端:影视仓和 OK影视 是 TVBox 的亲戚,酷9 是把直播单独拆出去做的壳,TiviMate 是外来户。四个的取舍完全不同,逐个讲清楚。
影视仓经常被单独拎出来问,其实它在技术谱系上并不特殊——它就是 TVBox 家族里的一个成员,只是因为它做得早、装机量大、教程多,所以在圈外的知名度比「TVBox」这个词本身还高。很多人甚至以为影视仓是一个独立的软件品类。
它和原版 TVBox 的区别主要在这几处。
但要强调一点:影视仓的底层还是同一套机制。配置接口的 JSON 结构、spider jar、sites / lives / parses 这些核心概念,和 TVBox 一脉相承。所以你学会了一个,另一个不用重新学。
说实话,这类软件的实际使用体验差异,八成来自你用的接口,两成来自软件本身。纠结选哪个软件,不如花时间找一个靠谱的配置源。真要选,按这个优先级:能持续拿到更新版本 > 界面顺手 > 功能多。
OK影视经常被当成一个独立软件来讲,其实它的来历一点都不神秘:它就是蜂蜜版(FongMi 影视)的一个二改分支。作者 okcaptain 把源码接过去,改了软件名,在功能和界面上做了些本地化调整,然后独立发版。底层那套东西——CatVod 传下来的 spider jar、sites / lives / parses 的配置结构——一个字没动。
关于它和蜂蜜版的分工,作者自己有过一段说法,转述得很广:影视由 OKjack 和蜂蜜两人共同维护,版本分 OK 版和蜂蜜版,OK 版功能更多、更愿意听网友建议,蜂蜜版保持初心、更愿意遵循本心。这段话不必当成产品说明书,但它解释了一个现象——两套东西长得几乎一样,操作逻辑完全通用,你学会一个,另一个不需要重新学。
它在教程里的出现率特别高,原因也不复杂。一是它把「配置」这一步做得更顺手,二是它的分发渠道更接地气,更新往往先出现在作者的公众号里,而不是 GitHub 上。你在它的换源菜单里会看到一堆挂着自己公众号名号的接口,那是配置源作者留的署名,不是广告位。
但它有一处容易踩的地方,得提前说清楚:OK影视、影视、影视TV,还有手机版和电视版,用的是同一个包名。同一台设备上只能装一个,后装的会把先装的顶掉,或者直接提示安装冲突。想要两个并存,只有海信专版这种改过包名的特殊版本能做到。
所以用这类软件,心态要和用普通 App 反过来:软件本身不提供内容,它只是个容器。装好只是第一步,能不能看,取决于你往里填什么。
如果你搜过 OK影视 的教程,一定会看到这个地址被反复引用:github.com/FongMi/Release/tree/okjack/apk/release。这个路径下的 APK,曾经是 OK影视 最主流的下载来源。
现在它已经不可用了。我去核实过,FongMi/Release 这个仓库目前只剩 fongmi 一个分支,okjack 分支已经被撤掉,原来那几个 APK 直链实测都返回 404。也就是说,网上所有给出 okjack 路径的教程,下载部分全部失效了——包括很多看起来还很新的文章。
那 OK影视 自己的仓库呢?github.com/okcaptain/TV 确实还在,里面是完整的源码,但没有 Releases 页,也没有放任何安装包,最后一次推送代码是 2024 年 10 月。它是给你看代码和提问题用的,不是给你下 APK 用的。
到今天为止,OK影视 没有一个可以长期依赖的公开下载直链。它的安装包主要靠作者的公众号和网盘流转。这意味着两件事:一是你需要接受"每次更新都得自己去公众号翻"这个成本;二是搜索结果里那些标题写着「OK影视官网下载」的站点,全部不是官网——它们是靠关键词排名吃流量的下载站,装的包多半被二次打包过,来源不可验证。
如果转了一圈还是找不到一个放心的安装包,我的建议是直接用蜂蜜版。FongMi/TV 这个仓库还在持续更新,本节接下来讲的所有操作,蜂蜜版上一模一样地适用。它们是同一套代码的两个分支,不存在"用蜂蜜版学不会 OK影视"这回事。
下面以电视版为例走一遍。整个过程只有两个关键动作:找到设置里的「点播」,然后把接口地址送进去。剩下的都是等。
第一步,进设置。从主页顶部那排导航里选「设置」,进去之后你会看到这样一页。
这里有个概念要建立起来:「点播」和「直播」是两条互不相干的配置。点播管的是电影、剧集那些按需播放的内容,直播管的是电视频道。填了一个不影响另一个,只填点播就是纯粹的追剧工具,两个都填才是一个完整的合集。这一点和酷9 不一样——酷9 只有一个列表订阅入口,因为它是纯直播的壳。
第二步,点「点播」。会弹出一个配置窗。
看到输入框,第一反应可能是拿遥控器输地址。别这么干。这类接口地址动辄四五十个字符,带大小写、斜杠和数字,用遥控器的方向键一个字符一个字符地挪,十分钟未必能输对一次。那个二维码不是装饰品,它就是为这件事准备的。
第三步,用手机扫码。手机和电视连在同一个无线网下,扫完码会自动打开一个配置页面。在手机上把接口地址粘贴进去,点确定。
填的内容会实时回显到电视上,这时候再按电视端的「确定」保存。整个过程的顺序是:扫码 → 手机输入 → 电视确认,不是反过来。
截图里出现的是 9978,但你在自己设备上看到的可能是别的数字,甚至同一台电视重启后都会变。以屏幕上当次显示的为准,不要照抄任何教程里的地址。如果手机扫码打不开页面,退回去重新进一次这个弹窗,让它重新分配端口再试。
第四步,返回首页看结果。保存之后退出设置回到主页,软件会去拉取配置,几秒钟的事。拉完之后,原本空荡荡的首页就有内容了。
认准这行字。如果返回首页之后左上角还是空的,说明配置没生效,多半是地址填错了或者那个接口本身挂了。这是最快的一条判据,比反复重装软件有用得多。
第五步,换源。左上角那行字同时也是一个按钮,点它,会展开当前配置里可用的接口清单。
一个多仓地址里通常挂着十几个甚至几十个线路,某个线路播不出来,不用回设置改配置——直接在这里换一个就行。这个操作会占掉你日常使用的大半时间,值得先熟悉。
最后一步,点开任意一个片子试试。
到这里点播这条线就通了。整个过程和配置影视仓是同一套流程,因为底层就是同一套机制——接口决定内容,软件只负责把内容画出来。你在这一步遇到的任何问题,八成都不在软件上,而在你填的那个地址上。
直播的配置路径和点播一样:设置 → 直播 → 扫码 → 填地址 → 确认。地址可以是 m3u 也可以是 txt,和前面几章讲的规则一致。
但很多人卡在下一步:地址填对了,列表也出来了,点开却黑屏或者报错。这种情况八成不是你填错了,而是服务器在挑请求头。
社区里流传比较广的一个处理办法是这样:进「播放设置」,拉到最下面找到 User-Agent 那一栏,填 okhttp/3.12.0,然后完全退出软件再重新打开——注意是彻底退出,不是按返回键回首页。这个值来自 OK影视 客户端自身发请求时用的标识,很多运营商类的直播源认这一套。原理我说不太清楚,但这招成本极低,值得先试一次。
另一个常见现象是首页的海报全是白框。那不是网络断了,是 DNS 解析在你这个网络环境下不给力。回设置里找「DoH」这一项,把「系统」换成阿里、腾讯、360 轮流试一遍,通常换一个就好。
设置页项目不算多,但性质差别很大。有的必须改,有的改错了会让整个软件失效。按动它的风险从低到高排一排:
这张图里有两条经验值得单独拎出来。一是「备份恢复」应该早点用:把配置导出成文件存着,换设备、重装软件、甚至配置源整个挂掉需要重来的时候,能省掉重新扫码的全过程。二是「个性设置」这一项不要凭好奇去开,它是给有明确代理需求的场景准备的,普通家庭网络开它只有坏处。
装手机版还是电视版,取决于你的遥控方式是手指还是遥控器。电视横屏版在手机上用很别扭——它的焦点导航是为方向键设计的,你点屏幕上的按钮,光标不会按你预期的方式走。反过来,手机竖屏版投到电视上,字会小得没法看。
这张截图里有两处值得说。
第一,点播和直播填同一个地址是正常操作。多仓型配置往往在一个 JSON 里同时带着 sites(点播站)和 lives(直播源)两套内容,TVBox 会各取所需。所以你不是必须去找两个不同的地址——一个地址填两遍,能用就是能用。
第二,别拿版本号跨端比较。电视版和手机版是各自独立编译的,版本号经常对不上,我见过电视版标 3.8.5、手机版标 5.2.1 的情况,那是正常的,不代表你下错了某一个。同理,看到"关于"里写着 mobile-arm64_v8a 这种名字也别慌,那是在告诉你这个包是给 64 位手机用的——第 6 章讲过的文件名规则,在"关于"里会再出现一次。
这四款放在一起比,其实是在比两件事:你主要看点播还是看直播,以及你愿不愿意为拿一个能更新的版本多花点力气。
| 软件 | 主业 | 版本现状 | 一句话建议 |
|---|---|---|---|
| 影视仓 | 点播为主,直播附带 | 下载页仍在维护 | 装机量大、教程最多,新手先从这个开始 |
| OK影视 | 点播为主,直播附带 | 源码仓 2024-10 后未再推送,GitHub 无安装包 | 想用就用,但要接受拿干净安装包要靠自己找 |
| 蜂蜜版 FongMi | 点播为主,直播附带 | 仓库持续更新中 | 拿不到 OK影视 时就用它,操作完全一样 |
| 酷9 | 纯直播 | 独立项目,与前述三者不同源 | 只看电视、不追剧,选它更轻 |
如果只想要一个结论:追剧选 TVBox 系(影视仓或蜂蜜版),看直播选酷9。这两条路覆盖了绝大多数人的实际需求,剩下的差异都是细节。
前面四款软件,本体都是干净的——它们不含内容、不预置资源,代码开源的还能查到。所有风险都集中在你填进去的那个地址上。这也是为什么本文从头到尾不给具体的接口地址:不是不想给,是这类地址的平均寿命只有周级,写进文档就是在批量制造死链;更要紧的是,写"哪个好"等于替它做背书,而我没法替任何人验证一个别人维护的地址里到底装了什么。
先给它一句话定性:酷9 就是「TVBox 的播放内核 + DIYP 的操作方式」,被单独做成了一个 App。
它的来历在圈子里不算秘密——最早是恩山论坛上的网友做的,把 TVBox 的内核提取出来,又参照了 DIYP、极致、超级 TV 这几款专做直播的空壳,合成一个只服务直播的软件。安装包名是 com.player.ku9。
这个出身直接决定了它的脾气。
另外它还有几个别的直播软件少见的扩展口:webview 网页源、JS 脚本,甚至能把 TVBox 接口当播放源来解析。这些都是给愿意折腾的人留的,不碰也照样能看。
TVBox 是「什么都能装,但每样都得自己配」;酷9 是「只管直播,给它一条地址就开跑」。前者像一台工具箱,后者像一把专门的螺丝刀。
酷9 分标准版、PY 版、Lite 版三个版本,装之前先对一下你的设备。装错版本的表现通常不是报错,而是压根装不上——很多人以为是文件下载坏了,其实是安卓版本不够。
| 版本 | 系统要求 | 差别在哪 |
|---|---|---|
| 标准版 | 安卓 5.0 以上 | 功能最全,绝大多数设备直接用它 |
| PY 版 | 安卓 5.0 以上 | 比标准版多一个 py 目录,能跑 Python 脚本做扩展 |
| Lite 版 | 安卓 4.3 以上 | 老盒子救命版。功能做了裁剪,但换台、订阅这些核心的一样在 |
说到底,只有一类人需要为版本纠结:手上有台安卓 4.x 老盒子的人。这类盒子现在基本被主流软件放弃了,而 Lite 版还能装。不少人家里的老盒子刷不了新系统,装个酷9 Lite 专门给老人看直播,反而是最省事的一条路。
整个流程就四步:装、给地址、选中、看。其中「选中」这一步是唯一容易出错的,下面单独讲。
把 APK 拷进 U 盘,插到电视或盒子上装好。第一次打开,你会看到启动标识闪一下,然后进入一片黑屏。
这不是坏了,也不是没装好。酷9 是个空壳,里面一条频道都没有,所以你看到的黑屏,是它在等一条直播列表。很多人在这一步以为软件有问题,反复卸载重装——记住这个画面,后面就知道自己走到哪了。
顺便把存储权限点了。第一次打开时它会要,给了才能正常读写配置目录。
酷9 的操作是「左右分区」的:屏幕右侧管频道和设置,左侧管音量和搜索,中间点一下出信息条。这个逻辑跟大多数软件都不同,刚上手最容易犯的错就是在屏幕中间猛点,然后什么也调不出来。
电视上遥控器就简单了——按菜单键(有的是 OK 键)就能调出设置列表。手机和平板上则是长按屏幕右侧。
| 想干什么 | 电视 + 遥控器 | 手机 / 平板 |
|---|---|---|
| 调出频道列表 | 按 OK 或 Enter | 点屏幕左边或右边 |
| 调出设置菜单 | 按菜单键 | 长按屏幕右侧 |
| 调出搜索 | — | 长按屏幕左侧 |
| 切换频道 | 上下键 | 屏幕右侧上下滑 |
| 调音量 | 音量键 | 屏幕左侧上下滑 |
| 切换线路 | 左右键 | 屏幕左右滑 |
| 收藏 / 取消收藏 | 长按 OK 键,或按菜单键 | 在频道列表里长按那一项 |
这张表值得单独存一下。很多人用了一阵子还以为酷9 功能少,其实是没找到入口——比如「搜索」藏在长按左屏里,不看说明基本找不到。
进菜单后,路径是:订阅配置 → 列表配置 → 列表订阅。然后点「添加」,填两样东西:
http:// 或 https:// 开头。点确定,会提示「已添加」。到这一步,绝大多数人以为完事了。
在官方说明里,「输入直播源后不要忘记点击选中一下」这句话被连写了三遍。可见栽在这里的人有多少:地址明明加上了,界面还是不显示——因为没选中,软件不知道要用哪一条。看到「列表地址已切换」这几个字,才算真的成功。
在电视上用遥控器一个字母一个字母敲一长串 URL,是件很折磨人的事,还容易敲错。酷9 给了一个更省事的办法:订阅界面里有个二维码,用手机扫一下,会在手机上打开一个输入页面。
前提是盒子和手机连着同一个网络——不在一个局域网里,码扫不出来,这是最多人卡住的地方。
扫开之后,手机上填名称、粘地址,点确认,内容就同步进盒子了,比在遥控器上按半天可靠得多。如果你打算经常换源,这条路径一定要会用。
回到主界面,频道就出来了。左侧是分组(央视、卫视、地方台……),右侧是频道列表,每一项带台标和序号,右边还有一条「节目单」入口。
播放中如果卡,先别急着换源,试试换线路:同一频道按左右键就能切换线路,或者调出菜单点「线路选择」。同一个台的几条线路走的是不同的服务器,卡的那条换掉就行,不必把整个列表都换掉。
菜单里还有两项值得知道:「超时换源」可以设成 5 到 30 秒,播不动时会自动往下换一条;「解码方式」则是在画面异常时换播放内核用的——有的设备用 ExoPlayer 更顺,有的用 IJK 更稳,挨个试一下就知道哪个适合你。
第一个:加完没选中。前面已经说过,这里再单独列一条,因为它实在是太高频了。判断标准就一个——有没有出现「列表地址已切换」。
第二个:搞不清 m3u 和 txt 该用哪个。两种都支持,但有一个细节必须知道:m3u 里一个频道的多条线路,酷9 只认第一条。如果你想要「一个台备几条线路、坏了自动跳」这个保险,就得用 txt 格式的源。m3u 也能正常用,只是少了这层冗余。
第三个:txt 源没有台标,以为是软件出问题。txt 列表里没有地方写台标地址,所以用 txt 的时候台标那一格是空的。想补上,需要往 酷9/logo 目录里放一个 epg_data.json 文件,让它按频道名去匹配图标。这个文件不难找,很多专门分享酷9源的仓库里就带。找不到也不是大事——频道名照常显示,只是少了那个小图标。
第四个:EPG 不显示就断定 EPG 坏了。先去「EPG 订阅」里看一眼里面有没有地址。默认那条如果不好用,自己加一条就行。EPG 的匹配原理在第 9 章讲过:频道名对不上,节目单就不出来,这跟软件没关系,换源或者改频道名才是解法。
酷9 第一次运行,会在设备存储的根目录建一个叫「酷9」的文件夹。所有配置、缓存、脚本、本地列表都塞在里面。以后想手动丢点什么进去,或者做一次备份换设备,都得先找到它。
| 目录 | 装什么 | 什么时候会用到 |
|---|---|---|
logo | 台标图片 + epg_data.json 匹配文件 | 想让 txt 源显示台标时 |
localData | 本地列表文件 | 不走网络订阅、直接从本地读源时 |
download | 从网络下载回来的列表 | 一般不用管,订阅成功后自动存 |
epgCache | EPG 缓存 | 不用管。这是酷9 比 DIYP 顺手的地方——节目单有本地缓存,不用每次重开都重新拉一遍 |
js | JS 脚本 | 要用 http://…/ku9/js/xxx.js 这类网页源时 |
py | Python 脚本 | 只有 PY 版会用到 |
webviewJscode | 网页源的全屏 JS 代码 | 要放 webview:// 开头的源时 |
backup | 备份文件 | 换设备之前备份,或者恢复到新设备 |
configuration | Configuration.json 初始参数 | 只在做「预置源」的定制版时会碰 |
videoFile | 本地视频文件 | 偶尔拿它当本地播放器用 |
这张表里,普通人大概只会用到第一个。其余那七八个目录,你可以理解成它给你留的口子——平时空着,需要的时候才往里放东西。看到这么多文件夹就觉得复杂,是想多了。
截图里还有一个 bg.png,是放自定义背景图的地方,用到的机会极少,知道有这回事就行。
如果你想让全家人的设备「装完就能看」,连填地址这一步都省掉,可以往 APK 里预置一个源。方法是解开安装包,改 assets/Configuration.json 里的 LIVE_URLS 字段,多个地址之间用 || 隔开,单个地址的格式是 地址$自定义名称。EPG 同理,对应字段是 EPG_URLS。
这属于定制打包的范畴:改完签名会变,安装包也不能再叫原来那个名字,来源得你自己保证。只建议清楚自己在干什么的人做——对普通用户来说,扫码填一次地址,费不了两分钟。
这个问题问错了方向。它们不是竞品,是两种用法。
判断标准很简单,看你想要什么:
最后提醒一句和前面一样的话:酷9 本身是干净的,风险在「从哪拿安装包」。它是恩山论坛那个圈子里做出来的东西,没有官网。网上铺天盖地的「酷9下载站」绝大多数是二次打包的,要找就去作者原帖或者活跃的分享仓库拿,别图省事点搜索结果里第一个下载按钮。