Nginx(十六) 配置文件详解 - server stream服务流

? ? ? ? 本篇文章主要讲?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.

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