飞牛影视在线扩展 fnmedia-ext：在线媒体库（豆瓣榜单 + 海量分类无限滚动）、原生搜索、多线路播放与智能续播

本项目由Ai驱动

交流群：895685143

大家好，分享一个为飞牛影视 trim.media 做的第三方在线资源扩展：fnmedia-ext（飞牛影视在线扩展）。

它在不改动官方影视程序、数据库的前提下，给飞牛影视增加两类能力：

• 在线媒体库：媒体库首页直接出现 8 个在线库，电影 / 剧集 / 动漫 / 综艺各两套——一套豆瓣真实榜单（精选、带评分海报），一套资源站海量分类（每库数千部、往下滑无限加载、点开即播）；

• 原生搜索聚合：在飞牛影视自带搜索框搜片名，结果里出现带 【在线】 标识的条目，用飞牛原生播放器直接播放。

支持多线路切换、播放记录、继续观看、剧集智能续播，停用或卸载后自动还原官方影视服务。

⚠️ 免责声明（请务必先阅读）

1. 本扩展是一款开源、免费的技术研究 / 个人媒体库工具，仅在用户自己的 NAS 上运行，本身不提供、不存储、不上传、不分发任何影视、图片、字幕或播放地址，也不含任何影视资源数据库。

2. 扩展播放与榜单所涉及的一切内容，均来自互联网上的公开第三方接口及公开榜单，相关版权归原权利人所有；本项目不依附、不代表任何资源提供方，也不对任何第三方内容负责。

3. 本项目不提供、不推荐、不收集、不解答任何资源站点的名称、地址或获取/接入方法；是否配置、如何配置接口完全由用户自行决定，用户应自行核实来源合法性。

4. 本工具仅供学习交流与个人合法播放自有 / 已获授权内容使用，请遵守所在地法律法规；请勿用于商业用途，请勿下载、传播侵权内容。若因使用本工具产生任何法律责任，由使用者自行承担，与作者无关。

5. 如任何第三方认为本工具涉及其权益，请通过仓库 Issue 联系，作者将及时处理。

一、效果简介

安装并启用扩展后，打开官方「影视」应用：

1）媒体库首页多出 8 个在线库（本版重点）

豆瓣真实榜单（精选）

• 🎬 热门电影、📺 热门剧集、🌸 动漫新番、🎤 热门综艺；

• 每库约一百多部，来自豆瓣周榜与豆瓣标签推荐，带海报、评分、年份、简介；

• 榜单展示的是“大家在看什么”，而不是资源站“刚录入了什么”；

• 点进某部片时才用片名实时聚合在线资源，命中即可播放；确实没有片源会明确提示「暂无在线片源」，不会假装能播。

资源站海量分类库（无限滚动）

• 🎞 海量电影、📺 海量剧集、🌸 海量动漫、🎤 海量综艺；

• 每库可达 约 5000 部（综艺约 2900+），往下滑持续自动加载，适配飞牛原生的瀑布流列表，到底自然停止；

• 分类数据在后台自动归并，并剔除伦理、福利、解说、预告、体育、短剧等杂类；

• 条目自带播放地址，点开就能播，不需要先搜索；主力资源站某页失败会自动切换其它线路。

2）原生搜索与播放（沿用旧版能力）

• 在飞牛影视原生搜索中展示在线影视结果，在线结果默认排在本地结果前面；

• 沿用飞牛原生播放器，不需要额外安装播放器，支持 m3u8、mp4；

• 服务端代理 HLS 分片、AES 密钥、Range、Referer、UA 等；

• 多个资源站命中同一部影片时自动聚合成一个条目，播放器设置 / 清晰度菜单即线路菜单；

• 支持播放记录、继续观看、未看完续播、看完自动下一集；

• TV 剧集点主播放按钮即可：未观看播第 1 集，看到一半恢复到对应集和秒数。

3）其它

