vod_max_upstream_headers_size
Sets the maximum size for upstream headers processed by the NGINX VOD module.
Description
The vod_max_upstream_headers_size directive defines the maximum acceptable size, in bytes, for headers received from an upstream server during video delivery operations in the NGINX-based VOD packager module. This setting is crucial in scenarios where large headers are returned by upstream responses, especially in the context of adaptive bitrate streaming or when handling requests for video segments that may involve multiple headers for session control, authentication, or content negotiation.
When configured, the directive helps prevent memory issues and buffer overflows that could arise from excessively large headers. If the total headers size exceeds the specified limit, the response from the upstream server may be disregarded or the request may fail with an error. It is important to set this value based on the expected size of upstream headers from your media sources, ideally keeping it higher than the maximum observed header size to avoid unnecessary failures.
This directive can be set within the http, server, or location contexts, allowing fine-grained control over different parts of your configuration depending on specific requirements for different paths or server contexts. Adjusting this value may be necessary during high-load operations or when integrating with other systems that may generate large headers in responses.
Config Example
server {
listen 80;
location /videos {
vod_max_upstream_headers_size 8192;
# Additional configuration...
}
}Setting this value too low may lead to failed requests due to oversized headers.
Values are specified in bytes; ensure to convert appropriately for larger header requirements.