模块 ngx_http_limit_conn_module

`ngx_http_limit_conn_module` 模块用于限制每个定义 key 的连接数，特别是限制来自单个 IP 地址的连接数。

并非所有连接都会被计数。只有当连接有正在被服务器处理的请求且整个请求头已被读取时，该连接才会计数。

http {
    limit_conn_zone $binary_remote_addr zone=addr:10m;

    ...

    server {

        ...

        location /download/ {
            limit_conn addr 1;
        }

设置共享内存区域和给定 key 值允许的最大连接数。当超出此限制时，服务器将返回 错误 作为对请求的响应。例如，指令

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;

启用试运行模式（dry run mode）。在此模式下，连接数不受限制，但在共享内存区域中，超出的连接数仍会照常计数。

limit_conn_log_level error;

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

limit_conn_status 503;

设置拒绝请求时返回的状态码。

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

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

使用示例

limit_conn_zone $binary_remote_addr zone=addr:10m;

在此示例中，客户端 IP 地址用作 key。请注意，此处使用的是 $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 字节状态。如果区域存储空间耗尽，服务器将对所有后续请求返回 错误。

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