家庭影院 TV 指南——从 TVBox 到 DIY 一站式搭建

一、前言

智能电视或电视盒子是家庭娱乐的核心设备。但大部分智能电视自带的资源有限，广告多、会员贵、片源分散。通过第三方工具组合，可以让电视真正成为「想看什么看什么」的家庭影院。

本文从软件选型、数据源配置、DIY 改造到长期维护，提供一套完整的解决方案。

硬件要求

硬件不需要很高配置。如果智能电视比较新（Android 7+），直接在电视上安装即可；如果电视比较老（如小米电视 2），建议配合电视盒子使用。

二、TVBox 系列

TVBox 是目前最流行的开源电视播放方案，社区活跃，衍生版本众多。它的核心原理是通过配置数据源接口来获取影视和直播内容。

所有 TVBox 系列 App 本身只是一个播放器壳子，内容完全由数据源决定。

2.1 小黑盒（原版 TVBox）

项目地址：o0HalfLife0o/TVBoxOSC → 已归档，迁移至 j4Uq/TVBoxOSC

• 图标：黑色盒子
• 最新版本：20260227-1116（2026-02-27 更新）
• 特点：开源原版，代码干净，无内置数据源
• 局限：只支持点播（VOD），不支持直播

这是 TVBox 家族的老大哥，其他所有版本都基于此修改。如果你需要最纯粹的 TVBox 体验或进行二次开发，选这个版本。

2.2 小白盒（点播+直播增强版）

发布页：q215613905/TVBoxOSCRelease 源码：q215613905/TVBoxOS（2,689 ⭐）

• 图标：白色盒子
• 最新版本：20251016-2311（2025-10-16 更新）
• 特点：在小黑盒基础上恢复了直播功能，同时支持点播+直播

小黑盒废弃直播功能后，小白盒成了同时支持点播和直播的最佳选择。如果你「要点播追剧 + 直播看电视」，小白盒最合适。

2.3 小彩盒 / OK 影视（推荐）

发布页：FongMi/Release（6,065 ⭐，分支: fongmi） 源码：FongMi/TV（8,179 ⭐）

• 图标：彩色盒子
• 版本区分：mobile = 手机版（触摸操作），leanback = 电视版（遥控器操作）
• 下载：从 Releases 页面下载对应 apk

OK 影视是当前综合体验最好的 TVBox 衍生版。界面操作逻辑更符合电视遥控器习惯，解码兼容性也做了大量优化。如果你只想装一个 App 不想折腾，OK 影视是首选。

2.4 TVBox 系列对比一览

选择建议：

• 如果你要二次开发或研究源码 → 小黑盒（原版代码最干净）
• 如果你要点播+直播全功能 → 小白盒
• 如果你是普通用户，只想装一个就直接用 → OK影视（小彩盒）

三、其他 App

3.1 内置版（打包党版本）

市面上存在大量「内置版」TVBox——基于开源代码修改后内置了数据源，重新打包加壳发布。对于不想折腾配置的用户，安装即用确实方便。

推荐渠道：影用仓库 — 提供多种内置版下载，如影视仓内置版

⚠️ 风险提示：打包党内置的数据源随时可能失效，失效后需要重新下载新版。更严重的是，闭源加壳的 App 可能存在恶意代码风险（窃取隐私、插入广告等），谨慎使用。

3.2 网易 Filmly

网易 Filmly 是网易出品的影视资源挂载工具，支持：

• 百度网盘挂载
• 阿里云盘挂载
• WebDAV 挂载
• SMB 本地共享挂载

实测问题：

1. 百度网盘（已购 VIP）播放卡顿
2. 海康智存 SMB 同步时崩溃

推测这是网易的试水产品，目前还不够成熟，建议观望。

3.3 alist

alist（GitHub: AlistGo/alist 最新版: v3.61.0）是一个多存储文件列表/WebDAV 程序，支持数十种存储协议：本地存储、百度网盘、阿里云盘、OneDrive、Google Drive、S3、WebDAV、SFTP 等。

为什么需要 alist

TVBox 的在线数据源不稳定（经常失效），而云盘（百度网盘、阿里云盘）的资源是稳定的。alist 的作用就是将你的云盘文件变成 TVBox 可识别的 WebDAV 接口，让你在 TVBox 上直接播放云盘里的电影，不受数据源失效的影响。

