Izuko TV数据源配置:BT、在线源、苹果CMS、WebDAV网盘与Jellyfin新手完整指南

原创2026-11-04 19:44:551,947 阅读
文章标签:移动开发音视频视频跨平台

Izuko TV数据源配置:BT、在线源、苹果CMS、WebDAV网盘与Jellyfin新手完整指南

Izuko TV 是一款面向 Android TV 的追番客户端,基于 Animeko 修改并直连 Bangumi。本文带你完成 Izuko TV 数据源配置的完整入门:5 类数据源(BT 源、在线源、苹果 CMS、WebDAV 网盘、Jellyfin)各自适合什么场景、在哪个入口添加、新手常踩的坑怎么避开,一次讲清楚。

Izuko TV 探索页海报墙与番剧推荐界面

视频从哪来:5 类数据源怎么选

Izuko TV 本身不存储、也不提供任何视频资源,播放的每一集都来自你配置的数据源。官方文档明确列出支持的数据源类型,源码级说明见 docs/contributing/code/media/media-source.md:

数据源类型 典型代表 适合谁
BT 源 动漫花园(DMHY)、蜜柑计划(Mikan) 想要边下边播、不担心版权风险的新手,开箱即用
在线源 Selector 网页源、JSON API 接口源、RSS 源 有固定追番站点、追求即点即播的用户
规则源 / 苹果 CMS AniBaka 规则、苹果 CMS 站点 站点结构特殊(接口取剧集、播放页需嗅探)的用户
网盘源(含 WebDAV) 自建 NAS、各网盘协议 已整理好本地番剧库、想走内网播放的用户
Jellyfin / Emby 自托管媒体服务器 已经跑着 Jellyfin 媒体库、希望电视直接对接的家庭用户

几个关键特性值得先知道:

  • BT 源边下边播:底层沿用 libtorrent 引擎,下载即可播放,还能提前缓存到本地;本着互助精神,使用 BT 源时会自动做种。
  • 自动选源:多源并发查询后按数据源"阶级"排序挑选,优质源(阶级 0)有精确匹配时会立即选中,无需等待其他源。
  • 在线源需要网页验证码时:用方向键移动页面中间的光标、确认键点击即可,详见 docs/guide/usage.md。

数据源管理入口在哪里

电视端入口是「设置 → 数据源管理」:

  • 这里能排序(长按确认键拿起一行、上下键移动、确认键放下)、启用/停用、删除数据源;
  • 添加和编辑数据源则统一在 Web 控制台里完成——电视遥控器打字不方便,这正是控制台存在的意义。

Izuko TV Web 控制台手机扫码管理数据源

打开 Web 控制台:在播放器以外长按返回键或播放键打开动作面板,用手机扫右上角的二维码即可,无需在手机上安装任何应用。

BT 源配置:动漫花园与蜜柑计划

BT 源(动漫花园、蜜柑计划)属于内置支持的数据源,一般随订阅默认带来,新手不需要自己写任何配置。原理与源码:

使用建议:

  1. 确认电视网络能正常访问对应站点(连不上可在「设置 → 代理」里为站点配置代理);
  2. 选源面板中 BT 栏与在线栏分开显示,种子资源只在 BT 栏出现;
  3. 续作番(字幕组常只写系列名不写季号)BT 源会用条目的系列名额外搜索一次并自动甄别集号,配置时无需干预;
  4. 注意 Android 7.1 设备上应用退到后台后 BT 下载可能被系统停掉,建议 8.1 及以上系统。

在线源与苹果CMS:Selector、JSON API 与规则源

在线源是新手添加最多的类型。Izuko TV 提供三种通用写法,都在 Web 控制台的「数据源」里创建:

Selector 网页源(最简单)

适合"搜索页 → 条目页 → 播放页"三段结构的标准站点,只写 CSS Selector 与正则即可使用,不需要编程知识。若只想浏览手动选集,写列表规则就够;想让应用自动认出当前剧集,再补上自动匹配(集号正则、线路名正则等)。

JSON API 接口源

站点内容只经 JSON 接口(通常是 POST)加载、HTML 页面里没有数据时用它。配置按三个阶段描述:搜索条目、取剧集列表、为一集签发播放地址,每个阶段是"请求模板 + 几个 JSONPath 表达式"。

规则源与苹果 CMS

站点结构特殊(剧集表写在脚本里、播放地址要再请求接口、多种取法之间回落)时用规则源:规则分搜索、详情、播放三段,每段是一串步骤,由规则引擎依次执行。其中内置了专门的苹果 CMS 步骤:

  • maccmsEpisodes:按 vod_play_from / vod_play_url 拆解苹果 CMS 视频接口里的线路与剧集;
  • maccmsPlayer:解析苹果 CMS 播放页。