• 内置应用内管理页，可启用 / 停用 / 添加 / 删除 / 测速资源线路，可开关在线媒体库、设置榜单刷新间隔、手动立即刷新；

• 海报统一走内置图片代理（豆瓣图床自动带 Referer、外站防盗链失效时回退占位图），不裂图；

• 通过 FPK 安装，停用或卸载后自动还原官方影视服务。

二、适配版本

请在安装前确认版本：

扩展不会修改官方影视二进制、nginx 或数据库，而是通过 Unix Socket 做可逆接管。停用或卸载时会自动把官方 /var/run/trim_media.sock 还原。

如果未来飞牛影视升级后修改了接口结构、签名常量或 Socket 协议，可能需要等待本项目适配；停用扩展即可立即恢复官方影视。

三、下载地址

GitHub 仓库：

https://github.com/yujian0815/fnmedia-ext

最新 Release（v0.1.3）：

https://github.com/yujian0815/fnmedia-ext/releases/tag/v0.1.3

📌 各版本更新记录见 2 楼。

请下载附件：

fnmedia-ext-0.1.3.fpk
​

附件：fnmedia-ext-0.1.3.zip

SHA256：

69dc6a0b949d3774024a53c4f95f5c4dd6cb4bc9a02a0a6c20e947f82d010fe0
​

已安装 0.1.2 的可直接覆盖升级，线路配置与本地缓存会保留。

四、安装方法

1. 准备工作

确认官方「影视」应用已经安装并且可以正常打开。

建议先把飞牛系统和影视应用更新到已验证版本附近。如果系统提示第三方应用风险，请确认下载来源后再继续。

2. 手动安装 FPK

1. 打开 fnOS 应用中心；

2. 选择 手动安装 / 安装 FPK；

3. 上传或选择 fnmedia-ext-0.1.3.fpk；

4. 选择应用安装的数据卷；

5. 确认依赖应用 影视 (trim.media)；

6. 等待安装完成；

7. 安装完成后启用「飞牛影视在线扩展」。

安装过程中会自动：

• 在应用目录创建独立 Python 虚拟环境；

• 安装 fastapi、uvicorn、httpx；

• 注册并启动 fnmedia-ext.service；

• 启动应用内管理页网关；

• 可逆接管官方影视 Socket。

升级安装后首次进入媒体库，海量库分类路由需要几秒钟在后台建立；稍等或下拉刷新一次即可出现。

3. 打开管理页

安装成功后，应用列表或桌面中会出现：

影视在线扩展管理
​

也可以在应用中心打开该应用。管理页内部路径为：

/app/fnmedia-ext/
​

管理页中可以查看扩展运行状态、管理线路、测速、调整搜索和过滤设置，以及在线媒体库的开关与榜单刷新。

五、使用方法

1. 浏览在线媒体库（新）

1. 打开官方「影视」，进入媒体库首页；

2. 在媒体库列表找到 8 个在线库：4 个「热门 / 新番」豆瓣榜单库 + 4 个「海量」分类库；

3. 进入任一库，网格里直接浏览海报，往下滑会持续自动加载，无需翻页；

4. 点击海报进入详情，再点播放按钮即可。

说明：

• 豆瓣榜单库是精选榜单，第一次点进某部片需要几秒用片名在线匹配片源，之后再次打开是秒开；个别冷门新综艺可能提示暂无片源。

• 海量分类库按资源站分类直接列出，条目本身就带播放地址，点开即播，适合漫无目的“一直刷”。

• 两类库都支持电影 / 剧集类型筛选，榜单库还支持按评分、年份、片名排序。

2. 搜索影片

1. 打开官方「影视」；

2. 在搜索框输入完整中文片名；

3. 找到标题前带 【在线】 的结果；

4. 点击进入详情；

5. 直接点击播放按钮。

建议输入完整中文片名后再搜索。纯拼音碎片、不完整词可能无法命中在线结果。

3. 切换线路

如果当前线路卡顿或无法播放：

