vod_upstream_location
`vod_upstream_location` 指令在 NGINX 中指定用于视频点播 (VOD) 服务的上游位置,允许对视频内容进行动态传输和打包。
NGINX-based VOD Packager
·
httpserverlocation
语法vod_upstream_location URI;
默认值none
上下文http, server, location
参数1
说明
vod_upstream_location 指令在基于 NGINX 的 VOD Packager 模块中使用,用于定义视频文件或流用于处理的具体上游位置。该指令对于将各种视频格式重新打包为自适应流媒体格式(如 HLS、DASH 等)至关重要。通过在适当的上下文(http、server 或 location)中设置此指令,可以告知 NGINX 在收到流请求时从何处获取媒体内容。
当收到请求时,NGINX 会评估 vod_upstream_location 并将请求转发到指定的上游地址。该地址可以指向存储在磁盘上的本地文件,也可以指向通过 HTTP 可访问的远程视频文件。该指令支持 range requests,这是自适应流媒体所必需的,允许客户端请求视频文件的特定字节范围,从而实现更平滑的播放体验和更高效的带宽利用。对该指令的正确配置可确保 NGINX 在视频播放期间根据网络状况和用户需求动态调整。
该指令接受一个参数,即上游位置的 URI。在典型用法中,指定的上游可以是指向视频文件的本地路径,或指向远程服务器上视频文件的 URL。该指令对于构建无缝的 VOD 体验至关重要,尤其是在与 NGINX 视频传输相关的其他指令结合使用时。
配置示例
location /vod {
vod_upstream_location /var/www/videos;
vod_enable on;
}⚠
确保 upstream location 可访问;否则 NGINX 会返回 404 错误。
⚠
请记得为 location 配置适当的权限,尤其是在从本地文件系统提供内容时。
⚠
如果使用 remote locations,请检查 upstream server 是否支持 range 请求。