vod_remote_upstream_location

The `vod_remote_upstream_location` directive specifies the location of remote content for streaming in NGINX-based VOD packaging.

Syntaxvod_remote_upstream_location remote_location;
Defaultnone
Contexthttp, server, location
Arguments1

Description

The vod_remote_upstream_location directive is used in the NGINX-based VOD Packager to define a remote URL from which video content can be streamed. This is particularly useful when integrating with remote storage or cloud services that host media files. When enabled, the directive allows the VOD packager to process range requests, which can improve the experience for users accessing video content by enabling features like seeking and adaptive bitrate streaming.

To configure this directive, you must provide a single argument, which is the full URL of the remote media content. When a request is made for a video segment that the server cannot provide from its locally stored files, NGINX will fetch the content from the specified remote location instead. This is particularly beneficial in scenarios where media files are large, and only small portions need to be accessed at any given time, taking advantage of HTTP range requests.

By using this directive within the appropriate context of your NGINX configuration (http, server, or location), you can control how the server handles requests for video content. It's important to model the configuration to ensure that it's optimized for performance and adheres to any security and authentication measures required by the remote storage provider.

Config Example

location /vod {
    vod_remote_upstream_location http://remote-server.com/media;
}

Ensure the specified remote URL is accessible by the NGINX server; otherwise, requests will fail.

Using this directive may require appropriate buffering settings if the remote content has high latency to avoid performance issues.

Be cautious of CORS policies when streaming from remote locations that may block requests from your domain.

← Back to all directives