Module ngx_http_limit_conn_module
ngx_http_limit_conn_module模块用于限制每个定义的键的连接数，特别是来自单个 IP 地址的连接数。
并非所有连接都被计数。仅当连接具有服务器正在处理的请求并且已经读取了整个请求 Headers 时，才对连接进行计数。
Example Configuration
http {
limit_conn_zone $binary_remote_addr zone=addr:10m;
...
server {
...
location /download/ {
limit_conn addr 1;
}
Directives
| Syntax: | limit_conn zone number; |
| Default: | — |
| Context: | http , server , location |
设置共享内存区域和给定键值的最大允许连接数。当超过此限制时，服务器将返回error来回复请求。例如，指令
limit_conn_zone $binary_remote_addr zone=addr:10m;
server {
location /download/ {
limit_conn addr 1;
}
一次每个 IP 地址只允许一个连接。
Note
在 HTTP/2 和 SPDY 中，每个并发请求都被视为一个单独的连接。
可能有多个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指令时，这些指令才从上一级继承。
| Syntax: | limit_conn_dry_run on | off; |
| Default: | limit_conn_dry_run off; |
| Context: | http , server , location |
该指令出现在版本 1.17.6 中。
启用空运行模式。在此模式下，连接数不受限制，但是，在共享内存区域中，过多连接的数将照常计算。
| Syntax: | limit_conn_log_level info | notice | warn | error; |
| Default: | limit_conn_log_level error; |
| Context: | http , server , location |
该指令出现在版本 0.8.18 中。
为服务器限制连接数的情况设置所需的日志记录级别。
| Syntax: | limit_conn_status code; |
| Default: | limit_conn_status 503; |
| Context: | http , server , location |
该指令出现在 1.3.15 版中。
设置状态代码以响应被拒绝的请求而返回。
| Syntax: | limit_conn_zone key zone=name:size; |
| Default: | — |
| Context: | http |
设置共享内存区域的参数，该参数将保留各种键的状态。特别是，状态包括当前的连接数。 key可以包含文本，变量及其组合。密钥值为空的请求不予考虑。
Note
在版本 1.7.6 之前，key只能包含一个变量。
Usage example:
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 字节。一个 1 兆字节的区域可以保留大约 3.2 万个 32 字节状态或大约 1.6 万个 64 字节状态。如果区域存储空间用完，服务器将把error返回所有其他请求。
Note
另外，作为commercial subscription的一部分，每个此类共享存储区的status information自 1.17.7 起可以是obtained或reset，而API。
| Syntax: | limit_zone name $variable size; |
| Default: | — |
| Context: | http |
该指令在 1.1.8 版中已过时，在 1.7.6 版中已删除。应当使用等效的limit_conn_zone伪指令(其语法已更改)代替：
Note
limit_conn_zone $variable zone = name : size ;
Embedded Variables
$limit_conn_status
- 保留限制连接数(1.17.6)的结果：
PASSED，REJECTED或REJECTED_DRY_RUN