安装部署

方案一：Docker（推荐，最简单）

# 一键启动
docker run -d --restart=always -p 5244:5244 -v /etc/alist:/opt/alist/data xhofe/alist:latest

# 查看初始密码
docker exec -it alist ./alist admin

方案二：一键脚本（适合 Linux 服务器）

curl -fsSL "https://alist.nn.ci/v3.sh" | bash -s install

方案三：Windows 直接运行

从 Releases 下载 alist-windows-amd64.zip，解压后运行：

alist.exe server
浏览器打开 http://localhost:5244
首次启动会自动生成随机密码

配置使用

1. 启动后浏览器访问 http://<你的IP>:5244（默认端口 5244）
2. 使用管理员账号 admin + 初始密码登录（可在启动日志中查看）
3. 进入「管理 → 存储」添加你的云盘：

1. 添加后，开启「WebDAV 开关」即可通过 WebDAV 暴露给 TVBox

在 TVBox 中使用

在 TVBox 的数据源配置中，选择 WebDAV 方式：

• WebDAV 地址：http://<你的IP>:5244/dav
• 账号/密码：alist 的登录账号密码
• 配置后即可浏览和播放挂载的云盘文件

注意：alist 自用够了，不要公开暴露到公网，否则可能被盗刷流量。家庭使用建议在局域网内运行。

3.4 Kodi（进阶推荐）

Kodi 是开源全能媒体中心，支持几乎所有格式的视频播放。它是历史最悠久的家庭影院软件之一（前身是 Xbox Media Center），社区庞大，插件生态极其丰富。

Kodi vs TVBox：如何选择

安装部署

Android TV / 电视盒子：

1. 从 kodi.tv/download 下载 Android 版 APK
2. 或从各大应用市场搜索 Kodi 安装
3. 最新稳定版为 Kodi 21（Omega）

Windows / macOS / Linux：

# Windows 从官网下载安装包
# macOS
brew install --cask kodi
# Linux（Ubuntu/Debian）
sudo apt install kodi

配置 IPTV 直播

1. 安装 PVR IPTV Simple Client 插件：
   • 进入 Kodi → 插件（Add-ons）→ 从仓库安装 → PVR IPTV Simple Client
   • 或搜索安装：kodi-addon-pvr-iptvsimple
2. 配置 M3U 直播源：
   • 进入 Kodi → 设置 → 插件 → PVR IPTV Simple Client → 配置
   • 在「M3U Play List URL」填入直播源地址（如 https://raw.githubusercontent.com/YanG-1989/m3u/main/live.txt）
   • 重启 Kodi，直播频道会自动加载

配置本地媒体库

1. 进入 Kodi → 设置 → 媒体 → 视频
2. 添加视频源（SMB/NFS/本地文件夹）
3. 设置内容类型（电影/电视剧）
4. Kodi 会自动扫描并刮削元数据（海报、简介、评分）

常用插件推荐

适用场景

Kodi 适合以下用户：

• 有 NAS 或大量本地视频文件
• 对元数据刮削有要求（海报墙、演员信息）
• 需要完整的家庭影院体验

如果只是看在线直播和点播，TVBox 已经够用，不需要 Kodi。

四、数据源

数据源是 TVBox 的灵魂——没有数据源，App 就是一个空壳。

4.1 点播源

# ── 经典点播接口 ──

# 饭太硬系列（TVBox 圈最经典的源之一）
http://饭太硬.com/tv
http://fanty.top/tv          # 饭太硬备用域名
http://www.饭太硬.top/tv

# 社区长期维护接口
http://ok321.top/tv          # OK 影视配套接口
http://刚刚.live/zb          # 刚刚系列
http://刚刚.love

# GitHub 托管配置（相对稳定）
https://raw.githubusercontent.com/gaotianliuyun/gao/master/9918.json
https://raw.githubusercontent.com/gaotianliuyun/gao/master/9918.mp

4.2 直播源

# ── 社区维护的直播接口 ──

# 多仓直播接口（推荐，包含多个直播源的聚合）
http://tv.nxog.top/m/

