模块 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 版之前，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 字节。一个兆字节的区域可以保留大约 3.2 万个 32 字节的状态或大约 1.6 万个 64 字节的状态。如果区域存储已用尽，服务器将向所有进一步的请求返回 error。

此外，作为我们 商业订阅 的一部分，自 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