TVBox本地包怎么用：本地包导入、制作与电视端使用教程
简介「tvbox本地包怎么用」「tvbox本地包制作」是最近搜索建议里出现频率很高的几个词。所谓本地包，其实就是把原本通过网络地址加载的配置文件（一个 JSON 文件，以及它引用的直播列表、扩展文件等），放到电视或盒子自己的存储里，再让客户端通过本地路径去读取。
为什么有人想用本地包？常见原因有三个：一是自己维护的配置不想放到公网服务器；二是网络不稳定时，在线配置经常加载失败，本地文件读取更快更稳；三是家里有多台设备，想用 U 盘一次性拷过去，不必每台都手动输入长长的地址。
需要先说明：TVBox 系客户端（takagen99 版 TVBox、FongMi 影视等）本身是开源的播放器外壳，不自带任何内容。本地包只是"配置文件放在哪里"的区别，里面的内容来源仍需用户自行确保合法合规。本文只讲路径写法、文件结构和权限设置，不提供、也不推荐任何第三方配置地址。
▲ takagen99 版 TVBox 开源项目 GitHub 提交记录页截图：客户端代码公开，可自行查看更新情况
步骤
第一步：搞懂两种本地路径写法：clan:// 和 file://
TVBox 系客户端读取本地文件，常见有两种写法：
· clan://localhost/ ：TVBox 早期就沿用的写法，localhost 后面的部分对应设备内部存储的根目录（一般是 /storage/emulated/0/）。例如文件放在内部存储的 tvbox 文件夹里，就写成 clan://localhost/tvbox/config.json。
· file:// ：标准的本地文件写法，后面跟完整的绝对路径，例如 file:///storage/emulated/0/tvbox/config.json（注意 file: 后面是三个斜杠，前两个属于协议，第三个是路径开头的根目录）。
不同分支、不同版本对这两种写法的支持程度不完全一样。实际使用时建议两种都试一下，哪种能加载就用哪种。如果都不行，大多是文件路径写错或者没有存储权限，参考后面的第五步。
第二步：了解配置 JSON 的基本结构
无论在线还是本地，配置文件的结构是一样的。一个最简化的骨架大致如下（字段值仅为占位说明，请替换为你自己有权使用的内容）：
{
"spider": "./jar/spider.jar",
"wallpaper": "",
"sites": [
{
"key": "my_site",
"name": "我的站点",
"type": 1,
"api": "这里填写你有权使用的接口地址",
"searchable": 1,
"quickSearch": 1,
"filterable": 1
}
],
"lives": [
{
"name": "我的直播",
"type": 0,
"url": "./live/my-live.txt"
}
],
"parses": []
}
各字段的含义：
· sites：点播站点列表，每个站点有唯一的 key、显示名称 name、类型 type 和接口 api。
· lives：直播源列表，url 可以指向一个 txt 或 m3u 格式的频道列表。
· spider：扩展组件（jar）的位置，只有用到扩展类型站点时才需要，没有可以留空或删除。
· parses：解析相关配置，用不到时保留空数组即可。
· wallpaper：壁纸地址，可留空。
注意 JSON 对格式要求很严格：所有键名必须用英文双引号，最后一项后面不能多逗号，括号必须成对。写完后建议用任意 JSON 校验工具检查一遍，这一步能避免绝大部分"导入后没反应""加载失败"的问题。
第三步：制作本地包（目录结构）
推荐在电脑上先把文件整理好，再整体拷到设备上。一个清晰的本地包目录可以是这样：
tvbox/
config.json
jar/spider.jar （可选）
live/my-live.txt （可选）
配置文件里引用同目录下的其他文件时，可以使用 ./ 开头的相对路径（例如上面的 ./live/my-live.txt），客户端会以配置文件所在位置为基准去查找。这样整个文件夹搬到别的设备、换个存储位置都不用改内容。如果你的客户端版本不认相对路径，就改成完整的 clan:// 或 file:// 路径。
第四步：把本地包拷到电视或盒子上
常用的三种方法：
· U 盘拷贝：电脑上把 tvbox 文件夹拷进 U 盘，插到盒子上，再用文件管理器复制到内部存储根目录。
· 局域网传输：部分文件管理器支持在同一局域网下通过网页上传文件。
· ADB 推送：有电脑和 ADB 的话，一条命令即可：
adb push tvbox /sdcard/tvbox
拷完后用文件管理器确认一下路径：内部存储下能看到 tvbox 文件夹，里面有 config.json，这就对了。
▲ 示意图：在盒子的文件管理器中确认 tvbox 文件夹与 config.json 的实际存放位置
第五步：开启存储权限（最容易被忽略的一步）
本地包读不出来，十有八九是存储权限的问题：
· Android 10 及以下：在系统设置 → 应用 → 对应客户端 → 权限里，打开"存储"权限即可。
· Android 11 及以上：系统收紧了存储访问，读取内部存储里的任意文件通常需要"所有文件访问权限"。手机上一般在 设置 → 应用 → 特殊应用权限 → 所有文件访问权限 中开启。
很多电视和盒子的系统设置里没有"所有文件访问权限"这个入口。这时可以用 ADB 授权（先用第一条命令查到客户端的包名，再替换到第二条里）：
adb shell pm list packages | grep -i tv
adb shell appops set --uid 包名 MANAGE_EXTERNAL_STORAGE allow
Android 10 及以下的设备则可以用：
adb shell pm grant 包名 android.permission.READ_EXTERNAL_STORAGE
▲ Android 官方开发者文档中关于"所有文件访问权限"的说明页截图：Android 11 起读取共享存储中的任意文件需要单独授权
第六步：在客户端里填写本地路径
· 打开客户端 → 设置 → 配置地址（不同版本也叫"接口""点播源"）。
· 输入 clan://localhost/tvbox/config.json，或者 file:///storage/emulated/0/tvbox/config.json。
· 确定后返回首页刷新，能看到配置里的站点名称就说明加载成功。
电视遥控器输入长路径很麻烦。不少 TVBox 系客户端支持扫码远程输入：在设置页显示二维码，手机与电视连同一个局域网，扫码后在手机网页里输入地址再推送到电视，省去遥控器逐个字母敲的麻烦。
▲ 示意图：手机扫描电视上的二维码，在手机网页里输入配置路径并推送到电视
第七步：tvbox在线接口怎么写成本地包
如果你自己维护了一个在线配置（或者获得了配置维护者的明确许可），想把它改成本地包，思路如下：
· 下载在线的 JSON 配置文件，用文本编辑器打开。
· 找出其中引用的其他文件（spider 的 jar、直播的 txt、站点 ext 指向的文件等），一并下载到本地包目录。
· 把这些引用从完整网址改成 ./ 开头的相对路径。
· 用 JSON 校验工具检查格式，再按第四步拷到设备上。
需要注意：配置中的站点接口本身仍然是联网获取数据的，本地包只是把"配置文件"放到了本地，并不能让在线内容变成离线可看。另外，请勿把别人的配置打包后公开传播，尊重维护者的劳动和相关版权。
客户端下载（双盘）
本地包需要配合 TVBox 系客户端使用。下面是本站整理的安装包（请根据设备选择电视版或手机版，以及 32 位或 64 位）。
FongMi 影视 5.6.8（含电视版、手机版，64 位与 32 位）
夸克网盘（免提取码）
https://pan.quark.cn/s/a1fcb4dd24ae
百度网盘
https://pan.baidu.com/s/1r6EN5cV_PcW7znno0eEHAw
提取码：3ada
项目主页：FongMi/Release
takagen99 版 TVBox（构建版本 20260227-1116）
夸克网盘（免提取码）
https://pan.quark.cn/s/a3032aea5877
百度网盘
https://pan.baidu.com/s/1JuvhYca52UPggMMxIRgF1g
提取码：29f5
项目主页：takagen99/Box
本软件为空壳播放器，需自行配置合法内容源，请遵守当地法律法规。
常见问题
Q1：填了本地路径，提示加载失败或首页一片空白？
先按顺序排查三件事：路径是否与文件管理器里看到的完全一致（大小写、文件夹名）；是否已经开启存储权限（Android 11 以上要"所有文件访问权限"）；JSON 格式是否正确。九成问题出在这三处。
Q2：clan:// 和 file:// 到底用哪个？
两者都指向本地文件，只是写法不同。clan://localhost/ 后面直接写内部存储下的相对位置，file:// 要写完整绝对路径。哪种能用取决于客户端版本，建议都试一下。
Q3：本地包放在 U 盘里能直接读吗？
可以尝试，但 U 盘的挂载路径因设备而异（通常在 /storage/ 下以一串编号命名的目录），而且拔插后可能变化。更稳妥的做法是复制到内部存储再使用。
Q4：本地包能离线看视频吗？
不能。本地包只是配置文件放在本地，站点和直播的实际数据仍需联网获取。如果想看自己硬盘里的视频，应该使用客户端或系统里的本地播放功能。
Q5：修改了 config.json，客户端里没变化？
客户端可能缓存了旧配置。回到设置页重新确认一次配置地址，或清除应用缓存后再打开。
总结
tvbox本地包怎么用，可以浓缩成四句话：
· 写对路径：clan://localhost/xxx 或 file:///storage/emulated/0/xxx，两种都试。
· 写对格式：sites、lives、spider 等字段结构清晰，JSON 语法通过校验，引用文件尽量用 ./ 相对路径。
· 给够权限：Android 11 及以上需要"所有文件访问权限"，电视没入口就用 ADB 授权。
· 合法使用：本地包只是存放方式的变化，内容来源仍需自行确保合法，不传播他人配置。
按本文步骤走一遍，一般十几分钟就能完成本地包的制作和导入。如果遇到文中没有覆盖的情况，欢迎回帖说明设备型号、系统版本、客户端版本和你使用的路径写法（请隐去个人配置中的地址信息），大家一起分析。
页:
[1]