1. 打开播放器的设置 / 清晰度菜单；

2. 菜单中会显示当前影片可用的播放线路；

3. 选择其他线路；

4. 播放器会重新请求对应线路的播放地址。

不同线路的清晰度、码率和分片数量可能不同。某条线路失效时，换一条线路即可。

4. TV 剧集续播

不需要先进入画报或详情页手动找某一集。

在剧集主页面直接点击播放按钮时：

• 没看过：播第 1 集；

• 第 1 集看到一半：继续第 1 集和上次时间点；

• 前两集已看完、第 3 集看了 40%：直接播放第 3 集并恢复到约 40%；

• 当前集看完：自动播放下一集。

播放进度保存在本扩展自己的本地状态文件中，不写入官方影视数据库。

六、管理页功能

「影视在线扩展管理」页面提供以下功能。

1. 在线媒体库（热门榜单媒体库）

• 一键开关在线媒体库（关闭后媒体库首页恢复成原样，不影响搜索）；

• 设置豆瓣榜单自动刷新间隔（1–24 小时）；

• 手动「立即刷新」榜单；

• 显示四个榜单库与四个海量库的条数、数据源状态和刷新时间。

2. 线路管理

• 查看当前线路列表；

• 启用或停用某条线路；

• 删除不需要的线路；

• 添加自定义接口；

• 单条线路测试；

• 全部线路测速。

测速结果会显示搜索耗时、命中条数和直链情况，方便保留响应更快的线路。

3. 搜索设置

• 在线结果是否前排展示；

• 每个关键词最多注入多少条在线结果；

• 启用或关闭噪音过滤。

4. 噪音过滤

默认会过滤电影解说、预告片、花絮、抢先版、动态漫画等不适合正片播放的结果。

也可以在管理页自定义过滤关键词。

七、工作原理

整体链路如下：

浏览器 / 飞牛 App
        ↓
nginx (/v)
        ↓
/var/run/trim_media.sock
        ↓
