核心摘要
飞牛影视在线扩展Turbo是基于FNmedia-ext v0.2.39修改的优化版本，保留原版全部功能，并重点优化播放链路，缩短起播等待时间。
- 项目名称：飞牛影视在线扩展Turbo（FNmedia-ext Turbo）
- 项目背景：基于原版yujian0815/fnmedia-ext v0.2.39（完整构建）修改，由社区维护
- 核心功能：分片流式直发、线路竞速优化、按实测吞吐选线、进程内DNS缓存、接管守护等待窗口可配置、榜单与热门条目首点即播
- 适用人群：使用飞牛影视（fnOS）并需要在线资源播放的用户
- 资费模式：免费开源，以MIT许可发布
核心功能与价值
分片流式直发
降低首字节等待：连接上游后即边接收边推送给播放器，无需等待整个分片下载完成。仅在上游返回4xx或5xx、分片带PNG外壳或带content-encoding时回退为整段缓冲。
先成功者胜的线路竞速
避免等待慢线路：原版需等待所有候选线路探测完成，本项目在第一个可用候选返回后即取消其余探测，减少无效等待。
熟线单发直连
减少带宽争抢：已知吞吐达标的线路单独直连，不再与其他线路并发竞速，避免多线路互相占用带宽。
按实测吞吐选线
避开慢速线路：播放时顺带记录每条线路的真实下载速度，采用指数滑动平均计算，不产生额外流量，选线时优先选择实际速度快的线路。
进程内DNS缓存
加快域名解析：为资源站域名提供600秒TTL、2048条的缓存，仅作用于本进程，不修改系统解析配置。
接管守护等待窗口可配置
解决启动超时关闭：等待窗口由固定16秒改为可通过FNMEDIA_STAGE_WAIT配置，默认180秒，适用于大型片库。
榜单与热门条目首点即播
减少首次点播等待：列表展示时后台预解析前6个未绑定卡片，并采用两阶段解析，首次点开即可显示真实片长、简介与集数。
核心优势与原版对比
本项目在保留原版全部功能的基础上，仅优化播放链路，与原版v0.2.39在关键指标上的实测对比如下。
- 功能完整：保留原版搜索聚合、豆瓣榜单、资源站分类、m3u8与mp4代理解析、多线路切换、播放记录与续播等能力
- 改动集中：仅涉及6处播放链路改动，改动位置集中在proxy/app.py、proxy/supervise.py与服务配置文件
- 免费开源：以MIT许可发布，保留原作者版权声明
| 对比维度 | 原版 v0.2.39 | Turbo v1.0.0（实测） |
|---|---|---|
| 起播耗时（13条线路的剧集） | 11.67秒 | 2.93秒（首次）/2.34秒（再播） |
| 分片首字节 | 1.5至55秒（等待整段下载完成） | 0.09至0.70秒 |
| 选线依据 | 仅比较首字节延迟 | 首字节延迟结合实测吞吐 |
| 同片可选线路吞吐 | 55至70 KB/s | 592 KB/s |
| 资源站域名冷解析 | 5.0至5.2秒 | 缓存命中0.04至0.12秒 |
| 接管守护等待窗口 | 固定16秒 | 可配置，默认180秒 |
| 首次点开榜单片的详情 | 骨架信息，等待0.12秒 | 真实信息，等待最多2.5秒 |
| 首次点播榜单片 | 5.8至9.3秒，常转圈超时 | 0.02至0.03秒（列表预解析） |
软件界面
软件配置界面如下：
安装完毕之后打开飞牛影视，即可看到下面的界面：
适用场景与目标受众
- 飞牛NAS家庭用户：可以在飞牛影视中直接使用在线资源播放功能，并减少起播等待时间
- 大型片库使用者：可以通过可配置的等待窗口，避免3000部以上片库在启动时因超时而关闭
- 开发者与技术研究者：可以参考分片流式转发、按吞吐选线等改动思路，将相关改动应用到原版v0.2.39源码中
部署与搭建指南
环境依赖与准备工作
- 飞牛系统：fnOS 1.2.0或更高版本（实测版本为1.2.0800）
- 飞牛影视：trim.media 0.9.8-1（实测版本）
- 网络环境：安装过程需要联网，用于通过pip安装fastapi、uvicorn与httpx并创建虚拟环境
- 权限要求：需要可以访问应用中心并执行手动安装的管理员权限
如已安装原版或需要卸载重装，先将/vol1/@appcenter/fnmedia-ext/repo/state/目录复制到其他位置，备份片库缓存、播放记录与源配置。
cp -r /vol1/@appcenter/fnmedia-ext/repo/state/ /vol1/backup/fnmedia-state/
在Github项目的Releases页面下载v1.0.1版本的FPK安装包，该版本基于官方完整构建v0.2.39重新打包，装完即用。
打开飞牛应用中心，选择手动安装，并选择已下载的FPK安装包文件。
勾选免责声明后点击安装，等待pip依赖安装完成。如已安装原版，安装程序将按升级处理，并自动备份与还原state目录。
真实体验与反馈
- 安装便捷：v1.0.1版本已将优化内容写入源码，安装后无需再运行补丁脚本。
- 起播提速明显：在同一台NAS、同一部剧集与同一源站的实测中，起播耗时由11.67秒降至2.93秒（首次）。
- 局限性：源站速度波动较大，实测的绝对数值会随网络与源站状态变化，但相对改善趋势保持稳定。
常见问题解答
免费。本项目以MIT许可发布，原版同样以MIT许可发布。
不提供、不内置、也不分发任何影视资源、资源站地址或播放链接。在线内容来自使用者自行配置的第三方接口，使用前需自行确认合法性。
本项目保留原版v0.2.39的全部功能，仅优化播放链路，涉及分片流式直发、线路竞速、按吞吐选线、DNS缓存、等待窗口可配置与榜单首点即播等6处改动。
已在fnOS 1.2.0800与trim.media 0.9.8-1上实测。
直接通过应用中心安装Turbo安装包即可按升级处理，state目录中的片库缓存、播放记录与源配置会先备份再还原。卸载重装前建议手动备份/vol1/@appcenter/fnmedia-ext/repo/state/目录。
