fnmedia-ext README

项目的 README,来自 github.com/yujian0815/fnmedia-ext。合并为一个 markdown 文件:README.md。

飞牛影视 · 在线资源扩展 (fnmedia-ext)

给飞牛影视增加在线能力:媒体库首页注入 4 个豆瓣榜单库 + 4 个资源站海量分类库(无限滚动、点开即播),并在原生搜索里聚合苹果 CMS 资源站的在线影视,用飞牛自带播放器直接播放。搜索结果默认在线前排。零侵入、完全可逆:不改官方二进制 / nginx / 数据库,靠 Unix Socket 原子接管。

点播源会随时间失效,因此本扩展不做转存/STRM 落库——即刷即播、即搜即播;源不可用时可在管理页删除或替换。

📌 各版本更新内容见 CHANGELOG.md。

⚠️ 免责声明:本项目是开源免费的技术研究 / 个人媒体库工具,本身不提供、不存储、不分发任何影视、图片或播放地址,也不内置资源数据库;所有在线内容均来自互联网公开的第三方接口与公开榜单,版权归原权利人所有。本项目不提供、不推荐、不解答任何资源站点的名称、地址或获取方法,接口由使用者自行配置并自行核实合法性。仅供学习交流与个人合法观看自有 / 已授权内容,请勿商用或传播侵权内容;由此产生的法律责任由使用者自行承担。

适配版本

项目 已验证 / 要求
fnOS 1.2.0 及以上(FPK manifest 最低要求)
官方影视应用 trim.media 0.9.8-1(已实测)
CPU 架构 all(纯 Python,安装时创建独立 venv)
安装方式 fnOS 应用中心手动安装 FPK,可安装在 /vol1、/vol2 等数据卷
依赖 官方「影视 (trim.media)」必须保持安装并启用
网络 资源站访问使用直连(trust_env=False),不读取代理环境变量

本扩展通过 Unix Socket 可逆接管官方影视接口,不改官方二进制、nginx 或数据库。未来若 fnOS / trim.media 升级后签名常量或接口结构变化,停用扩展会立即恢复官方服务,等待新版本适配。

下载安装

  1. 打开 Releases,下载最新的 fnmedia-ext-<version>.fpk。
  2. 在 fnOS 应用中心 → 手动安装 FPK 中选择该文件。
  3. 选择应用安装所在存储卷,保持依赖应用 影视 (trim.media) 为运行状态。
  4. 安装完成后启用「飞牛影视在线扩展」,桌面/应用内会出现 影视在线扩展管理。
  5. 打开官方「影视」,直接搜索中文片名即可看到带 【在线】 标记的结果。

管理入口为应用内 iframe:/app/fnmedia-ext/;旧的直连路径 /v/online-admin 仍保留。卸载或停用扩展会自动把 /var/run/trim_media.sock 还原给官方影视服务。

工作原理

