TVBox 多仓/接口导入完整教程：订阅链接、本地文件与切换技巧

redpear

写在前面

「仓」和「接口」是 TVBox 系客户端里最容易混淆的两个词。简单说：

· 接口 / 订阅 / 配置地址：告诉软件去哪里拉取站点列表与规则。  
· 多仓：同时保存多套配置，并可一键切换。  

本软件是开源播放器外壳，接口与资源需用户自备。请只使用你有权使用的合法内容，遵守当地法律法规与版权规定。本文只讲导入与管理方法，不提供任何片源地址，也不放置第三方 APK 列表站链接。



一、先分清：单仓、多仓、站点

· 概念：单条订阅｜含义：一个配置地址｜失败时你看到的现象：首页空或全部报错
· 概念：多仓｜含义：多条订阅可切换｜失败时你看到的现象：切到坏仓才空；好仓仍可用
· 概念：站点｜含义：仓里面的某一个源｜失败时你看到的现象：单个站打不开，其他站正常
· 概念：线路｜含义：某一集的播放地址列表｜失败时你看到的现象：换线路可能恢复
把问题定位在「仓级 / 站级 / 线路级」，排错效率会高很多。

二、导入方式一：在线订阅链接

这是最常见方式。

步骤

· 打开客户端 → 设置 → 配置地址 / 订阅 / 仓库（名称因编译而异）。  
· 新建或编辑一条订阅，名称自定（如「日用」「备用」）。  
· 粘贴完整 URL，建议先在记事本去掉首尾空格、换行。  
· 保存，返回首页，执行刷新/重新加载。  
· 随机打开 2～3 个站点做列表与试播。  



注意

· 部分系统对 明文 HTTP 更严格，若保存成功但永远刷新失败，优先换 HTTPS 或改本地文件。  
· 订阅域名被污染时，换 DNS（如路由器改公共 DNS）比换 APK 更有效。  
· 不要在公共场合晒出你的私有订阅，以免被滥用或被封。  

三、导入方式二：本地 json / txt / jar 相关文件

适合：订阅源不稳定、想断网也能保留配置结构、或作者提供的是文件而非网址。

步骤

· 用电脑把配置文件拷到 U 盘，或用网盘下到盒子「下载」目录。  
· 文件管理器记住真实路径，例如 /storage/emulated/0/Download/config.json。  
· 在配置地址中按你客户端支持的格式填写本地路径。  
· 若提示无权限，回到系统设置给应用「文件访问 / 所有文件」权限。  
· 保存并刷新；本地仓同样建议试播验证。  



小技巧

· 目录名用英文，少用特殊符号，减少个别文件管理器编码问题。  
· 更新本地仓时，先覆盖文件再在软件内「强制刷新」，避免读到缓存旧件。  
· jar 扩展类文件是否需要、如何引用，以你使用的壳子文档为准；乱放 jar 可能导致闪退。  

四、导入方式三：推送 / 扫码 / 远程输入（若有）

部分编译支持手机浏览器推送配置到电视，避免遥控器打字。

通用思路：

· 电视端打开「远程配置 / 局域网推送」页，记下提示的地址或二维码。  
· 手机与电视同一局域网。  
· 在手机提交配置名与 URL。  
· 电视确认保存并刷新。  



若推送失败：检查是否访客 Wi-Fi 隔离、AP 隔离、双频设备连了不同网段。

五、多仓管理：命名、排序、启用

推荐结构：

· 主仓：日常最稳，置顶。  
· 备仓：主仓失效时切换。  
· 试验仓：专门用来试新订阅，试完可删。  
· （可选）直播仓：点播与直播分离，互不影响。  

切换流程：多仓列表 → 选中目标仓 → 设为默认/启用 → 回首页刷新。



备份习惯

· 把仓名称 + URL 抄到手机备忘录或加密笔记。  
· 重大升级、清数据、换机之前先备份。  
· 截图也行，但注意不要把截图发到公开相册同步盘被爬。  

六、如何判断「仓失效」还是「网络问题」

按这个顺序 3 分钟自查：

· 手机热点测试：热点下正常 → 原宽带 DNS/运营商问题。  
· 换仓：备仓正常、主仓不行 → 主仓地址失效。  
· 同仓多站：仅一个站挂 → 站级问题，不必整仓扔掉。  
· 时间因素：深夜/高峰部分源不稳，可换时段再测。  
· 代理/VPN：系统全局代理常导致「半连半断」，排错时先关掉。  



七、安全与合规注意（必读）

· 来路不明的「一劳永逸全网接口」风险极高：可能夹带异常跳转、隐私窃取或违法内容。  
· 只为自己合法拥有的内容配置播放能力（例如你有权访问的网盘文件、已购资源的合规播放方式）。  
· 不要在论坛帖子里公开张贴大规模站点列表或侵权源。  
· 发现订阅提示异常权限、异常外链，立即停用该仓。  

八、实操总流程（建议收藏）

· 新装客户端 → 给权限。  
· 只加 主仓 一条 → 刷新 → 试播。  
· 成功后再加 备仓。  
· 建立备忘录备份。  
· 主仓挂了 → 切备仓 → 再考虑更换主仓地址。  
· 播放卡顿再去调硬解/内核（那是播放器问题，不是导入问题）。  



九、FAQ

Q：保存后首页一直转圈？  
A：等超时看报错；检查网络；换本地文件对比；确认 URL 可在手机浏览器打开（仅验证连通性，不代表内容合法）。

Q：多仓切换后还是旧列表？  
A：强制停止应用再开；或清缓存（尽量不清数据）；确认「当前启用仓」是否真的变了。

Q：电视不能粘贴怎么办？  
A：用 U 盘本地文件、局域网推送、或手机端配好再迁。

Q：要不要天天换接口？  
A：不需要。稳定最重要；只有确认失效再换。

九点五、和「仓库帖」的分工说明

本站若已有较早期的仓库入门帖，本文刻意往下钻一层：多仓命名、主备策略、本地文件、失效分级、备份习惯。  
读法建议：先完成「能导入一条订阅」，再按本文把多仓用成可维护的系统，而不是反复重装客户端。

十、合规与免责声明

本软件为开源播放器外壳，接口/资源需用户自备。请注意版权与当地法规。本教程仅讲解导入与多仓管理方法，不提供侵权内容与第三方 APK 列表链接。

十一、双盘下载（夸克 + 百度）

如需本站整理的 TVBox 系客户端安装包：

夸克网盘（免提取码）  
https://pan.quark.cn/s/506a1f556866

百度网盘  
https://pan.baidu.com/s/1ZJlsIF4s0Euc71AyDM0hnw  
提取码：6f33

请按说明选择对应架构。失效则回复本帖，我们会更新链接或标注「双盘待补」。

十二、小结

多仓的价值不是「堆得越多越好」，而是 主备分离、试验隔离、备份可回滚。先让一条合法自备订阅稳定工作，再扩展第二仓；把命名和备忘录做好，比到处搜集来路不明的地址更重要。