另外可直接导入 AniBaka 规则(anx-rule/2 格式):Web 控制台的导入接受规则 JSON 或规则库索引地址,订阅地址也可以直接填 AniBaka 规则库索引,每次更新订阅都会自动重新下载并转换。规则源还可以按库内标注的广告情况自动定阶级(无广告 0、少广告 1、有广告 3),播放质量自动分层。

Izuko TV 详情页分集剧照与剧集列表

WebDAV 网盘配置:三步接入自己的 NAS

家里有 NAS 或 WebDAV 服务器、番剧已按文件夹整理好的话,走 WebDAV 是延迟最低的方案。配置步骤:

  1. 打开 Web 控制台,在数据源里添加 WebDAV 网盘,填写:名称、服务器地址、媒体文件夹(番剧所在目录);
  2. 账号密码单独保存(登录用账号密码,Basic 认证),不会随数据源配置导出,备份换电视时不用重新填;
  3. 保存后默认阶级为 T0(最高质量档),选源时优先被选中。

内部机制一句话版:WebDAV 没有服务端搜索,客户端会按配置的目录深度建立媒体文件夹索引,按条目名在索引里找番,列目录用 PROPFIND,播放直链就是文件在服务器上的地址;还会自动读取候选视频的文件头补上分辨率和码率,方便你在选源面板对比。相关说明见 docs/contributing/code/media/media-source.md 的"网盘数据源"一节。

除了 WebDAV,网盘数据源还支持协议驱动的第三方网盘:网盘的地址、参数、扫码登录步骤都写在协议 JSON 里,支持三种玩法——在自己网盘里按条目名搜视频、给条目添加别人的分享链接、从固定分享合集找分享并转存后播放。

Jellyfin / Emby 配置:媒体库直连

已部署 Jellyfin(或 Emby)的用户,电视端可以完全跳过 BT 和在线源。配置要点:

  • 数据源类型为 JellyfinMediaSource / EmbyMediaSource,在 Web 控制台填入服务器地址与登录凭据;
  • 媒体库里的番剧按标题匹配条目,Bangumi 条目的 ProviderIds 会自动关联 Jellyfin 媒体库条目,匹配精度比纯标题搜索高;
  • 认证失效时客户端会自动重新获取授权并重试,一般无感。

核心实现位于 datasource/jellyfin/src/commonMain/kotlin/BaseJellyfinMediaSource.kt,同目录还有 JellyfinMediaSource.kt 与 EmbyMediaSource.kt;类似的自托管媒体库还支持 Ikaros,见 datasource/ikaros/。

Izuko TV 播放器全屏播放界面

订阅管理与自动选源技巧

数据源配置完成后,日常使用围绕两个机制:

订阅:一次添加,持续更新

数据源按"订阅"分组管理,订阅地址填一个 URL 即可。订阅更新时按名字对应新旧:新源加入、被删的移除、同名源原地换配置;默认保留你手动调过的顺序,新加源排在最后。TV 设置里的订阅开关可批量启用/禁用该订阅下所有源,单个源仍可独立开关。

排序与阶级:让好源先被选中

  • 「设置 → 数据源管理」长按排序:把 BT 优质源、自家 WebDAV / Jellyfin 排前面;
  • 数据源阶级(tier)数值越小优先级越高,阶级 0 的 WEB 源查到精确匹配会被立即选中,不用等别的源查询结束;
  • 同一源的某条线路(channel)可以单独定阶级,例如把某源的广告线路调低。

Izuko TV 选源与番剧搜索界面

新手常见问题

结合 docs/guide/faq.md 与 docs/guide/usage.md 整理:

  • 播放失败自动换源吗? 会。播放器上键打开选源面板,可手动切换线路;自动选择失败后会走兜底逻辑继续尝试其他数据源。
  • 在线源弹出网页验证码? 用方向键把页面中间的光标移到验证码上,确认键点击;验证通过一般自动关闭,没关就长按确认键。
  • 换电视如何迁移? 新电视经局域网把旧电视的用户、设置和数据源一次搬过来;设置也可导出成文件备份(WebDAV 的账号密码除外,需重新填写)。
  • 连不上 Bangumi? 与数据源无关,是番剧信息通道问题:「设置 → 代理 → Bangumi 连接方式」有四条线路(官方、自建镜像、加密直连、社区镜像)按顺序自动尝试。
  • Android 7.1 注意什么? 用文件名带 legacy 的兼容包;BT 源在应用退后台后可能被系统停掉,详见 docs/guide/install.md。

小结

Izuko TV 的数据源体系对新手很友好:BT 源开箱即用,在线源与苹果 CMS 靠通用配置即可接入,WebDAV 和 Jellyfin 让自建媒体库成为最高优先级的播放源。建议的组合拳是——Jellyfin / WebDAV(本地库)+ 动漫花园 BT + 一个常用在线源订阅,再在「设置 → 数据源管理」里把本地源排到最前,即可获得即点即播的体验。更多机制细节可继续阅读 docs/contributing/code/media/media-source.md 与 docs/contributing/code/media/media-selector.md。

登录后查看全文
izuko-tv