TVBox 里攒的那些收藏和配置，换机前先摸清退路
| 项目 | 内容 |
|---|---|
| 软件 | TVBox |
| 版本 | 1.0.20260227-1116 |
| 平台 | Android APK |
| 体积 | 28.21M |
| 分类 | 多媒体 |
| 包名 | com.github.tvbox.osc.tk |
| 官网 | TVBox 官网 |
| 下载一 | TVBox 下载，TVBox 下载 |
| 下载二 | TVBox 下载，TVBox 下载 |
| 文档 | TVBox 文档 |
| 介绍 | 从收藏夹、历史记录到数据源接口配置，TVBox 的数据全在本地不留云端。换盒子或重装之前，搞清楚哪些能一键导出、哪些要手动拷贝，免得折腾半天白忙活。 |
TVBox 是什么，以及我为什么先看退路
TVBox 是一个跑在安卓电视盒子上的开源视频播放器框架——它本身不带任何影视内容，你自己去找接口源配进去，然后就能在一个统一界面里聚合点播、直播、搜索。界面干净没广告，想接几个源接几个源，老盒子也跑得动。我折腾它快两年了，前前后后换过三个盒子、装过七八个版本，每次踩过的数据坑比看的剧还多。
最痛的那次是老盒子卡死了，换了新的，TVBox 重装完才发现：之前收藏的四十多部追剧中，有一半的源地址已经失效了——我只备份了 APK，没备份配置；还有那些自己调了半小时才拼好的多源列表，连带着播放器偏好一起没了。从那以后我养成了一个习惯：先摸清退路再深度用。不管是换盒子、换版本，还是哪天不想用了要卸载，数据能不能带走、走得干不干净，先搞清楚再往里攒东西。
数据都藏在哪
TVBox 不搞云端同步，所有数据全是本地存储。具体分布在几个地方：
数据源接口配置：这是最核心的一份——你自己找的 JSON、JS、m3u 源，全在一个 tvbox.json 文件里。不同版本路径略有差异，但通常能在设备内部存储的 Android/data/ 目录下、或者 TVBox 应用目录里找到它。这份文件就是你整个影视库的骨架，没它 TVBox 就是个空壳。
收藏夹和历史记录：存在一个本地 SQLite 数据库里（通常叫 tvbox.db 或者类似名字）。你追了一半的剧、看过的记录、标记过"稍后看"的条目，全在这张表里。这个数据库跟上面的 tvbox.json 在同一个应用数据目录下。
播放器偏好和其他设置：比如默认用 ExoPlayer 还是 ijkplayer、字幕偏移量、缓冲速度、主题颜色之类的小配置，有的版本写在另一个 JSON 或 SharedPreferences 里，有的直接混在主配置文件里。
本地字幕和封面图：如果你导入过 .srt、.ass 字幕文件，或者给某些没封面的视频手动指定过图，这些文件是你主动拷进设备的，TVBox 只记录路径不复制——所以它们的位置由你决定，不在应用数据目录里。
一个好消息是：TVBox 没有账号体系，没有强制注册，没有任何数据绑在"云端"或"账号"上。你换任何设备、装任何版本，只要能把上面这两份文件（tvbox.json + 数据库）带过去，就能恢复到之前的状态。
怎么备份：三条路，推荐组合用
我现在每次换机前必做三件事，按优先级排：
路线一：应用内导出
较新版本的 TVBox（以及一些常见的魔改版）在设置里提供了「备份配置」或「导出数据源」的选项。点一下就能把当前的 tvbox.json 导成一个独立文件，有的版本还会连同数据库和偏好一起打包成 .zip。这是最稳的一条路——不用进文件管理器瞎摸，也不怕漏了某个隐藏目录。
操作路径大致是：进入 TVBox → 设置 → 找到「数据源」或「备份」相关的菜单项 → 选择导出 → 指定一个方便找的位置（我习惯先导出到 U 盘根目录）。导出的文件名通常带时间戳，一眼就知道是不是最新的。
路线二：手动拷贝应用数据目录
如果你的版本没有导出功能，或者想备份得更彻底，可以直接用文件管理器去拷应用数据目录。路径一般是：
内部存储/Android/data/[TVBox 包名]/files/包名常见的有 com.github.tvbox.osc、com.github.tvbox.osc.tk 之类，看你装的是哪个版本。进去之后把整个 files/ 目录复制出来就行——tvbox.json、tvbox.db、偏好设置、甚至一些版本缓存都在里面。拷到电脑或 U 盘上存好，换设备时整个贴回去。
路线三：截图留底
这听起来土，但有奇效。尤其是收藏夹里那些用 m3u 直播源添加的频道、或者手动改过的搜索过滤规则，光靠文件可能恢复不完整。我会在换机前对数据源列表页、收藏夹页各截一张图，贴在电脑的笔记里——万一恢复后发现某个收藏丢了，回头看图一眼就能想起来是哪个源加的。
三条路组合起来，基本没什么能丢的。我个人习惯：先跑一次应用内导出 → 再手动拷一次 files/ 目录当冗余 → 截图做最后保险。
换设备迁移：路径和容易断的环节
新盒子到手、TVBox 装完，恢复起来说简单也简单——把备份的 tvbox.json 和数据库拷回去就行。但有几个坑踩过不止一次：
版本兼容性问题：这是最常见的断链点。老版本导出的 tvbox.json 直接导入新版本可能没问题，但反过来不行——新版本加了新字段（比如多源聚合的权重配置、新的接口类型），老版本不认，导入后轻则丢失配置、重则直接崩溃。迁移时尽量用同版本，或者先在新盒子上装一个中间版本当过渡。
接口源本身失效：这是最让人崩溃的。你完美恢复了配置，打开一看——一半的源已经挂了，m3u 里的流媒体地址全是 404。这不是备份的问题，是公开源的天然特性——一份能用 2 到 4 周就大面积失效。我现在备份时会特意在电脑上留一份"备用源清单"（就是从社区、论坛里存下来的几套不同来源的 m3u 和 JSON），恢复完配置立刻补几条新源顶替失效的。
Android 版本权限变化：Android 11 开始对 Android/data/ 目录做了限制，文件管理器不一定能直接访问。老盒子是 Android 8/9，新盒子是 Android 11+，手动拷数据目录可能会被系统拦住。这种情况下要么用应用内导出功能绕开，要么给文件管理器开"所有文件访问权限"，要么干脆走路线一用导出文件恢复。
本地字幕路径失效：之前你把字幕拷在盒子的某个目录（比如 下载/ 或者 Movies/），新盒子上那个路径可能不存在，或者你忘了自己拷哪了。恢复完配置如果有收藏剧集提示"找不到字幕"，别慌——只是路径变了，字幕文件还在旧盒子上，或者你重新拷一份、重新指定路径就行。
退路评估：哪天不想用了，卸载干不干净
先说结论：卸载 TVBox 本身很干净，不残留什么。但有几处要注意：
- 常规卸载：直接在系统应用管理里卸载 TVBox，
Android/data/[包名]/目录会被一并清掉，tvbox.json、数据库、偏好设置全跟着没了。如果你之前没备份，这些数据就找不回来了——所以先备份再卸载。 - U 盘里的备份文件：别忘了你之前拷到 U 盘里的
tvbox.json和数据库，如果 U 盘还连着旧盒子，盒子卖了或扔之前记得拔下来。 - 本地字幕和手动拷的资源：这些在公共目录里，卸载不会删，想彻底清空就自己去删。
- 有没有账号残留？没有。TVBox 不注册、不登录、不绑任何账号，卸载完就干干净净，没有"注销账号"这回事。
一个我觉得值得说的点：因为所有数据都在本地、没有云端上传的需求，卸载 TVBox 不存在"数据被云端保留"的风险。不像某些视频 App 即使你卸载了，账号浏览记录还在它们服务器上存着。从数据隐私角度看，TVBox 反而是安全的。
什么人该先建备份习惯
如果你只是装来尝鲜、看一两天试试——不用折腾备份，直接用就行。
但如果你符合下面任意一条，现在就去导一份配置：
- 已经接了三个以上的数据源、花时间调过接口顺序或聚合权重；
- 收藏夹里有二十部以上在追的剧、历史记录拉了几页；
- 盒子是老设备（意味着它随时可能挂、或者你想换个新的）；
- 你改过播放器内核、字幕偏移、缓冲参数之类的细设置——这些恢复起来比找新源还费时间。
我自己总结的那条退路法则：在你花了超过半小时在配置上之后，就该备份一次。因为后面大概率还会再花半小时去找之前配过的东西。
说到底，TVBox 的数据自主度是这类空壳播放器里最高的一档——全本地、无账号、无强制云端，说带走就能带走。代价就是你得自己操心备份这件事，它不会像自带内容的 App 那样帮你自动同步。好消息是这个"操心"的代价很低：导出一个 JSON 文件、拷一个目录，五分钟的事，能省掉之后好几天的折腾。
本文为个人基于网络公开资料整理编写，非官方内容，仅供学习交流参考；软件版权归原作者所有，请支持正版；使用过程中遇到问题请查阅官方渠道，本文不承担任何责任。
