Forward 预加载功能说明

注意

Forward 在 1.3.14 版本新增了详情页预加载功能,详见下方具体描述。2026-01-21。

预加载机制

Forward 的预加载功能通过智能缓存管理来优化您的观看体验。当用户开启预加载时,系统会:

1. 智能缓存管理

  • 检查用户的缓存状态
  • 在片尾区间时自动忽略该区间的缓存请求
  • 当前集已经缓存完毕或片尾时间之前的内容已经缓存完毕,则会开始预加载

2. 下一集预加载

  • 自动开始缓存下一集开始播放时间点的内容
  • 缓存大小根据视频码率动态调整
  • 缓存范围: 50M ~ 200M

3. 详情页预加载(NEW)

从 1.3.14 版本开始,Forward 新增详情页预加载功能:

  • 当用户在详情页选择资源后,在点击播放之前,会预先加载少量视频数据
  • 预加载大小为 3-20MB,根据不同视频具体大小而定
  • 当用户点击播放时,可实现近乎即时的起播体验

服务器支持检测

Forward 如何判断服务器是否支持预加载?

目前 Forward 支持 UA 检测、黑名单、Headers 三种方式来判断服务器是否支持预加载。

1. User-Agent 检测(NEW)

Forward 在不同场景下会使用不同的 User-Agent,服务器管理员可以根据 UA 来控制功能开启:

User-Agent 列表

User-Agent使用场景
Forward-Standard正常播放请求
Forward-Preload下一集预加载请求
Forward-DetailPreload详情页预加载请求

服务器管理员可以根据请求的 UA 来决定是否允许该类型的请求。例如:

  • 允许所有请求:放行全部三种 UA
  • 禁用所有预加载:仅放行 Forward-Standard
  • 仅禁用详情页预加载:放行 Forward-Standard 和 Forward-Preload

2. Ping 接口 Headers 配置检测

Forward 在启动时会调用服务器接口 GET System/Ping。如果该接口可正常响应,则会开启预加载功能。

服务器可通过响应 Header 控制预加载行为:

响应 Header

Header说明
X-Preload-Bytes下一集预加载大小限制(字节)
X-DetailPreload-Bytes详情页预加载大小限制(字节)

配置示例:

  • 限制下一集预加载为 100M:X-Preload-Bytes: 104857600
  • 禁用下一集预加载:X-Preload-Bytes: -1
  • 禁用详情页预加载:X-DetailPreload-Bytes: -1

注:下一集预加载上限为 200M,详情页预加载为动态调整

3. 黑名单

如果服务器在黑名单中,则 Forward 会认为服务器不支持预加载。

如何开启预加载

作为 APP 使用者

你可以在 设置 - 缓存 中开启视频缓存,并开启以下功能:

  • 预缓存下一集:在观看过程中预加载下一集内容
  • 详情页起播加速:在详情页选择资源后预加载,加速起播(需服务器支持)

作为服务器管理员

如果想进行黑名单的添加:

  1. 通过 Telegram 联系 @ForwardPreloadBot
  2. 提交您的服务器一级域名,并附上域名所属证明

我们会尽快处理您的申请。

适用版本:1.2.10(186) 及以上

详情页预加载:1.3.14 及以上