# m3u 格式直播源
https://raw.githubusercontent.com/YanG-1989/m3u/main/live.txt
https://raw.githubusercontent.com/YueChan/Live/main/IPTV.m3u

# 全球 IPTV（英文频道为主）
https://iptv-org.github.io/iptv/index.m3u

数据源使用技巧：

1. 多仓优先：单仓数据源容易失效，多仓（Multi-store）会配置多个备选源，自动切换
2. 本地缓存：将常用接口保存到手机备忘录，方便失效时快速重新输入
3. 定期刷新：建议每季度检查一次数据源是否可用。数据源的生命周期通常为 3-12 个月
4. 优先级排序：GitHub raw 链接 > 个人域名 > 免费域名。GitHub 托管的最稳定

4.3 寻找数据源的渠道

数据源经常失效，掌握「怎么找新的」比记住某个地址更重要。

开源仓库（长期有效）

在线聚合站

TVBox 相关开源项目导航

除了数据源本身，以下项目也值得关注：

搜索技巧

在 GitHub 或搜索引擎搜索以下关键词：

• TVBox 接口 2026
• 直播源 m3u
• tvbox 数据源 json
• iptv live

使用建议

1. 多仓配置：使用多仓接口（Multi-store）而非单仓，一个失效自动切换
2. 本地保存：将稳定的数据源 URL 保存到手机备忘录，方便重新输入
3. 定期检查：数据源生命周期通常 3-12 个月，建议每季度检查一次

五、DIY——编译自己的 TVBox

GitHub 开源的 TVBox 虽然好用，但每次配置数据源对家人和普通用户来说还是太麻烦。本节教你怎么编译一个「安装即用」的定制版。

5.1 准备工作

以 o0HalfLife0o/TVBoxOSC（最新版本 20260227-1116）为例：

1. 克隆源码或用 AndroidStudio 打开
2. 因依赖版本过旧，需要调整 Gradle 配置

常见编译错误修复：

① Gradle 版本

• gradle-wrapper.properties：将 distributionUrl 改为 https\://services.gradle.org/distributions/gradle-8.10.2-bin.zip
• 项目级 build.gradle：classpath 'com.android.tools.build:gradle:8.8.1'

② namespace 转换 AndroidStudio 的 AGP 升级向导可自动完成。如果仍有问题，手动在模块的 build.gradle 的 android 节点下添加 namespace '包名'（包名在 AndroidManifest.xml 中查看）。

③ 找不到 R.id.loading 直接注释该行——后端代码未使用这个变量。

5.2 内置数据源

找到设置页面的数据源输入框，通过搜索「设置」逐步定位：

dialog_api.xml → ApiDialog → inputApi

核心代码：

//内置网络接口在此处添加
inputApi.setText(Hawk.get(HawkConfig.API_URL, ""));

将默认参数改为你的数据源地址：

inputApi.setText(Hawk.get(HawkConfig.API_URL, "http://ok321.top/tv"));

这样安装后打开 App，进入设置页面，数据源已经填好，点击确定即可使用。

5.3 进一步：安装即用（免配置）

如果连点击确定都嫌麻烦，可以直接修改初始化代码：

1. 故意填一个错误的数据源，重新打开 App 会弹出「拉取配置失败」
2. 搜索这个字符串，定位到类 ApiConfig
3. 在 loadConfig 函数中找到：

String apiUrl = Hawk.get(HawkConfig.API_URL, "");

1. 把默认空字符串改为你的数据源地址：

String apiUrl = Hawk.get(HawkConfig.API_URL, "http://ok321.top/tv");

5.4 去除启动弹窗

App 每次启动弹出「自定义jar加载成功」，搜索代码直接注释相关行即可。

5.5 打包

AndroidStudio → Build → Build APKs → Build

生成 debug 安装包，安装即用。

六、总结与推荐组合

核心原则

1. 选开源不选闭源：开源版没有后门，可长期使用
2. 数据源比 App 重要：学会找数据源是核心技能
3. 自己编译最安心：花一次时间编译，一劳永逸，家人也能用

本文持续更新，如有新的工具或数据源，欢迎补充。

参考资料

• o0HalfLife0o/TVBoxOSC → j4Uq/TVBoxOSC
• q215613905/TVBoxOSCRelease
• FongMi/Release
• AlistGo/alist
• iptv-org/iptv