Module ngx_stream_core_module

ngx_stream_core_module模块从 1.9.0 版开始可用。默认情况下未构建此模块，应使用--with-stream配置参数启用它。

Example Configuration

worker_processes auto;

error_log /var/log/nginx/error.log info;

events {
    worker_connections  1024;
}

stream {
    upstream backend {
        hash $remote_addr consistent;

        server backend1.example.com:12345 weight=5;
        server 127.0.0.1:12345            max_fails=3 fail_timeout=30s;
        server unix:/tmp/backend3;
    }

    upstream dns {
       server 192.168.0.1:53535;
       server dns.example.com:53;
    }

    server {
        listen 12345;
        proxy_connect_timeout 1s;
        proxy_timeout 3s;
        proxy_pass backend;
    }

    server {
        listen 127.0.0.1:53 udp reuseport;
        proxy_timeout 20s;
        proxy_pass dns;
    }

    server {
        listen [::1]:12345;
        proxy_pass unix:/tmp/stream.socket;
    }
}

Directives

Syntax: listen address:port [ssl] [udp] [proxy_protocol] [backlog=number] [rcvbuf=size] [sndbuf=size] [bind] [ipv6only=on|off] [reuseport] [so_keepalive=on|off|[keepidle]:[keepintvl]:[keepcnt]];
Default: —
Context: server

为服务器将在其上接受连接的套接字设置address和port。可以仅指定端口。该地址也可以是主机名，例如：

listen 127.0.0.1:12345;
listen *:12345;
listen 12345;     # same as *:12345
listen localhost:12345;

IPv6 地址在方括号中指定：

listen [::1]:12345;
listen [::]:12345;

UNIX 域套接字使用“ unix:”前缀指定：

listen unix:/var/run/nginx.sock;

指定端口范围(1.15.10)，第一个和最后一个端口用连字符分隔：

listen 127.0.0.1:12345-12399;
listen 12345-12399;

ssl参数允许指定该端口上接受的所有连接均应以 SSL 模式工作。

udp参数配置用于处理数据报(1.9.13)的侦听套接字。为了在同一会话中处理来自相同地址和端口的数据包，还应指定reuseport参数。

proxy_protocol参数(1.11.4)允许指定此端口上接受的所有连接都应使用PROXY protocol。

Note

从 1.13.11 版本开始支持 PROXY 协议版本 2.

listen指令可以具有一些特定于套接字相关系统调用的附加参数。

reuseport

Note

不当使用此选项可能具有安全性implications。

so_keepalive=30m::10

会将闲置超时(TCP_KEEPIDLE)设置为 30 分钟，将探测间隔(TCP_KEEPINTVL)保留为系统默认值，并将探测计数(TCP_KEEPCNT)设置为 10 个探测。

不同的服务器必须侦听不同的address：port对。

Syntax: preread_buffer_size size;
Default: preread_buffer_size 16k;
Context: stream , server

该指令出现在 1.11.5 版中。

指定preread缓冲区中的size。

Syntax: preread_timeout timeout;
Default: preread_timeout 30s;
Context: stream , server

该指令出现在 1.11.5 版中。

指定preread阶段的timeout。

Syntax: proxy_protocol_timeout timeout;
Default: proxy_protocol_timeout 30s;
Context: stream , server

该指令出现在版本 1.11.4 中。

指定一个timeout以读取 PROXY 协议 Headers 以完成。如果在此时间内未传输整个 Headers，则连接将关闭。

Syntax: resolver address ... [valid=time] [ipv6=on|off] [status_zone=zone];
Default: —
Context: stream , server

该指令出现在 1.11.3 版中。

配置用于将上游服务器的名称解析为地址的名称服务器，例如：

resolver 127.0.0.1 [::1]:5353;

可以使用可选端口将地址指定为域名或 IP 地址。如果未指定端口，则使用端口 53.以循环方式查询名称服务器。

默认情况下，nginx 在解析时将同时查找 IPv4 和 IPv6 地址。如果不需要查找 IPv6 地址，则可以指定ipv6=off参数。

默认情况下，nginx 使用响应的 TTL 值缓存答案。可选的valid参数允许覆盖它：

resolver 127.0.0.1 [::1]:5353 valid=30s;

Note

为防止 DNS 欺骗，建议在适当安全的受信任本地网络中配置 DNS 服务器。

可选的status_zone参数(1.17.1)启用collection的 DNS 服务器统计信息，用于指定zone中的请求和响应。该参数可作为commercial subscription的一部分使用。

Note

在 1.11.3 版之前，此指令可作为commercial subscription的一部分使用。

Syntax: resolver_timeout time;
Default: resolver_timeout 30s;
Context: stream , server

该指令出现在 1.11.3 版中。

设置名称解析超时，例如：

resolver_timeout 5s;

Note

在 1.11.3 版之前，此指令可作为commercial subscription的一部分使用。

Syntax: server { ... }
Default: —
Context: stream

设置服务器的配置。

Syntax: stream { ... }
Default: —
Context: main

提供在其中指定流服务器指令的配置文件上下文。

Syntax: tcp_nodelay on | off;
Default: tcp_nodelay on;
Context: stream , server

该指令出现在版本 1.9.4 中。

启用或禁用TCP_NODELAY选项的使用。客户端和代理服务器连接均启用该选项。

Syntax: variables_hash_bucket_size size;
Default: variables_hash_bucket_size 64;
Context: stream

该指令出现在 1.11.2 版中。

设置变量哈希表的存储桶大小。设置哈希表的详细信息在单独的document中提供。

Syntax: variables_hash_max_size size;
Default: variables_hash_max_size 1024;
Context: stream

该指令出现在 1.11.2 版中。

设置变量哈希表的最大值size。设置哈希表的详细信息在单独的document中提供。

Embedded Variables

ngx_stream_core_module模块从 1.11.2 开始支持变量。

$binary_remote_addr

$bytes_received

$bytes_sent

$connection

$hostname

$msec

$nginx_version

$pid

$protocol

$proxy_protocol_addr

必须先通过在listen指令中设置proxy_protocol参数来启用 PROXY 协议。

$proxy_protocol_port

必须先通过在listen指令中设置proxy_protocol参数来启用 PROXY 协议。

$proxy_protocol_server_addr

必须先通过在listen指令中设置proxy_protocol参数来启用 PROXY 协议。

$proxy_protocol_server_port

必须先通过在listen指令中设置proxy_protocol参数来启用 PROXY 协议。

$remote_addr

$remote_port

$server_addr

计算此变量的值通常需要一个系统调用。为避免系统调用，listen指令必须指定地址并使用bind参数。

$server_port

$session_time

$status

$time_iso8601

$time_local

首页