- Автор
- yujian0815
- Размер
- 43 MB
- Звёзды
- 527
- Обновлён
- КоммитNov 16Релизv1.1.0Nov 12
- Возраст
- 1 мес
- Коммиты · 90 дней
README проекта с github.com/yujian0815/fnmedia-ext. Одним файлом markdown: README.md.
给飞牛影视增加在线能力:媒体库首页注入 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 升级后签名常量或接口结构变化,停用扩展会立即恢复官方服务,等待新版本适配。
fnmedia-ext-<version>.fpk。【在线】 标记的结果。管理入口为应用内 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 相同的两层设计:
state/charts.json,媒体库只读、秒开。/online/ 海报代理并带豆瓣 Referer,
失败回退内联 SVG(HTTP 200)。兼容官方 page/page_size 分页、tags.type、sort_column
(榜单次序即热度,也可按评分/年份/片名排序)。除精选榜单外,额外注入 4 个海量库 🎞海量电影 / 📺海量剧集 / 🌸海量动漫 / 🎤海量综艺,用于“一直往下刷”:
启动/每 6 小时拉取各资源站苹果 CMS 分类表 ac=list,把全部子分类按名称归并到四大类,
自动剔除伦理/福利/解说/预告/体育/短剧等脏类;每类探测各源子类第一页,选页数最多的作“规范源”
(实测电影/剧/动漫可达 250 页≈5000 部、综艺 147 页≈2940),其余源作回退。
浏览时按页直连 ac=detail&t=<子类id>&pg=N(每页 20、详情自带播放地址,点开即可播、无需再搜索);
页级 10 分钟内存缓存 + 单 flight,规范源某页失败自动换源。
适配官方前端虚拟列表无限滚动:前端按 22 条/页块请求,服务端用“全局偏移跨 CMS 页取窗 + 会话级 guid 去重 + 不足一窗自动补页”,保证滚动连续、每部片全局只出现一次、到底自然停止。
条目 guid 绑定 (源, vod_id) 并入库,复用既有详情/选集/多线路/续播/代理播放链。
supervise.py 先校验官方 socket 的监听者 exe,再在私有暂存 socket 启动本服务;
健康检查通过后用 renameat2(NOREPLACE) 原子换名接管;退出/崩溃时原子换回官方 socket(fail-closed)。
播放:HLS 源返回自研 play_link=/v/media/online/<media_guid>/preset.m3u8,
服务端实时抓取源站 m3u8,把分片/密钥 URI 重写为同源代理地址(透传 Referer/UA/Range);
mp4 等非 HLS 直链返回 /direct,流式反向代理并透传 Range(支持拖动进度,206 直通)。
在线条目 guid = md5("on_<provider>_<vodid>"),media/video/season/episode guid 确定性派生、可反查。
标题与线路持久化在 state/titles.json,重启后历史卡片仍可播放。
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(运行时生成)
普通用户建议直接下载 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/ 一起删,不影响官方数据)。
https://<你的飞牛地址>/v/online-admin添加的自定义源需为苹果 CMS V10 标准 JSON 接口,形如:
https://站点/api.php/provide/vod/at/json # 搜索 ?ac=detail&wd=关键词
返回 {"code":1,"list":[{vod_name, vod_play_url, ...}]} 即被识别。
| 方法 | 路径 | 说明 |
|---|---|---|
| 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 |
管理页 |
GET /season/list/:tvGuid 返回一个伪造 Season,
GET /episode/list/:seasonGuid 返回每一集(确定性 episode_guid=md5(ep:on:idx),
集身份与播放线路解耦,切线路不换集)。play/info{item_guid:episodeGuid} → play/play,media/video guid 与该集绑定,
播放器拉到的就是该集 HLS。媒体 guid 反查索引在 store 内存中维护,随搜索结果增量重建。provider::组名,同一站直链优先于 share 页,
直链最多的线路为默认)。POST /stream 与 GET /stream/list
返回的 qualities 为每个可用线路生成一项(线路 1、线路 2……,不内置任何站点名称展示)。播放器切换该项时
会重新调用 POST /play/play,代理用请求里的线路码(编码在 bitrate 字段)解析
对应源,返回只含该线路的播放列表,从而在卡顿/失效时即时换源。can_play=1):从未看过播第 1 集;有未看完的集则
续播该集并恢复到上次秒数;已看完的集之后自动播下一集。index.m3u8 再套一层子 m3u8)会自动跟随解析(最多 4 层),
并正确重写 EXT-X-KEY(AES)与 EXT-X-MAP(fMP4 初始化段)。/share/<id> 等播放页源在播放时按需解析(页面内嵌 const url=...m3u8 提取,
30 分钟缓存),不拖慢搜索;直链线路始终优先于仅可解析的线路。POST /play/record,播放器高频上报)落在本地 state/history.json,
不上报官方库。GET /play/list 时把在线历史(带海报、剧名、季集、ts 进度、duration)
与官方本地历史合并返回,因此在线条目出现在「继续观看」,置顶按最近播放排序;
进度 ≥95% 视为看完不再占位,DELETE /play/record 同步删除。POST /play/info 回填已记录的 ts(秒),播放器据此从上次位置续播。bash packaging/fpk/build.sh # 产出 dist/fnmedia-ext-<ver>.fpk
deploy/fnmedia-ext.service.in 是 systemd 模板,安装时 deploy/install.sh 按
实际落盘路径渲染绝对路径,因此同一包可装到任意目录。cmd/install_callback 在首次安装时创建 venv 并 pip install fastapi uvicorn httpx,
随后调用 deploy/install.sh 接管;uninstall_callback 调用 deploy/uninstall.sh 还原。/share/<id> 解析器目前覆盖内嵌 const/var url / {"url":...} / 明文 m3u8
的播放页(苹果系常见);个别用加密 JS 动态拉流的页面可能解析不到(自动跳过该线路)。本项目开源、免费、无广告,所有功能均利用业余时间开发与维护。如果它让你的飞牛影视 更好用,欢迎扫码请作者喝杯咖啡——你的支持是持续适配新设备、维护源解析和修复问题的动力。
支付宝扫码,金额随意 ❤️ · 详见 打赏说明
打赏完全自愿,不影响任何功能使用,也不对应任何功能承诺或技术支持 SLA。