fnmedia-ext 代理
        **─ 普通请求 → 原样转发官方 trim.media
        **─ 媒体库请求 → 注入豆瓣榜单四库 + 海量分类四库（分页 / 无限滚动）
        **─ 搜索请求 → 合并在线结果和本地结果
        **─ 详情 / 剧集 / 播放请求 → 构造飞牛播放器需要的数据
        **─ /v/media/online/* → 代理 m3u8、mp4、分片、密钥、海报等
​

• 榜单库：后台定时拉取豆瓣周榜与标签推荐，原子缓存到本地，进入页面只读缓存、秒开；点击条目时才用片名在线匹配片源。

• 海量库：后台定时拉取各资源站的分类表并归并为四大类，浏览时按分类逐页取数（每页 20 条），服务端把官方前端的分页请求换算成对应分类页，跨页取数、全局去重、不足一窗自动补页，所以滚动连续、不重复、不缺行。

接管过程是原子的：

1. 扩展先确认官方 Socket 属于官方 trim-media 程序；

2. 在私有 Socket 上启动代理并完成健康检查；

3. 健康检查通过后原子换名接管；

4. 扩展退出、崩溃或停用时自动换回官方 Socket。

因此不会出现“官方影视和扩展都无法启动”的持久破坏状态。

八、常见问题

1. 安装后桌面没有看到入口？

尝试：

1. 刷新飞牛 Web 页面；

2. 重新进入应用中心；

3. 确认「飞牛影视在线扩展」状态为运行中；

4. 停用后重新启用一次。

2. 媒体库首页没看到在线库？

• 升级 / 重启后首次需要几秒建立海量库分类，稍等后下拉刷新一次；

• 确认扩展正在运行、管理页里「在线媒体库」已开启；

• 确认 NAS 能正常访问外网；

• 在管理页对线路做一次测速，确认至少有线路可用。

3. 榜单里某部片点进去提示「暂无在线片源」？

豆瓣榜单覆盖的影片比资源站收录的更多，少数冷门片或很新的综艺可能暂时没有可播片源，这是正常现象，换一部即可；海量分类库里的条目则都来自资源站，基本点开就能播。

4. 榜单条目第一次打开有点慢？

首次打开需要用片名在线聚合搜索片源，约几秒；匹配结果会缓存，之后再打开是秒开。海量库没有这个过程。

5. 搜索不到【在线】结果

可以按下面顺序检查：

1. 确认扩展正在运行；

2. 确认官方影视应用正常；

3. 换完整中文片名搜索；

4. 打开管理页检查线路是否启用；

5. 对线路执行测速；

6. 检查 NAS 是否能访问外网；

7. 检查标题或备注是否命中了噪音过滤词。

6. 有搜索结果但无法播放

可能是当前线路失效。请在播放器设置 / 清晰度菜单中切换其他线路。

如果所有线路都不能播放，可能是临时网络问题或线路暂时不可用，可以稍后再试。

7. 播放卡顿

• 先切换其他线路；

• 检查 NAS 网络；

• 避开高峰期；

• 在管理页测速后保留响应更快的线路。

8. 会不会修改官方影视数据库？

不会。扩展只接管本地 Unix Socket 请求并注入在线内容。榜单缓存、播放记录保存在扩展自己的本地状态文件中，不改官方数据库。

9. 如何恢复官方影视？

在应用中心停用扩展即可，Socket 会自动还原给官方影视服务。

卸载扩展也会执行还原流程。

10. 在线片源从哪里来？能不能提供或推荐资源站？

扩展自身不提供任何片源，所有内容均来自互联网上的公开第三方接口。作者不提供、不推荐、不收集、也不会解答任何资源站点的名称、地址或获取方法；管理页仅提供“启用 / 停用 / 添加 / 删除接口”的功能，具体接口由你自行配置并自行核实来源合法性。

11. 会有版权问题吗？

本工具只是在你自己的 NAS 上运行的播放 / 聚合程序，不存储和分发任何内容；但播放的在线内容版权归原权利人。请仅用于学习交流与个人合法观看自有 / 已授权内容，不要下载或二次传播。若你所在地法律法规不允许，请停用本工具。

九、隐私、版权与安全说明

内容与版权

• 扩展不提供、不存储、不上传、不分发任何影视 / 图片 / 字幕 / 播放地址，也不内置影视资源数据库；所有在线内容与榜单信息均来自互联网公开的第三方接口与公开榜单，版权归原权利人所有；

• 本项目不提供、不推荐、不解答任何资源站点的名称、地址或获取方法，具体接口由用户自行配置并自行核实合法性；

• 仅供学习交流与个人合法播放自有 / 已授权内容，请勿商用或传播侵权内容；由使用本工具引发的法律责任由使用者自行承担。

隐私与系统

• 扩展不会收集飞牛账号密码；

• 不修改官方影视二进制、nginx 或数据库；

• 榜单缓存、播放进度、线路配置和资源缓存保存在 NAS 本地应用目录；

• 停用或卸载扩展会恢复官方影视 Socket；

• 播放在线内容时，请求由 NAS 发出，请自行评估网络访问风险。

十、卸载方法

在 fnOS 应用中心找到「飞牛影视在线扩展」，选择停用或卸载。

• 停用：立即停止接管并恢复官方 Socket；

• 卸载：移除 systemd 服务和应用文件，并恢复官方 Socket；

• 扩展运行状态默认保留在应用数据目录，具体是否清除以应用中心卸载选项为准。

十一、反馈问题

反馈时建议附上：

• fnOS 版本；

• trim.media 版本；

• FPK 版本；

• 问题现象（媒体库浏览 / 榜单播放 / 搜索 / 播放，尽量说明是哪一类库）；

• 搜索或播放失败时的日志；

• 是否所有线路都失败，还是单条线路失败。

项目地址：https://github.com/yujian0815/fnmedia-ext