proxy_header

The `proxy_header` directive controls whether proxy headers are sent when establishing an SRT connection through NGINX SRT module.

Syntaxproxy_header flag;
Defaultnone
Context
Argumentsflag

Description

The proxy_header directive in the NGINX SRT module is a flag that determines the behavior of the proxy in relation to header information. When set, it instructs the server to include certain headers that may be needed for the proper functioning of upstream applications that rely on such header information to process requests accurately. This is particularly important in scenarios where SRT is being used to transmit data over unreliable networks, as proper header information can facilitate better error handling and flow control in the stream of data being processed.

Additionally, the use of headers can also be critical in establishing certain parameters for session management and can influence how the server handles client connections. It is a way to improve both security and performance when dealing with concurrent connections or when applications require specific identity information to function correctly. The directive's behavior can vary based on context or upstream application requirements, and if misconfigured, it may lead to issues in request handling or communication failures with upstream services.

Config Example

srt {
    server {
        listen 4321;
        proxy_header on;
        proxy_pass tcp://127.0.0.1:5678;
    }
}

Ensure that proxy_header is compatible with the upstream service's requirements; otherwise, miscommunication may occur.

Using proxy_header in configurations without proper understanding of header implications can lead to security vulnerabilities or performance issues.

← Back to all directives