模块 ngx_stream_limit_conn_module

示例配置
指令
     limit_conn
     limit_conn_dry_run
     limit_conn_log_level
     limit_conn_zone
嵌入式变量

ngx_stream_limit_conn_module 模块 (1.9.3) 用于根据定义的键限制连接数,特别是来自单个 IP 地址的连接数。

示例配置

stream {
    limit_conn_zone $binary_remote_addr zone=addr:10m;

    ...

    server {

        ...

        limit_conn           addr 1;
        limit_conn_log_level error;
    }
}

指令

语法 limit_conn zone number;
默认值
上下文 stream, server

设置共享内存区域和给定键值的最大允许连接数。当超过此限制时,服务器将关闭连接。例如,指令

limit_conn_zone $binary_remote_addr zone=addr:10m;

server {
    ...
    limit_conn addr 1;
}

一次仅允许每个 IP 地址一个连接。

当指定多个 limit_conn 指令时,任何配置的限制都将适用。

如果当前级别没有定义 limit_conn 指令,则这些指令将从先前的配置级别继承。

语法 limit_conn_dry_run on | off;
默认值
limit_conn_dry_run off;
上下文 stream, server

此指令出现在 1.17.6 版本中。

启用模拟运行模式。在此模式下,连接数不受限制,但在共享内存区域中,过多的连接数将像往常一样被记录。

语法 limit_conn_log_level info | notice | warn | error;
默认值
limit_conn_log_level error;
上下文 stream, server

设置服务器限制连接数时的所需日志级别。

语法 limit_conn_zone key zone=name:size;
默认值
上下文

设置共享内存区域的参数,该区域将保存各种键的状态。特别是,状态包括当前的连接数。key 可以包含文本、变量及其组合 (1.11.2)。具有空键值的连接不会被记录。使用示例

limit_conn_zone $binary_remote_addr zone=addr:10m;

这里,键是 $binary_remote_addr 变量设置的客户端 IP 地址。$binary_remote_addr 的大小对于 IPv4 地址为 4 字节,对于 IPv6 地址为 16 字节。存储的状态在 32 位平台上始终占用 32 或 64 字节,在 64 位平台上始终占用 64 字节。一个兆字节的区域可以保存大约 32000 个 32 字节的状态或大约 16000 个 64 字节的状态。如果区域存储耗尽,服务器将关闭连接。

此外,作为我们 商业订阅 的一部分,每个此类共享内存区域的 状态信息 可以使用 API 从 1.17.7 版本开始 获取重置

嵌入式变量

$limit_conn_status
保存限制连接数的结果 (1.17.6):PASSEDREJECTEDREJECTED_DRY_RUN