模块 ngx_http_limit_conn_module
示例配置 指令 limit_conn limit_conn_dry_run limit_conn_log_level limit_conn_status limit_conn_zone limit_zone 嵌入变量 |
模块 ngx_http_limit_conn_module
用于限制每个定义键的连接数,特别是来自单个 IP 地址的连接数。
并非所有连接都计算在内。只有在服务器正在处理请求并且已经读取了整个请求头的情况下,才会计算连接。
示例配置
http { limit_conn_zone $binary_remote_addr zone=addr:10m; ... server { ... location /download/ { limit_conn addr 1; }
指令
语法: | limit_conn |
---|---|
默认值: | — |
上下文: | http , server , location |
设置共享内存区和给定键值的最大允许连接数。当超过此限制时,服务器将以错误的形式回复请求。例如,指令
limit_conn_zone $binary_remote_addr zone=addr:10m; server { location /download/ { limit_conn addr 1; }
一次只允许一个 IP 地址的连接。
在 HTTP/2 和 HTTP/3 中,每个并发请求被视为单独的连接。
可能会有多个 limit_conn
指令。例如,以下配置将限制每个客户端 IP 到服务器的连接数,并且同时限制到虚拟服务器的总连接数:
limit_conn_zone $binary_remote_addr zone=perip:10m; limit_conn_zone $server_name zone=perserver:10m; server { ... limit_conn perip 10; limit_conn perserver 100; }
这些指令将从上一个配置级别继承,只有在当前级别未定义 limit_conn
指令时才会继承。
语法: | limit_conn_dry_run |
---|---|
默认值: |
limit_conn_dry_run off; |
上下文: | http , server , location |
此指令在版本 1.17.6 中首次出现。
启用干运行模式。在此模式下,不会限制连接数,但是在共享内存区中,将像往常一样计算多余连接的数量。
语法: | limit_conn_log_level |
---|---|
默认值: |
limit_conn_log_level error; |
上下文: | http , server , location |
此指令在版本 0.8.18 中首次出现。
设置服务器限制连接数时所需的日志记录级别。
语法: | limit_conn_status |
---|---|
默认: |
limit_conn_status 503; |
上下文: | http , server , location |
该指令首次出现于版本 1.3.15。
设置响应被拒绝时返回的状态码。
语法: | limit_conn_zone |
---|---|
默认: | — |
上下文: | http |
设置一个共享内存区域的参数,用于保存各种键的状态。特别是,状态包括当前连接数。 key
可包含文本、变量及其组合。带有空键值的请求不计入统计。
在版本 1.7.6 之前,一个 key
只能包含一个变量。
用法示例:
limit_conn_zone $binary_remote_addr zone=addr:10m;
在此示例中,客户端 IP 地址作为键。请注意,此处使用了 $binary_remote_addr
变量而不是 $remote_addr
变量。 $remote_addr
变量的大小可能为 7 到 15 字节。存储的状态在 32 位平台上占用 32 或 64 字节的内存,而在 64 位平台上始终占用 64 字节。 $binary_remote_addr
变量的大小始终为 IPv4 地址的 4 字节或 IPv6 地址的 16 字节。在 32 位平台上,存储的状态始终占用 32 或 64 字节的内存,在 64 位平台上始终占用 64 字节的内存。一个兆字节的区域可以保存大约 32 千个 32 字节状态或大约 16 千个 64 字节状态。如果区域存储耗尽,服务器将对所有进一步的请求返回错误。
此外,作为我们的商业订阅的一部分,自 1.17.7 版以来,可以使用API获取或重置每个这样的共享内存区域的状态信息。
语法: | limit_zone |
---|---|
默认: | — |
上下文: | http |
该指令在版本 1.1.8 中已过时,并在版本 1.7.6 中被移除。应改用具有更改语法的等效limit_conn_zone指令:
limit_conn_zone
$variable
zone
=name
:size
;
嵌入变量
-
$limit_conn_status
-
保存连接数限制的结果(1.17.6):
PASSED
、REJECTED
或REJECTED_DRY_RUN