模块 ngx_http_limit_conn_module

该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_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 off;

启用试运行模式。在这种模式下，连接数不受限制，但在共享内存区中，超出的连接数照常计算。

limit_conn_log_level error;

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

limit_conn_status 503;

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

设置共享内存区域的参数，该区域将保留各个键的状态。特别是，状态包括当前的连接数。可以key包含文本、变量及其组合。不考虑具有空键值的请求。

在版本 1.7.6 之前，akey只能包含一个变量。

使用示例：

limit_conn_zone $binary_remote_addr zone=addr:10m;

这里，客户端IP地址充当密钥。$remote_addr请注意， 此处使用的是变量，而不是$binary_remote_addr。变量$remote_addr的大小可以在 7 到 15 个字节之间变化。存储的状态在 32 位平台上占用 32 或 64 字节内存，在 64 位平台上始终占用 64 字节。对于 IPv4 地址，变量$binary_remote_addr的大小始终为 4 字节；对于 IPv6 地址，变量的大小始终为 16 字节。存储的状态在 32 位平台上始终占用 32 或 64 字节，在 64 位平台上始终占用 64 字节。1 MB 区域可以保存大约 32,000 个 32 字节状态或大约 16,000 个 64 字节状态。如果区域存储耗尽，服务器将向 所有进一步的请求 返回错误。

此外，作为我们 商业订阅的一部分， 自 1.17.7 起 ，可以 使用API获取或 重置每个此类共享内存区域的状态信息。

该指令在 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