Module 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 |
---|---|
默认值 | — |
上下文 |
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 字节。一个兆字节的区域可以容纳大约 3 万 2 千个 32 字节的状态或大约 1 万 6 千个 64 字节的状态。如果区域存储空间耗尽,服务器将关闭连接。
此外,作为我们商业订阅的一部分,自 1.17.7 版本起,可以通过 API 获取或 重置每个此类共享内存区域的状态信息。
内嵌变量
$limit_conn_status
- 保持连接数限制的结果 (1.17.6):
PASSED
(通过),REJECTED
(拒绝), 或REJECTED_DRY_RUN
(试运行拒绝)