模块 ngx_stream_limit_conn_module
| Example Configuration Directives limit_conn limit_conn_dry_run limit_conn_log_level limit_conn_zone Embedded Variables | 
该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  | 
|---|---|
| 默认: | — | 
| 语境: | 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  | 
|---|---|
| 默认: | limit_conn_dry_run off; | 
| 语境: | stream,server | 
该指令出现在版本 1.17.6 中。
启用试运行模式。在这种模式下,连接数不受限制,但在共享内存区中,超出的连接数照常计算。
| 句法: | limit_conn_log_level 
 | 
|---|---|
| 默认: | limit_conn_log_level error; | 
| 语境: | stream,server | 
设置服务器限制连接数时所需的日志记录级别。
| 句法: | limit_conn_zone 
     | 
|---|---|
| 默认: | — | 
| 语境: | stream | 
设置共享内存区域的参数,该区域将保留各个键的状态。特别是,状态包括当前的连接数。可以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 字节。1 MB 区域可以保存大约 32,000 个 32 字节状态或大约 16,000 个 64 字节状态。如果区域存储耗尽,服务器将关闭连接。
此外,作为我们 商业订阅的一部分, 自 1.17.7 起 ,可以 使用API获取或 重置每个此类共享内存区域的状态信息。
嵌入变量
- $limit_conn_status
- 
保留限制连接数的结果 (1.17.6):
 PASSED,REJECTED, 或REJECTED_DRY_RUN