浏览器/飞牛App → nginx(/v) → /var/run/trim_media.sock → fnmedia-ext(FastAPI)
                                                   ├─ 普通请求 → 透传官方后端(upstream socket)
                                                   ├─ /search/list → 注入在线结果(默认排最前)+ 本地结果
                                                   ├─ /item /season/* /episode/* /play/* /stream/* → 伪造链路
                                                   ├─ mediadb/list · mediadb/sum · item/list · item/<guid>
                                                   │      → 注入豆瓣榜单四库 + 资源站海量分类四库(无限滚动)
                                                   └─ /v/media/online/* → HLS/分片/密钥/mp4 反向代理

热门榜单媒体库(展示 / 播放解耦,对齐 LibreTV)

“热门”不再用资源站的「最近更新」冒充(那是“刚录入了什么”,不是“大家在看什么”,且电影稀少、 海报差、无评分)。改为与 LibreTV 相同的两层设计:

海量分类片库(方案 C · 资源站全量深翻,无限滚动)

除精选榜单外,额外注入 4 个海量库 🎞海量电影 / 📺海量剧集 / 🌸海量动漫 / 🎤海量综艺,用于“一直往下刷”:

目录

proxy/
  app.py            主代理:透传 + 搜索注入 + 播放伪造 + HLS/海报代理 + 管理 API
  supervise.py      原子接管守护(暂存启动→校验→换名;退出自动回滚)
  providers.py      苹果CMS V10 适配 + 连通性探测 + /share 播放页解析(直连国内,trust_env=False)
  inject.py         在线条目 → 飞牛 item/stream/play/history 结构(标题带【在线】)
  store.py          标题/线路持久化、跨源聚合、按集解析、线路/集反查索引
  hot.py            「在线热门」后台刷新:跨源聚合去重、排序、原子缓存、失败保留旧缓存
  history.py        在线播放进度(继续观看):record 落库、play/list 合并、ts 续播
  config.py         可热加载配置:自定义源增删、启用开关、噪音过滤、在线前排
  admin_ui.py       单文件管理页(源管理/测速/设置)
  fnmedia_authx.py  官方 authx 签名客户端(MD5 + apiKey)
deploy/             持久 systemd 单元 + install/uninstall
packaging/fpk/      飞牛应用中心 FPK 打包
state/              titles.json / config.json(运行时生成)

从源码构建 FPK

普通用户建议直接下载 Release 的 .fpk。开发者可从源码构建:

git clone https://github.com/yujian0815/fnmedia-ext.git
cd fnmedia-ext
bash packaging/fpk/build.sh
# 产物:dist/fnmedia-ext-<version>.fpk

FPK 安装回调会自动在应用目录创建独立 venv,并安装 requirements.txt 中声明的运行依赖。

如需手工在开发机直装(不推荐用于生产 NAS):

python3 -m venv .venv
.venv/bin/pip install -r requirements.txt
sudo bash deploy/install.sh

还原 / 卸载:sudo bash deploy/uninstall.sh(加 --purge 连运行配置 state/ 一起删,不影响官方数据)。

使用

资源站接口格式

添加的自定义源需为苹果 CMS V10 标准 JSON 接口,形如:

https://站点/api.php/provide/vod/at/json        # 搜索 ?ac=detail&wd=关键词

返回 {"code":1,"list":[{vod_name, vod_play_url, ...}]} 即被识别。

管理 API

方法 路径 说明
GET /v/api/ext/status 运行状态 + 配置(不含 token)
GET /v/api/ext/online?q=&limit= 已缓存在线条目
POST /v/api/ext/config 保存设置/源启用状态(热生效,清搜索缓存)
POST /v/api/ext/junk-keywords {keywords} 自定义噪音词(自动分隔去重)或 {reset:true} 恢复默认
POST /v/api/ext/source/add {name,api} 添加自定义源(按地址去重)
POST /v/api/ext/source/delete {id} 删除/隐藏一条线路(默认线路可恢复)
POST /v/api/ext/source/restore 恢复全部默认线路
POST /v/api/ext/source/test {id} 或 {api} 单源连通性探测
POST /v/api/ext/source/test-all 并发探测全部源
POST /v/api/ext/hot/refresh 立即刷新豆瓣榜单缓存(失败保留旧缓存)
GET /v/online-admin 管理页

选集(原生 TV UI)

多线路切换

播放记录 / 继续观看

打成 FPK 应用包

bash packaging/fpk/build.sh          # 产出 dist/fnmedia-ext-<ver>.fpk

已知限制 / 路线图

☕ 为爱发电 · 欢迎打赏

本项目开源、免费、无广告,所有功能均利用业余时间开发与维护。如果它让你的飞牛影视 更好用,欢迎扫码请作者喝杯咖啡——你的支持是持续适配新设备、维护源解析和修复问题的动力。

支付宝打赏收款码

支付宝扫码,金额随意 ❤️ · 详见 打赏说明

打赏完全自愿,不影响任何功能使用,也不对应任何功能承诺或技术支持 SLA。

fnmedia-ext (yujian0815/fnmedia-ext)

正在搜索数据库…

这是什么?fnmedia-ext 是用于 fnOS NAS 媒体应用(飞牛影视)的 FPK 扩展,可增加在线播放功能:它会在首页注入四个按豆瓣排名生成的影片栏目,以及四个超大的 Apple-CMS 分类栏目,并将 Apple-CMS 资源站的在线搜索结果直接汇总到应用原生搜索中,播放时使用应用自带的播放器。
这是独立应用,还是现有应用的插件?它不是独立的播放器。它是一个可安装的 FPK 安装包,通过可逆的 Unix Socket 切换接管官方 trim.media 播放服务,不修改官方二进制文件、nginx 或数据库。
使用前需要先安装什么?需要 fnOS 1.2.0 或更高版本,并已安装且正在运行官方「影视」(trim.media)应用(已在 0.9.8-1 上测试);FPK 安装程序会自动创建自己的 Python 虚拟环境,并自动安装 FastAPI/uvicorn/httpx。
它找到的在线片源能一直可用吗?不能保证——第三方 Apple-CMS 站点提供的播放源随时可能失效。扩展特意不缓存、也不转存视频,因此失效的片源只需在管理页面中删除或替换即可。官方 trim.media 更新也可能改变内部签名,从而需要更新扩展。
热门榜栏目在不托管任何媒体文件的情况下,如何找到影片?每 6 小时,它会拉取豆瓣周榜和标签排行榜,构建四个带海报和评分的缓存虚拟库;只有当你打开某个影片时,才会实时搜索已配置的 Apple-CMS 站点,并在找到时附上可播放的链接。
如果播放途中片源中断,能切换到其他片源吗?可以——与同一影片匹配的每个 Apple-CMS 站点都会在清晰度/线路菜单中单独列出,因此如果某个站点卡顿或失败,你可以立即切换到其他站点。
如果卸载或停用扩展,会发生什么?Unix Socket 接管会被自动撤销,立即恢复为原版 trim.media 服务,官方应用不会留下任何残留改动。
我能添加自己的在线片源吗?可以。管理页面支持测试、停用或删除内置的默认片源,也可以添加任何遵循标准 Apple CMS V10 JSON API 格式的接口地址。
有哪些类似的项目?srs, LibreTV, iptv, m3u, livego, go2rtc, hls.js, HGhub
大小
43 MB
星标
527
时长
1个月
提交 · 90 天