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 — это расширение FPK для медиаприложения 飞牛影视 на NAS fnOS, которое добавляет онлайн-стриминг: на главный экран оно выводит четыре полки медиа с рейтингом Douban и четыре большие полки категорий Apple-CMS, а результаты с онлайн-ресурсов Apple-CMS добавляет прямо в нативный поиск и воспроизводит через встроенный плеер приложения.
Это отдельное приложение или дополнение к уже существующему?Это не самостоятельный плеер. Это устанавливаемый пакет FPK, который через обратимую подмену Unix Socket перехватывает официальную службу воспроизведения trim.media, не изменяя официальный бинарный файл, nginx или базу данных.
Что нужно установить заранее, чтобы всё заработало?Нужны fnOS 1.2.0 или новее и установленное и запущенное официальное приложение 影视 (trim.media) (проверено на 0.9.8-1). Установщик FPK сам создаёт виртуальное окружение Python (venv) и автоматически устанавливает FastAPI/uvicorn/httpx.
Будут ли найденные источники работать всегда?Нет: ссылки для воспроизведения со сторонних сайтов Apple-CMS могут перестать работать в любой момент. Расширение намеренно не кэширует и не перезаливает видео, поэтому нерабочие источники нужно удалить или заменить на странице администратора. А обновление официального trim.media может изменить внутренние сигнатуры и потребовать обновления расширения.
Как полка с популярным находит фильмы, не храня у себя никаких медиафайлов?Каждые 6 часов она загружает еженедельные чарты Douban и рейтинги по тегам, чтобы собрать четыре кэшированные виртуальные библиотеки с постерами и оценками. Только когда вы открываете название, она в реальном времени ищет его на настроенных сайтах Apple-CMS и прикрепляет ссылку для воспроизведения, если она найдена.
Можно ли переключиться на другой источник, если поток прервался во время просмотра?Да: каждый сайт Apple-CMS, на котором найдено то же название, появляется отдельным пунктом в меню качества и линий, так что если поток зависает или не работает, можно мгновенно переключиться на другого провайдера.
Что будет, если я удалю или отключу расширение?Подмена Unix Socket отменяется автоматически, и сразу восстанавливается стандартная служба trim.media без остаточных изменений в официальном приложении.
Можно ли добавить свои источники потокового видео?Да: на странице администратора можно проверить, отключить или удалить встроенные источники по умолчанию, а также добавить любой эндпоинт, который соответствует стандартному формату JSON API Apple CMS V10.
Какие есть похожие проекты?srs, LibreTV, iptv, m3u, livego, go2rtc, hls.js, HGhub
Автор
yujian0815
Размер
43 MB
Звёзды
527
Возраст
1 мес
Коммиты · 90 дней