本篇文章主要讲 ngx_stream_core_module 模块下各指令的使用方法，Nginx默认未配置该模块，需要用“--with-stream”配置参数重新编译Nginx。

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;
    }
}

1. stream 

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

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

2. server 

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

         设置服务器配置。

3. listen 

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

        设置服务器接受连接的套接字address和port。可以仅指定port。address也可以是主机名。可以监听一个端口段range。

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;

# 端口范围用连字符分隔第一个和最后一个端口：
listen 127.0.0.1:12345-12399;
listen 12345-12399;

        udp：指定一个用于处理数据包的监听套接字（1.9.13）。为了在同一会话中处理来自同一地址和端口的数据包，还应指定 reuseport 参数。

4. proxy_protocol_timeout 代理协议超时时间

Syntax:    proxy_protocol_timeout timeout;
Default:    proxy_protocol_timeout 30s;
Context:    stream, server
This directive appeared in version 1.11.4.

        指定读取代理协议头的超时时间。如果在这段时间内没有传输完整个报头，连接将被关闭。

5. preread_buffer_size 预读取缓冲大小

Syntax:    preread_buffer_size size;
Default:    preread_buffer_size 16k;
Context:    stream, server
This directive appeared in version 1.11.5.

        指定预读取缓冲区的大小。

6. preread_timeout 预读取超时时间

Syntax:    preread_timeout timeout;
Default:    preread_timeout 30s;
Context:    stream, server
This directive appeared in version 1.11.5.

        指定预读取阶段的超时时间。

7. resolver DNS服务器

Syntax:    resolver address ... [valid=time] [ipv4=on|off] [ipv6=on|off] [status_zone=zone];
Default:    —
Context:    stream, server
This directive appeared in version 1.11.3.

        配置用于解析上游服务器域名的DNS服务器，

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

8. resolver_timeout 解析超时时间

Syntax:    resolver_timeout time;
Default:    resolver_timeout 30s;
Context:    stream, server
This directive appeared in version 1.11.3.

        设置解析超时时间。 

resolver_timeout 5s;

9. tcp_nodelay 

Syntax:    tcp_nodelay on | off;
Default:    tcp_nodelay on;
Context:    stream, server
This directive appeared in version 1.9.4.

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

10. variables_hash_bucket_size 

Syntax:    variables_hash_bucket_size size;
Default:    variables_hash_bucket_size 64;
Context:    stream
This directive appeared in version 1.11.2.

        设置变量哈希表的桶大小。

11. variables_hash_max_size 

Syntax:    variables_hash_max_size size;
Default:    variables_hash_max_size 1024;
Context:    stream
This directive appeared in version 1.11.2.

        设置变量哈希表的最大大小。