模块 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 字节。1 MB 的区域可以保存大约 32000 个 32 字节的状态或大约 16000 个 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