前言

  • stream模块是nginx中一个支持配置TCP/UDP协议的模块。
  • 使用stream模块，可以在同一台服务器上运行多个不同的网络流应用程序。
  • 这些应用程序使用不同的协议和端口，但通过使用Nginx的stream模块，可以使这些不同的应用程序在同一端口上共享公共网络地址。
  • 使用Ngixn的stream模块，可以同一台服务器上运行负责的内容。

stream配置详解

基础stream配置

stream模块

1
2
3
stream {
    # stream模块的配置内容，可以在此处添加
}

stream模块是stream配置的主体，用于配置TCP/UDP协议。它可以包含一系列的server{}模块，每个server{}模块可以为多个应用程序服务。使用stream模块时，server{}中可以配置listening端口，来监听某个特定的端口。下面是一个简单的stream server配置：

1
2
3
4
5
6
stream {
    server {
        listen 80;
        proxy_pass server1;
    }
}

server模块

每个server{}模块是由IP地址、端口号和传输协议组成的，通常情况下，如果一个stream模块需要为多个应用服务器提供服务时，可以为每个应用程序分配独立的IP地址和端口。通过server{}块，可以在同一端口上为不同协议的服务提供支持。

1
2
3
4
5
6
7
8
9
10
stream {
    server {
        listen 80;
        proxy_pass server1;
    }
    server {
        listen 81;
        proxy_pass server2;
    }
}

高级stream配置

upstream模块

upstream模块定义了stream server将传输全部传送到的上游服务器列表，此块配置类似于http模块中的upstream模块。
通过upstream模块，可以定义如下内容：

  • 上游服务器地址
  • 连接池的大小
  • 连接传输均衡算法
    下面的示例展示了如何配置upstream模块：
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    stream {
        upstream servers {
            # 配置上游服务器的IP地址和端口号
            server 192.168.0.1:8080;
            server 192.168.0.2:8080;
            # 指定连接池大小
            zone my_stream_pool 64k;
            # 开启负载均衡，使用轮询算法
            fair;
        }
        server {
            listen 80;
            proxy_pass servers;
        }
    }

按条件转发流量

使用stream模块，我们可以将流量分发到不同的上游服务器中，或者根据客户端IP地址将流量转发到不同的服务器中。
在stream{}配置模块中，使用map和split_clients设置转发的条件。

1
2
3
4
5
6
7
8
9
10
11
http {
    map $time_local $stream_variable {
        default upstream_servers;
        include /path/to/stream_variables.conf;
    }
    server {
        listen      80;
        server_name localhost;
        proxy_pass  $stream_variable;
    }
}

在此示例中，server在80端口处监听并将请求转发到$stream_variable变量所指定的地址中。
如果$stream_variable没有值，则使用upstream_servers。
如果需要使用map或split_clients，则需要在stream_variables.conf文件中定义变量。

反向代理

stream模块还支持反向代理功能，可以将接收到的连接、请求或响应通过前置代理服务器或负载均衡功能，转发到后端应用服务器上。

1
2
3
4
5
6
7
8
9
10
11
stream {
    upstream backend {
        server backend1.example.com:12345;
        server backend2.example.com:12345;
    }
    #将流量转发至upstream servers 
    server {
        listen    80;
        proxy_pass backend;
    }
}
  • 模拟一个案例
    1
    2
    3
    4
    5
    6
    stream {
      server {
        listen 8101;
        proxy_pass 指向目标的IP:端口;
      }
    }