模块 ngx_http_limit_req_module

使用模块 （0.7.21） 要限制每个已定义键的请求处理速率， 特别是，收到的请求的处理率 来自单个 IP 地址。 使用 “leaky bucket” 方法完成限制。ngx_http_limit_req_module

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

    ...

    server {

        ...

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

设置共享内存区域 以及请求的最大突增大小。 如果请求速率超过为区域配置的速率， 它们的处理被延迟，以便处理请求 以定义的速率。 过多的请求将被延迟，直到其数量超过 最大突发大小 在这种情况下，请求将终止并显示错误。 默认情况下，最大突增大小等于零。 例如，Directives

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

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

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

如果在请求受到限制时延迟过多的请求不是 desired，则应使用该参数：nodelay

limit_req zone=one burst=5 nodelay;

参数 （1.15.7） 指定限制 此时，过多的请求将延迟。 默认值为零，即所有过多的请求都会被延迟。delay

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

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;
}

这些Directives继承自之前的配置级别 当且仅当没有Directives时 在当前级别上定义。limit_req

limit_req_dry_run off;

启用试运行模式。 在此模式下，请求处理速率不受限制，但是， 在共享内存区中，将计算超额请求的数量 照常。

limit_req_log_level error;

设置所需的日志记录级别 服务器拒绝处理请求时 由于速率超过， 或延迟请求处理。 延迟的日志记录级别比拒绝低 1 分;例如 如果指定了 “”， 延迟记录在 Level 中。limit_req_log_level noticeinfo

limit_req_status 503;

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

设置共享内存区域的参数 这将保留各种 key 的状态。 具体而言，状态存储当前过多的请求数。 可以包含文本、变量及其组合。 不考虑具有空 key 值的请求。key

在 1.7.6 版本之前， a 可以只包含一个变量。key

使用示例：

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

在这里，状态保存在 10 MB 的区域“1”中，并且 此区域的平均请求处理速率不能超过 每秒 1 个请求。

客户端 IP 地址用作密钥。 请注意，此处使用的变量不是 。 变量的大小 对于 IPv4 地址，始终为 4 字节，对于 IPv6 地址，始终为 16 字节。 stored 状态始终占用 在 32 位平台上为 64 字节，在 64 位平台上为 128 字节。 1 MB 区域可以保留大约 16,000 个 64 字节的状态 或大约 8000 个 128 字节的状态。$remote_addr$binary_remote_addr$binary_remote_addr

如果区域存储已用尽，则会删除最近最少使用的状态。 如果在此之后无法创建新状态，则请求将终止，并 一个错误。

速率以每秒请求数 （r/s） 为单位指定。 如果需要每秒少于一个请求的速率， 它在每分钟请求数 （r/m） 中指定。 例如，每秒的半个请求为 30r/m。

参数 （1.15.3） 启用共享内存区域的同步。sync

该参数作为我们商业订阅的一部分提供。sync

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

$limit_req_status

保留限制请求处理速率的结果 （1.17.6）：、、、 或PASSEDDELAYEDREJECTEDDELAYED_DRY_RUNREJECTED_DRY_RUN