请求限制#

该模块用于根据定义的键限制请求处理速率，特别是限制来自单个 IP 地址的请求处理速率。限制是通过“漏桶”方法实现的。

配置示例# 

http {
    limit_req_zone $binary_remote_addr zone=one:10m rate=1r/s;

    ...

    server {

        ...

        location /search/ {
            limit_req zone=one burst=5;
        }

指令#

limit_req#

语法

limit_req zone number [burst=number] [nodelay | delay=number];

默认值

—

上下文

http, server, location

设置共享内存区域和请求的最大突发大小。如果请求速率超过为某个区域配置的速率，它们的处理将被延迟，以便请求以定义的速率进行处理。多余的请求将被延迟，直到其数量超过最大突发大小，在这种情况下，请求将以 错误 终止。默认情况下，最大突发大小为零。例如，指令

limit_req_zone $binary_remote_addr zone=one:10m rate=1r/s;

server {
    location /search/ {
        limit_req zone=one burst=5;
    }

平均允许每秒最多 1 个请求，突发不超过 5 个请求。

如果不希望在请求被限制时延迟多余的请求，应使用参数 nodelay：

limit_req zone=one burst=5 nodelay;

参数 delay 指定延迟多余请求的限制。默认值为零，即所有多余请求都被延迟。

可以有几个 limit_req 指令。例如，以下配置将限制来自单个 IP 地址的请求处理速率，同时限制虚拟服务器的请求处理速率：

limit_req_zone $binary_remote_addr zone=perip:10m rate=1r/s;
limit_req_zone $server_name zone=perserver:10m rate=10r/s;

server {
    ...
    limit_req zone=perip burst=5 nodelay;
    limit_req zone=perserver burst=10;
}

这些指令仅在当前级别未定义 limit_req 指令时从上一级配置继承。

limit_req_dry_run#

语法

limit_req_dry_run on | off;

默认值

limit_req_dry_run off;

上下文

http, server, location

启用试运行模式。在这种模式下，请求处理速率不受限制，但在 共享内存区域 中，多余请求的数量仍按常规计数。

limit_req_log_level#

语法

limit_req_log_level info | notice | warn | error;

默认值

limit_req_log_level error;

上下文

http, server, location

设置服务器因速率过高拒绝处理请求或延迟请求处理时的日志记录级别。延迟的日志记录级别比拒绝的低一个级别；例如，如果指定 limit_req_log_level notice，则延迟以 info 级别记录。

limit_req_status#

语法

limit_req_status code;

默认值

limit_req_status 503;

上下文

http, server, location

设置响应被拒请求时返回的状态码。

limit_req_zone#

语法

limit_req_zone key zone=name:size rate=rate;

默认值

—

上下文

http

为共享内存区域设置参数，该区域将保留各种键的状态。特别是，状态存储当前多余请求的数量。键可以包含文本、变量及其组合。具有空键值的请求不计算在内。

使用示例：

limit_req_zone $binary_remote_addr zone=one:10m rate=1r/s;

在这里，状态保存在一个 10 兆字节的区域 one 中，此区域的平均请求处理速率不能超过每秒 1 个请求。

客户端 IP 地址用作键。请注意，这里使用的是 $binary_remote_addr 变量，而不是 $remote_addr。

$binary_remote_addr 变量的大小对于 IPv4 地址始终为 4 字节，对于 IPv6 地址为 16 字节。存储的状态在 32 位平台上始终占用 64 字节，在 64 位平台上占用 128 字节。

一个兆字节的区域可以保留大约 16,000 个 64 字节状态或大约 8,000 个 128 字节状态。

如果区域存储已满，最近最少使用的状态将被移除。如果即便如此也无法创建新状态，请求将以 错误 终止。

rate 以每秒请求数 (r/s) 指定。如果希望小于每秒一个请求的速率，则以每分钟请求数 (r/m) 指定。例如，半个请求每秒为 30r/m。

内置变量#

$limit_req_status#

保持请求处理速率限制的结果：PASSED、DELAYED、REJECTED、DELAYED_DRY_RUN 或 REJECTED_DRY_RUN

目录