模块 ngx_stream_limit_conn_module
limit_conn limit_conn_dry_run limit_conn_log_level limit_conn_zone 嵌入变量的示例配置 Directives |
模块 (1.9.3) 用于
限制每个定义的键的连接数,在
特别是来自单个 IP 地址的连接数。ngx_stream_limit_conn_module
示例配置
stream { limit_conn_zone $binary_remote_addr zone=addr:10m; ... server { ... limit_conn addr 1; limit_conn_log_level error; } }
Directives
语法: |
limit_conn |
---|---|
默认值: | — |
上下文: |
stream ,server |
设置共享内存区域 以及给定键值允许的最大连接数。 超过此限制时,服务器将关闭连接。 例如,Directives
limit_conn_zone $binary_remote_addr zone=addr:10m; server { ... limit_conn addr 1; }
一次只允许每个 IP 地址有一个连接。
当指定了多个Directives时,
任何配置的限制都将适用。limit_conn
这些Directives继承自之前的配置级别
当且仅当没有Directives时
在当前级别上定义。limit_conn
语法: |
limit_conn_dry_run |
---|---|
默认值: |
limit_conn_dry_run off; |
上下文: |
stream ,server |
该Directives出现在版本 1.17.6 中。
启用试运行模式。 在此模式下,连接数不受限制,但是, 在共享内存区中,将计算过多连接的数量 照常。
语法: |
limit_conn_log_level
|
---|---|
默认值: |
limit_conn_log_level error; |
上下文: |
stream ,server |
为服务器 限制连接数。
语法: |
limit_conn_zone
|
---|---|
默认值: | — |
上下文: |
stream |
设置共享内存区域的参数
这将保留各种 key 的状态。
具体而言,该状态包括当前连接数。
可以包含文本、变量、
及其组合 (1.11.2)。
不考虑键值为空的连接。
使用示例:key
limit_conn_zone $binary_remote_addr zone=addr:10m;
此处,key 是由变量设置的客户端 IP 地址。
的大小对于 IPv4 地址为 4 字节,对于 IPv6 地址为 16 字节。
stored 状态始终占用 32 或 64 字节
在 32 位平台上为 64 字节,在 64 位平台上为 64 字节。
1 MB 区域可以保留大约 32,000 个 32 字节的状态
或大约 16,000 个 64 字节的状态。
如果区域存储已用完,服务器将关闭连接。$binary_remote_addr
$binary_remote_addr
此外,作为我们商业订阅的一部分, 从 1.17.7 开始,可以使用 API 获取或重置每个此类共享内存区域的状态信息。
嵌入变量
$limit_conn_status
- 保留限制连接数的结果 (1.17.6):、 、 或
PASSED
REJECTED
REJECTED_DRY_RUN