【教程】TVBox 配置地址怎么填（扫码/手动输入与失效排查）

redpear

相关下载（夸克免码 + 百度带码）
夸克网盘（免提取码）：https://pan.quark.cn/s/506a1f556866
百度网盘：https://pan.baidu.com/s/1ZJlsIF4s0Euc71AyDM0hnw
提取码：6f33
说明：入门三件套含 FongMi / 俊版 / takagen99 电视版 APK。TVBox 为空壳播放器，需自行配置合法内容源。



TVBox 配置地址怎么填（含手机扫码与手动输入）

在上一篇教程中，我们成功完成了 TVBox 电视版的安装。此时，如果您打开软件，面对的将是一个完全空白的界面。TVBox 作为纯粹的播放器客户端，本身不提供内容，其强大的功能依赖于一份结构化的配置地址（接口文件）。

本篇教程将指导您如何把准备好的配置地址输入到电视端。我们将详细讲解遥控器手动输入和手机扫码推送两种操作方式。文章适用于已经拥有合法数据源（例如自行搭建的本地 NAS 影视库 JSON 索引、获授权的接口配置等）的新手用户。

再次重申硬性合规要求： 本板块坚决抵制盗版。本文中的所有演示均使用 `https://example.com/tvbox/config.json 等占位符作为示例。请用户务必配置自己有权使用的合法服务，切勿在论坛求助或分享违规的侵权接口、聚合盗版源。配置地址相当于将播放器的读取权限交给该文件，随意填入不明来源的地址存在极大的隐私和设备安全风险。


下载安装包

还没装电视版的，先下空壳安装包；配置示例只演示 JSON 长什么样，不能当片源：

· 夸克网盘（免提取码）：https://pan.quark.cn/s/506a1f556866
· 百度网盘：https://pan.baidu.com/s/1ZJlsIF4s0Euc71AyDM0hnw
· 百度提取码：6f33

转存后按后文步骤安装或对照格式。真正的配置、直播源和网盘文件仍须使用您自己有权使用的内容。

一、 什么是配置地址？

在进行操作前，您需要明白配置地址通常是一个以 .json 结尾的网络直链（URL）或本地路径。它是一份文本格式的清单，告诉 TVBox 去哪里寻找播放资源、使用什么规则来解析。

一份精简合规的 JSON 接口文件内部结构大致如下（仅作结构示意）：

1. {
2.   "spider": "https://example.com/tvbox/spider.jar",
3.   "sites": [
4.     {
5.       "key": "MyNAS",
6.       "name": "我的家庭媒体库",
7.       "type": 3,
8.       "api": "https://example.com/tvbox/api.php"
9.     }
10.   ],
11.   "lives": [
12.     {
13.       "name": "家庭局域网摄像头",
14.       "url": "https://example.com/tvbox/live.txt"
15.     }
16.   ]
17. }

复制代码

注意： 您不需要手动编写这些代码，您只需要拿到类似于 https://example.com/tvbox/config.json 这样的完整链接即可。

二、 进入设置与填写地址的分步操作

打开 TVBox，使用遥控器移动焦点。不同分支的 UI 略有差异，但设置入口通常非常明显。

步骤 1：找到设置入口

在应用主页（通常是右上角或者遥控器按下“菜单”键），找到一个齿轮图标或写着【设置】的按钮，点击进入设置中心。



主界面顶部找到并点击齿轮“设置”图标入口


步骤 2：选择配置菜单

在设置页面的主要位置，您会看到【配置地址】（有的分支可能叫“当前接口”、“订阅地址”或“设置数据源”）。点击这个选项，屏幕中央会弹出一个输入对话框。



点击配置地址后弹出的输入对话框及附带的二维码


此时，您有以下两种方式将那串较长的 URL 网址填入对话框中。

方式 A：手机扫码推送（强烈推荐，最快捷）

使用遥控器输入冗长的英文网址极易出错，TVBox 贴心地提供了局域网扫码推送功能。

1. 观察弹出的“配置地址”对话框，旁边通常会显示一个二维码以及一串局域网 IP 地址（例如 http://192.168.1.100:9978）。
2. 确保您的智能手机与电视连接在同一个局域网（同一个路由器 WiFi）下。
3. 打开手机的微信、浏览器或系统相机的扫一扫功能，扫描电视屏幕上的二维码。
4. 手机端会打开一个极简的网页，页面上有一个文本输入框。
5. 在手机上，将您准备好的配置地址（如 https://example.com/tvbox/config.json）复制并粘贴到该输入框中。
6. 点击手机网页上的「推送」或「提交」按钮。
7. 抬起头观察电视屏幕，原本空白的配置地址栏会瞬间自动填入您推送的链接。



手机扫码后打开的网页界面及推送按钮示例


方式 B：遥控器手动输入（适用于无手机或不在同一局域网的情况）

如果扫码功能异常，您只能使用遥控器手动键入。

1. 在电视弹出的输入框处，按下遥控器“确认”键，调出系统虚拟键盘。
2. 如果输入框内有旧的失效地址，请使用虚拟键盘上的退格键（Backspace，通常图标是 [X]）将其完全清空。
3. 对照您的配置地址，利用遥控器方向键，一个字母一个符号地仔细输入。
特别提示：务必注意区分大小写，且 http:// 或 https:// 的冒号和斜杠绝不能漏掉或打错（不能用中文标点）。
4. 输入完成后，点击虚拟键盘上的“完成”或“回车”关闭键盘。

步骤 3：确认并验证配置

无论使用哪种方式填入了地址，请按遥控器将焦点移动到对话框的【确定】按钮并按下。
此时软件会提示“正在获取数据...”。退回至 TVBox 首页，预期的成功界面是：首页不再是一片空白，顶部出现了对应的分类菜单（如“我的 NAS”、“电影库”等），且界面没有红色的报错提示。



配置成功后，首页不再空白，出现对应的分类菜单和站点列表


三、 常见问题排查（FAQ）

在配置地址时，用户经常会遇到各种连接失败的问题。以下是常见的 5 种错误现象及其排查方法：

1. 现象：点击确定后提示“获取配置失败”或一直转圈超时
· 原因： 地址拼写错误、接口服务器已宕机、或者电视的网络/DNS 无法解析该域名。
· 处理： 首要排查法： 将该 URL 复制到同一网络下的手机浏览器地址栏中直接打开。如果手机上显示一堆排版好的英文字符（JSON 数据），说明地址有效，问题出在电视网络（尝试重启路由器或在电视网络设置中更改 DNS 为 114.114.114.114）；如果手机上也打不开或显示 404，说明该订阅地址本身已经彻底失效，请更换地址。


2. 现象：填了网址并确认，但首页依然空白无分类，也没有报错
· 原因： 虽然网络能连通，但填入的 JSON 文件格式本身存在语法错误，或者文件内部的数据被清空。
· 处理： 检查该配置源的合法性，或联系配置的提供者修复 JSON 语法（缺少逗号或括号不匹配等均会导致解析失败）。


3. 现象：提示“证书校验失败”或“SSL/时间错误”
· 原因： 电视机的系统时间错误，或者老旧的 Android 电视系统（Android 4.x-5.x）内置的 HTTPS 根证书已过期，无法访问 https:// 开头的安全链接。
· 处理： 首先进入电视系统设置，将日期和时间校准为当前北京时间。如果时间准确仍报错，且您信任该地址，可以尝试将地址开头的 https:// 改为 http:// （仅限该服务器支持 HTTP 降级的情况），或考虑外接一个新的电视盒子。


4. 现象：测试通过，但加载出的是一堆网页代码（HTML），而不是媒体分类
· 原因： 您误将一个介绍该接口的“网页文章地址”填了进去，而不是底层的 JSON 直链。TVBox 需要的是纯数据文件，而不是让人阅读的网页。
· 处理： 重新检查您的地址来源，确保填入的是以 .json 或 .txt 结尾的原始数据链接。


5. 现象：输入地址时，总是多出奇怪的空格或字符
· 原因： 手机端复制地址时，输入法或某些聊天软件（如微信）会在链接前后自动添加隐藏空格，或者电视系统的输入法有 bug。
· 处理： 在手机端复制前，将其粘贴到备忘录中，仔细检查并删除开头和结尾的所有空格再进行推送。如果使用遥控器输入，请仔细核对每一个字符。



四、 注意事项

· 定期维护与更换： 任何网络服务都不是永久的，即便是合法的公益开源接口也可能因服务器成本或域名到期而失效。如果某天突然无法加载分类，请冷静排查是否是配置地址失效，必要时及时在设置中替换新的有效地址。
· 保护隐私安全： 如果您使用的是自己搭建的内网 NAS 穿透接口，或带有个人验证 Token 的私有服务，请绝对不要在任何公共群聊、论坛中截图分享您的配置地址。一旦泄漏，您的服务器可能会面临被滥用甚至被入侵的风险。

相关下载（配置填写示意与空壳安装包）

如果电视上还没有安装电视版，可先下载空壳安装包；配置文件本身请使用您自己的合法订阅，不要把下面的网盘链接当成片源。

· 电视版空壳安装包 · 夸克网盘（免提取码）：https://pan.quark.cn/s/506a1f556866
· 电视版空壳安装包 · 百度网盘：https://pan.baidu.com/s/1ZJlsIF4s0Euc71AyDM0hnw
· 百度提取码：6f33

网盘内如有 config.example.json，仅为字段结构示例（域名均为 example.com` 占位），不能直接当可用接口。真正的配置地址仍需您自行准备并按上文扫码或粘贴。



手机扫码页与网盘中的示例 JSON 文件


五、 小结

配置接口地址是使用 TVBox 最核心也是门槛最高的一步。通过本篇教程，您应该已经掌握了利用手机扫码或手动输入的方式，正确地将合法合规的 JSON 配置链接部署到电视中。掌握了“手机浏览器验证法”这一排错利器，您就能轻松应对大部分“配置失败”的问题。配置成功后，您的 TVBox 就拥有了灵魂，正式成为一个强大的家庭媒体中心。配置完成并确认地址有效后，即可用遥控器进入分类进行播放测试。