反代配置

本页说明当前版本中两条主要的播放链路：

1. 玄鲸直连
2. 飞牛反代

一、先理解两种模式

1. 玄鲸直连

玄鲸直连是系统内置的播放优化链路，适合绝大多数用户：

1. 不需要额外部署飞牛服务
2. 可以配合任务、STRM 和播放器直接使用
3. 适合以“开箱即用”为目标的环境

2. 飞牛反代

飞牛反代更适合已经在使用飞牛媒体体系、或者明确需要对接飞牛 302 反代链路的用户。

特点：

1. 需要在 媒体 -> 飞牛反代 中额外配置
2. 依赖飞牛服务地址
3. 修改参数后需要重启容器

二、为什么反代能提升播放体验

普通中转模式

反代 / 直连模式

反代链路的价值在于：

1. 减少不必要的中转
2. 提高起播速度
3. 降低服务器额外带宽压力

三、玄鲸直连怎么用

玄鲸直连通常不需要单独进入“反代配置”页面操作，而是通过任务和系统默认值配合使用。

方式一：新建任务时开启

1. 打开 任务管理
2. 点击 创建任务
3. 在表单中打开 玄鲸直连
4. 继续完成分享链接、账号、目录等配置
5. 保存任务

方式二：设置为默认开启

1. 打开 系统 -> 任务设置
2. 找到 玄鲸直连
3. 打开开关
4. 点击 保存

这样以后新建任务时，会默认带上该选项。

四、飞牛反代配置步骤

入口：媒体 -> 飞牛反代

1. 打开飞牛反代配置页

页面中包含以下核心项：

2. 填写飞牛服务地址

例如：

http://192.168.1.100:8005

要求：

1. 该地址必须能从容器所在环境访问
2. 尽量使用稳定的内网地址或固定域名
3. 地址变更后要记得重新保存并重启容器

3. 选择是否开启自动删除失效资源

开启后，当系统识别到某些播放条目已经失效，会自动尝试清理对应资源，避免媒体库中长期保留不可用链接。

建议：

1. 新环境先关闭，观察一段时间
2. 确认链路稳定后再开启

4. 保存并重启容器

飞牛反代配置修改后，必须重启容器才会完全生效。

五、飞牛反代的挂载要求

如果你是在非飞牛影视客户端中使用飞牛 302 反代，需要满足下面的条件：

1. 额外挂载飞牛媒体库目录
2. 保证容器内外路径完全一致

示例：

/vol1/1000/docker/strm:/vol1/1000/docker/strm

如果路径不一致，常见后果包括：

1. 能看到条目但无法播放
2. 播放时 404
3. 反代链路能建立但资源实际找不到

六、建议如何选择

适合优先用玄鲸直连的情况

1. 你是第一次搭建
2. 你希望配置尽量简单
3. 你主要目标是任务 + STRM + 播放的一体化体验

适合使用飞牛反代的情况

1. 你已经有飞牛服务环境
2. 你明确需要飞牛 302 反代链路
3. 你愿意维护额外的挂载路径和服务地址

七、排查建议

1. 开了飞牛反代但没有效果

先检查：

1. 是否已经点击保存
2. 是否已经重启容器
3. 飞牛服务地址是否真的可访问

2. 播放时提示资源不存在

优先检查：

1. 飞牛媒体库目录是否正确挂载
2. 容器内外路径是否完全一致
3. 对应资源是否已经失效

3. 起播还是很慢

建议依次排查：

1. 先确认播放器是否真的走了反代链路
2. 再确认网络环境是否稳定
3. 最后检查媒体库路径、STRM 和任务配置是否一致