TVBox 怎么自建接口？用 OpenList 把网盘变成自己的源

前面几篇讲的都是怎么用别人给的接口。用久了会发现一个问题：接口总是会失效，找接口这件事没有终点。这篇讲的是另一条路——把内容源握在自己手里。

公共接口为什么会失效

先理解一件事：你用的那些免费接口，是别人搭好之后分享出来的。搭建者要自己租服务器、自己维护采集和解析，一旦成本上来或者被投诉，关掉就关掉了。你没有任何办法。

具体到失效的环节，通常是这几处：采集站被关停，接口里对应的源就空了；解析服务停止运行，需要跳转的链接就打不开了；域名被屏蔽，整份配置都读不到。这三种坏法都是你不能修的，只能换。

还有个容易被忽略的问题：公共接口能记录你搜了什么、看了什么、什么时间看的。这不是危言耸听，是这类服务的运行方式决定的。

自建的核心价值就在这儿——内容放在你自己的网盘或硬盘上，播放记录只存在你自己的设备里，接口哪天想换就自己改。

路线一：用网盘加 Alist，把内容挂进 TVBox

这是目前最主流的一条路。思路很简单：网盘里的文件本身没法直接被 TVBox 播放，它需要一个翻译层。Alist 干的就是这个活——它把你网盘里的文件列出来，再通过 WebDAV 协议暴露出去，而 TVBox 认识 WebDAV。

这里要提醒一个变化。Alist 在 2025 年经历过一次开源信任风波，社区随后分叉出一个叫 OpenList 的项目，由 OpenList Team 接手长期维护。现在新写的教程基本都转向 OpenList 了，两者用法几乎一致，下面讲的操作在两者上都适用，但部署时建议优先选社区维护的 OpenList，镜像名是 openlistteam/openlist。

需要准备的东西不多：一台能长期开着、能跑 Docker 的设备。旧电脑、NAS、树莓派都行，配置要求很低。再加一个云盘账号，阿里云盘、百度网盘、115 都能挂。

部署就是一条命令的事，把 5244 端口和一个数据目录映射出来：

docker run -d \
  --name openlist \
  --restart unless-stopped \
  -p 5244:5244 \
  -v /opt/openlist/data:/opt/openlist/data \
  openlistteam/openlist:latest

跑起来之后，浏览器打开这台设备的 5244 端口，用启动日志里给出的初始账号密码登录。

登录进去之后，重点是"存储"这一页。在这里把云盘加进去，每种网盘需要的凭据不一样：阿里云盘要一个刷新令牌，通过扫码获取；百度网盘要 PC 端的 Cookie，而且有时效，过期了要重新抓；OneDrive 走 OAuth 授权。如果你只是想放自己硬盘上的片子，选本地存储，填个文件夹路径就行；家里有 NAS 的话，选 SMB 或者 WebDAV 也能直接挂过来。

加完之后记得打开 WebDAV 开关，这一步不开，TVBox 是连不上的。

回到 TVBox 这边，在数据源配置里选择 WebDAV 方式，地址填你这台设备的 IP 加端口加 /dav，账号密码就是 Alist 的登录账号密码。填完保存，你网盘里的目录结构就会出现在 TVBox 里。

有一条必须说清楚：不要把 Alist 暴露到公网。它默认没有强密码策略，一旦被扫到，别人可以直接下载和播放你网盘里的东西，流量算在你头上。局域网内自己用没问题，需要外网访问就老老实实配密码、开强制登录、加一层内网穿透的鉴权。

路线二：小雅，把整套东西打包好

如果你觉得上面这一串步骤太碎，还有更省事的做法：小雅。

它本质上是把 Alist、资源目录、以及一份现成的 TVBox 接口打包在一个容器里。一条 docker 命令拉起来，一个是管理端口，一个是资源端口。进去把阿里云盘的令牌填上，后台就会生成一份 TVBox 订阅地址。

这份地址直接粘进 TVBox 的配置地址框里，就能用了——你等于自己托管了一份接口，而不是去别人那儿讨。

它的代价是依赖阿里云盘的分享资源，所以资源目录需要定期更新，容器也不会替你解决版权问题，只是把来源从"别人的服务器"换成"你自己的盘"。

再进一步：自己写接口

走到这一步，其实你已经具备写接口的条件了。接口就是一份 JSON，最核心的部分是一个站点数组，每个站点写清楚名称、类型和地址，指向你的 Alist 或者你的媒体服务器。

真正需要花时间的是字段规范——什么类型该配哪些参数、解析怎么写、直播怎么挂。这部分建议对着官方文档和现成的公开配置去改，不要从空白文件开始写。改一份能跑通的配置，比从零构建容易十倍。

自写接口最大的好处是完全可控：你想要的站点、你想要的排序、你想关掉的功能，都是你说了算。别人接口挂掉的时候，你这边照常。

直播源也能自己整理

直播这一块同样可以自给自足。公开的 M3U 直播源不少，电视台的官方流地址也能找到。整理成一份自己的频道清单，存在本地或者你自己的服务器上，比用别人拼凑的直播源稳定得多。

整理的原则是宁缺毋滥。几十个稳定的频道，好过几百个点开都是无信号的。

值不值得花这个时间

说点实在的。这套东西搭一次大概要一两个小时，之后你基本可以告别"到处找接口"这件事。

但它有前提：你得有一台常年开机的设备，得愿意折腾命令行，还得接受有些步骤出错时要自己排查。如果你只是偶尔在电视上看看片子，为了这个专门买个树莓派、学 Docker，不划算，继续用公共接口更省事。

真正适合自建的是两类人：家里已经有 NAS 或者软路由的，反正设备在那儿摆着；以及被接口失效折腾烦了、愿意一次性投入换长期省心的。如果你属于这两类，那这件事值得做。