Pass

Permite passar a conexão aceita diretamente para qualquer socket de escuta configurado nos módulos HTTP, Stream, ou Mail.

O módulo habilita terminação SSL seletiva baseada em SNI.

Ao compilar a partir do código-fonte, o módulo é compilado por padrão junto com o módulo Stream (habilitado com --with-stream); ele pode ser desabilitado com a opção de compilação --without-stream_pass_module.

Em pacotes e imagens de nossos repositórios, o módulo está incluído na compilação.

Exemplo de configuração

Após o módulo stream lidar com a terminação SSL/TLS, ele encaminha a conexão para o módulo http:

stream {

    server {

        listen 8000 default_server;
        ssl_preread on;
        # ...
    }

    server {

        listen 8000;
        server_name foo.example.com;
        pass 127.0.0.1:8001; # para HTTP
    }

    server {

        listen 8000;
        server_name bar.example.com;
        # ...
    }
}

http {

    server {

        listen 8001 ssl;
        # ...

        location / {

            root html;
        }
    }
}

Diretivas

pass

Sintaxe	pass endereço;
Padrão	—
Contexto	server

Esta diretiva define o endereço do servidor para o qual a conexão do cliente deve ser passada. O endereço pode ser fornecido como um endereço IP e porta:

pass 127.0.0.1:12345;

Ou como um caminho para um socket de domínio UNIX:

pass unix:/tmp/stream.socket;

Além disso, o endereço pode ser definido com variáveis:

pass $upstream;