vod_upstream_extra_args
The `vod_upstream_extra_args` directive allows the specification of additional arguments to be forwarded to a Video on Demand (VOD) upstream request.
Description
The vod_upstream_extra_args directive is used within the NGINX-based VOD Packager module to pass extra parameters to the upstream requests that handle video files. This directive can be configured at the http, server, or location context, which allows for flexible configurations depending on the use case. It is particularly useful for adding query parameters, HTTP headers, or other custom options that might be needed by the backend processing the request for video content.
The behavior of this directive is to append the specified arguments to the outgoing requests to the upstream server handling the VOD operations. It is defined to take a single argument, which must be a valid string that includes the additional options you want to pass. If omitted or set to an invalid value, the application defaults to not appending any extra arguments, thus allowing for straightforward upstream interactions without unintended modifications.
Config Example
location /vod {
vod_upstream_extra_args "quality=high&format=mp4";
vod_data /path/to/video;
}Ensure that the arguments provided are correctly formatted, as improper syntax can cause requests to fail.
Keep in mind that excessive or unnecessary arguments may lead to performance issues or unexpected behaviors from the upstream service.