Celebrating 20 years of nginx! Read about our journey and milestones in the latest blog.

Module ngx_stream_pass_module

Example Configuration Directives      pass

The ngx_stream_pass_module module (1.25.5) allows passing the accepted connection directly to any configured listening socket in http, stream, mail, and other similar modules.

Example Configuration

http {
    server {
        listen 8000;

        location / {
            root html;
        }
    }
}

stream {
    server {
        listen 12345 ssl;

        ssl_certificate     domain.crt;
        ssl_certificate_key domain.key;

        pass 127.0.0.1:8000;
    }
}

In the example, after terminating SSL/TLS in the stream module the connection is passed to the http module.

Directives

Sets server address to pass client connection to. The address can be specified as an IP address and a port:

pass 127.0.0.1:12345;

or as a UNIX-domain socket path:

pass unix:/tmp/stream.socket;

The address can also be specified using variables:

pass $upstream;