Module ngx_http_limit_conn_module

• Example Configuration
• Directives
  • limit_conn
  • limit_conn_dry_run
  • limit_conn_log_level
  • limit_conn_status
  • limit_conn_zone
  • limit_zone
• Embedded Variables
  

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

设置共享内存区域和给定键值的最大允许连接数。当超过此限制时，服务器将返回error来回复请求。例如，指令

limit_conn_zone $binary_remote_addr zone=addr:10m;

server {
    location /download/ {
        limit_conn addr 1;
    }

一次每个 IP 地址只允许一个连接。

可能有多个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指令时，这些指令才从上一级继承。

该指令出现在版本 1.17.6 中。

启用空运行模式。在此模式下，连接数不受限制，但是，在共享内存区域中，过多连接的数将照常计算。

该指令出现在版本 0.8.18 中。

为服务器限制连接数的情况设置所需的日志记录级别。

该指令出现在 1.3.15 版中。

设置状态代码以响应被拒绝的请求而返回。

设置共享内存区域的参数，该参数将保留各种键的状态。特别是，状态包括当前的连接数。 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返回所有其他请求。

该指令在 1.1.8 版中已过时，在 1.7.6 版中已删除。应当使用等效的limit_conn_zone伪指令(其语法已更改)代替：

Embedded Variables

$limit_conn_status

• 保留限制连接数(1.17.6)的结果：PASSED，REJECTED或REJECTED_DRY_RUN