甄宝园甄宝园
项目推荐 软件下载 资源聚合 实用教程
全站栏目
网站首页
项目推荐
在线工具库 人工智能库 趣味网站库 办公助手库 下载助手库 影视电视库 系统维护库 软件资源库 学习教育库
软件下载
电脑软件 电视软件 安卓软件 其它软件
资源聚合
直播源专题 打印机专题 TVBox 专题
实用教程
电视教程 电脑教程 手机教程 其它教程
网站地图 标签索引 在线留言
首页/ 资源聚合/ TVBox 专题/ 正文
TVBox 专题

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

2026-10-04 浏览 780 约 10 分钟
专题TVBox 专题
篇数共 9 篇
预计阅读约 10 分钟
更新时间2026-10-04
查看专题目录(9 篇) ← 上一篇

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

公共接口为什么会失效

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

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

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

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

路线一:用网盘加 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 是连不上的。

OpenList 的网页界面,挂载好的网盘会以文件列表呈现,TVBox 通过 WebDAV 读到的就是这份目录结构
OpenList 的网页界面,挂载好的网盘会以文件列表呈现,TVBox 通过 WebDAV 读到的就是这份目录结构

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

TVBox 设置页,接口与播放相关的配置都在这一层
TVBox 设置页,接口与播放相关的配置都在这一层

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

路线二:小雅,把整套东西打包好

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

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

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

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

再进一步:自己写接口

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

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

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

直播源也能自己整理

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

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

值不值得花这个时间

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

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

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

合规提示:文中涉及的示例均为公开渠道获取的技术内容,仅用于说明原理与工具用法。请在合法范围内使用,不要传播、售卖或用于商业用途。
OpenList 网盘挂载 WebDAV 私库

继续读

TVBox 搜不到片、播放卡顿怎么办?按这个顺序排查下一篇去看 用 TVBox 有哪些风险?版权边界、jar 包安全与自我保护上一篇去看

相关推荐

按标签自动匹配

© 2026 甄宝园 zby365.com网站地图电脑版

本站内容均来自网络收集整理,仅供学习交流。如侵犯了您的合法权益,请发邮件至 717058319@qq.com,核实后尽快处理。