nginx：对请求做限制的limit_req模块

最新推荐文章于 2025-10-26 06:04:38 发布
原创 最新推荐文章于 2025-10-26 06:04:38 发布 · 585 阅读 · 0 ·
CC 4.0 BY-SA版权
版权声明：本文为博主原创文章，遵循 CC 4.0 BY-SA 版权协议，转载请附上原文出处链接和本声明。

本文详细介绍了Nginx的ngx_http_limit_req_module模块，该模块基于leakybucket算法在NGX_HTTP_PREACCESS_PHASE阶段对请求进行限流。文章解释了如何通过limit_conn_log_level和limit_conn_status指令配置限流时的日志级别和返回错误码，适用于所有worker进程。

ngx_http_limit_req_module模块


生效阶段：NGX_HTTP_PREACCESS_PHASE阶段

模块：http_limit_req_module

默认编译进nginx，通过--without-http_limit_req_module来禁用

生效算法：leaky bucket算法

生效范围：

   （1）全部worker进程（基于共享内存）

   （2） 进入preaccess阶段前不生效

1.limit_conn_log_level指令（限制发生时的日志级别）

   limit_conn_log_level  info|notice|warn|error

  默认limit_conn_log_level  error

 放置位置：http，server，location

 2.limit_conn_status 指令（限制发生时向客户端返回的错误码）

  limit_conn_status  code

  默认：limit_conn_status 503

nginx使用自带的ngx_http_limit_req_module模块实现接口防刷
qq_30029665的博客
11-24 1634
比如在下两秒中，这个 IP 又进来一个相同的请求，那就对不起了，nginx 就会立马返回错误，因为 nginx 在这三秒内已经处理了三次这个请求了。再看并发 发 10 次请求，所有的请求都完成也是花费了 2 秒多 ，有 7 个请求是失败的，那相对的也是有 3 个请求是成功的，看图。再看并发 发 10 次请求，全部在一秒之内完成请求，有 7 个请求是失败的，那相对的也是有 3 个请求是成功的，看图。先是并发 发 3 次请求，所有的请求都完成花费了 2 秒多 ，3 个请求全部成功，看图。
爬坑Nginx limit_req
MacwinWin的博客
09-14 659
不知道什么时候开始，我对Nginx的limit_req印象是下面这样的： 下面的配置通过rate参数，实现每秒300次请求的处理 http { limit_req_zone $binary_remote_addr zone=perip:2m rate=300r/s; server { location ~ / { limit_req zone=perip; } } } 但如果你用ab进行测试，你会发现 >>> ab -c 300 -n 300
nginx limit_req模块参数说明
focus on security
05-25 692
limit_req_zone $binary_remote_addr zone=req10k:30m rate=100000000r/s; limit_req zone=req10k burst=100000000; rate：每秒可以处理的请求数。 burst：等待处理的请求队列长度。 delay：等待队列中，不需要等待，可以立刻处理的请求数目。 nodelay：一旦设置，相当于delay设置为max int，rate+burst数量的请求全部可以瞬时处理。 例如：rate=1...
Nginx请求限制：Linux-Tutorial中的limit_req与limit_conn配置
最新发布
gitblog_00396的博客
10-26 789
在高并发场景下，服务器经常面临恶意请求、爬虫攻击或突发流量导致的过载问题。Nginx提供两种核心限流机制：请求速率限制（limit_req）和并发连接限制（limit_conn），可有效保护后端服务稳定性。项目中[Nginx安装和配置文档](https://link.gitcode.com/i/c6019b8f1a098fb6b8a0708edbbd3691)已涵盖基础防护配置，本文将深入解析这两...
Nginx-http_limit_req_module模块
cuiwin的专栏
07-06 2357
如何限制每个客户端每秒处理请求数后续会继续补充更多使用的案例。
Nginx http_limit_req_module服务器请求限流
qq_45255414的博客
07-20 1618
nginx 可以使用ngx_http_limit_req对服务器资源请求进行限制，这对使用ab等工具恶意压测服务器和cc(challenge Collapsar)会有一定的防范作用。防止用户恶意攻击刷爆服务器。 ngx_http_limit_req_module模块是nginx默认安装的，所以直接配置即可。 该模块使用漏斗算法（Leaky Bucket），该算法有两种处理方式Traffic Shaping和Traffic Policing 在桶满水之后，常见的两种处理方式为： 1.暂时拦截住上方水
精选资源
ngx_dynamic_limit_req_module:ngx_dynamic_limit_req_module模块用于动态锁定IP并定期释放它
05-07
ngx_dynamic_limit_req_module模块用于动态锁定IP并定期释放它。 目录 dynamic_limit_req_zone 设置共享内存区域的参数，该参数将保留各种键的状态。 特别是，状态存储当前的过多请求数。 键可以包含文本，变量及其...
精选资源
Nginx使用limit_req_zone对同一IP访问进行限流的方法
01-10
nginx可以使用ngx_http_limit_req_module模块的limit_req_zone指令进行限流访问，防止用户恶意攻击刷爆服务器。ngx_http_limit_req_module模块是nginx默认安装的，所以直接配置即可。 首先，在nginx.conf文件中的...
Nginx: 配置项之http模块connection和request的用法以及limit_conn和limit_req模块
Wang的专栏
08-23 2445
比如说我们在这儿，至于去引用的limitIQ我们都知道我们的IQ定义status，我们上面是返回的这个五零三，我们在这以示区别，我们让它返回五零四，好吧，继续我们的limitREQ还有什么呀？ok那接下来我们给大家演示一下啊，呃我们还接着上一节的我们这个配置文件，我们直接给大家做展示啊，户下的con零x，还是我们先在这儿去定义我们这个root是吧？第一次没关系，第二次肯定哎，我们在这没有记录进去，我们的这个啊嗯不对，这个时候我们在来给它啊，因为我们在这没定义我们的日志啊，我们再来引用一个日志吧。
Nginx限流模块limit_req_zone、limit_req_conn
云深海阔专栏
09-02 9885
根据nginx官网提供的说法,有两种算法,一种是漏桶算法,一种是令牌桶算法. limit_req_zone 用来限制单位时间内的请求数目,以及速度限制。 limit_req_conn 用来限制同一时间连接数，即并发限制。 一、令牌桶算法 令牌桶: 令牌以固定速率产生，并缓存到令牌桶中； 令牌桶放满时，多余的令牌被丢弃； 请求要消耗等比例的令牌才能被处理； 令牌不够时，请求被缓存或者被拒绝 二、漏桶算法 漏桶算法 水（请求）从上方倒入水桶，从水桶下方流出（被处理）； 来不及流出的水存在水桶中（
nginx限制请求(ngx_http_limit_req_module)模块和nginx设置ip白名单
yaodunlin的博客
07-25 1013
Example Configuration http { limit_req_zone $binary_remote_addr zone=one:10m rate=1r/s; ... server { ... location /search/ { limit_req zone=one burst=120 nodelay; } 一、limit_req_zone 语法：limi...
Nginx 的 ngx_http_limit_conn_module、ngx_http_limit_req_module中的limit相关配置参数
qq_25934401的博客
09-20 1540
ngx_http_limit_req_module 模块(nginx 自带本模块除非编译时使用了–without-http_limit_req_module) 本模块基于漏斗算法（Leaky Bucket） 该算法有两种处理方式（水桶满水之后） Traffic Shaping：暂时拦截住上方水的向下流动，等待桶中的一部分水漏走后，再放行上方水。此方式的核心是等待。 Traffic Policin...
Nginx中的limit_req模块和limit_conn模块详解
你知道莽村的莽怎么来的吗!
05-22 2851
limit_req 模块用于限制客户端请求的频率，以防止单一客户端占用过多服务器资源，提升稳定性。limit_conn 模块用于限制每个客户端的并发连接数，以防止资源被单一客户端耗尽。
nginx limit_req_zone并发限制reload不成功
qq_39241948的博客
08-21 2593
背景： 在原来并发限制的需求下，增加白名单并发限制，所以需要更改对应的key 更改前： 参数解释： 桶空间10m，10M能保持大约16万个(IP)状态 速率rate=100，峰值burst=25，不延迟请求 加了nodelay之后，漏桶控制一段时长内的平均qps = 漏桶速率，允许瞬时的峰值qps > 漏桶qps ，所以峰值时的最高qps=(brust+qps-1)=124 请求不会被delay，要么处理，要么直接返回503 更改后： 参数解释： geo指令为该模块创建变量，其值取决于客户端的 I
Nginx：Nginx limit_req limit_conn限速
weixin_30312659的博客
11-20 299
简介 Nginx是一个异步框架的Web服务器，也可以用作反向代理，负载均衡器和HTTP缓存，最常用的便是Web服务器。nginx对于预防一些攻击也是很有效的，例如CC攻击，爬虫，本文将介绍限制这些攻击的方法，可以使用nginx的ngx_http_limit_conn_module、ngx_http_limit_req_module这两个模块达到目的，该模块为nginx内置模块，yum安装即有，无...
利用Nginx模块进行请求限制——limit_conn_module、limit_req_module
yicixin's blog
08-07 731
环境: CentOS7 Nginx 1.16.0
Nginx模块(upstream和ngx_http_limit_req_module)使用
终日思 < 须臾学
12-30 1505
如何有效的防刷？限制某个IP某一时间段的访问次数是一个让人头疼的问题，起初有同事说自己写LUA脚本进行控制，后面再Nginx网上找到对应的模块ngx_http_limit_req_module
Linux Nginx安装以及可能出现错误
点点悠悠的点点滴滴
05-10 3146
从 http://nginx.org/download/nginx-1.9.15.tar.gz 下载nginx包(或者wget http://nginx.org/download/nginx-1.9.15.tar.gz直接在Linux上用命令下载)解压并转到目录下tar -zxvf nginx-1.9.15.tar.gz cd nginx-1.9.15 设置一下配置信息 ./configure --
ERROR: nginx: [emerg] "limit_req" directive is not allowed here in /www/server/panel/vhost/rewrite/foshan.gdhuoyun56.com.conf:9 nginx: configuration file /www/server/nginx/conf/nginx.conf test failed 以上报错是ngnixlocation ~* (runtime|application)/{ return 403; } location / { if (!-e $request_filename){ rewrite ^(.*)$ /index.php?s=$1 last; break; } if ($http_user_agent ~* "Googlebot") { limit_req zone=spider_limit; } } 什么原因
08-10
<think>我们正在解决Nginx配置中出现的"limit_req directive is not allowed here"错误。 根据引用[2]和[3]的内容，这个错误通常是因为limit_req指令被放置在了错误的配置块中。 在Nginx中，limit_req指令只能用于特定的上下文（context），比如http, server, location等。 错误原因分析： 1. 指令位置错误：limit_req指令不能放在某些配置块中，比如在if块中，或者在不支持该指令的块中。 2. 语法错误：可能是limit_req指令的参数不正确，比如缺少必需的参数。 解决方法： 1. 确保limit_req指令只出现在http, server, location块中。 2. 检查limit_req指令的参数是否正确。limit_req指令至少需要两个参数：zone和burst（可选），例如： limit_req zone=one burst=5; 3. 在定义limit_req_zone时，确保它位于http块内，并且语法正确。引用[2]中提到一个错误：invalid number of arguments in “limit_req_zone”，这通常是因为参数数量不正确。 4. 引用[2]中给出的一个例子是： limit_req_zone $server_name zone=all_req:20m rate=2r/s; 这个指令定义了一个名为all_req的共享内存区域，大小为20m，限制速率是每秒2个请求。 5. 引用[1]中提到了一个日志格式的配置，其中包含了`$limit_req_status`变量，这个变量用于记录请求被限流的状态（如PASSED, DELAYED, REJECTED等）。在配置了限流后，可以在日志中查看该变量以监控限流效果。 配置步骤示例： 步骤1：在http块中定义共享内存区域（zone） ```nginx http { limit_req_zone $binary_remote_addr zone=perip:10m rate=1r/s; # 或者按照引用[2]中的例子，使用$server_name来限制整个服务器的请求速率 limit_req_zone $server_name zone=all_req:20m rate=2r/s; # 日志格式，加入$limit_req_status（引用[1]） log_format limit '$remote_addr - $remote_user [$time_local] ' '"$request" $status $body_bytes_sent ' '"$http_referer" "$http_user_agent" ' '"$limit_req_status"'; access_log /var/log/nginx/access.log limit; server { ... } } ``` 步骤2：在server或location块中使用limit_req指令 ```nginx server { location / { # 使用之前定义的perip区域，设置突发队列大小为5 limit_req zone=perip burst=5; # 或者使用针对整个服务器的限流 limit_req zone=all_req burst=10; ... } } ``` 注意事项： - limit_req_zone指令只能在http块中配置。 - 变量$binary_remote_addr代表客户端IP的二进制形式，占用空间小（64位机器上为64字节），而$remote_addr是字符串形式（最多15字节）。因此使用$binary_remote_addr可以节省内存。 - burst参数定义了突发请求的队列大小。当请求超过速率限制时，超过的请求会被放入队列延迟处理，如果队列已满，则返回503错误。 - 还可以使用nodelay参数，这样在突发请求时，队列中的请求会立即处理，而不按照速率延迟，直到队列满。例如：`limit_req zone=perip burst=5 nodelay;` 错误排查： 如果配置后Nginx启动失败，可以使用命令检查配置： nginx -t 它会指出配置错误的具体位置和原因。 引用[3]提到，这个模块是用来限制连接数的，但注意limit_req_zone和limit_conn_zone是两个不同的模块： - limit_req_zone：限制请求速率（rate limiting） - limit_conn_zone：限制同时连接数（connection limiting） 因此，请确保你使用的是正确的模块。 相关问题： 1. 如何配置Nginx限制单个IP的并发连接数？ 2. Nginx限速模块中burst和nodelay参数的作用是什么？ 3. 如何通过日志监控Nginx限流效果？ 4. Nginx返回503错误时如何自定义错误页面？ 5. 如何测试Nginx限速配置是否生效？</think>### Nginx "limit_req directive is not allowed here" 错误原因及解决方法 #### 错误原因分析 1. **指令位置错误** `limit_req` 指令只能出现在特定的配置块中： - `http` 块 - `server` 块 - `location` 块 - `if` 块（在 `location` 上下文中） 若出现在其他位置（如 `events` 块或根配置区），会触发此错误[^2][^3]。 2. **`limit_req_zone` 未正确定义** 未在 `http` 块中预先定义共享内存区域： ```nginx # 必须在 http 块中定义 http { limit_req_zone $binary_remote_addr zone=req_limit:10m rate=5r/s; } ``` 3. **语法参数错误** 常见语法问题： - 缺少必需的 `zone` 参数 - 内存区域名称未定义 - 速率格式错误（正确格式：`10r/s` 或 `30r/m`）[^2] 4. **多指令冲突** 同时配置多个限流规则时，若作用域重叠或参数冲突会导致错误[^2]。 --- #### 解决方案 ##### 1. 基础正确配置 ```nginx http { # 定义共享内存区域（必须在 http 块） limit_req_zone $binary_remote_addr zone=req_per_ip:10m rate=10r/s; server { location / { # 应用限流（在 location 块） limit_req zone=req_per_ip burst=20; } } } ``` ##### 2. 多规则配置（引用[2]示例） ```nginx http { # IP级限流 limit_req_zone $binary_remote_addr zone=per_ip:10m rate=5r/s; # 服务级总限流 limit_req_zone $server_name zone=all_req:20m rate=2r/s; [^2] server { location /api { # 叠加两种限流 limit_req zone=per_ip burst=10; limit_req zone=all_req burst=30; } } } ``` ##### 3. 日志监控配置（引用[1]示例） ```nginx http { log_format limit '$remote_addr - $limit_req_status'; [^1] access_log /var/log/nginx/limit.log limit; server { location / { limit_req zone=req_zone; limit_req_status 429; # 自定义限流状态码 } } } ``` ##### 4. 常见错误修复 ```diff # 错误示例（指令位置错误） events { - limit_req_zone ...; # 禁止在此区域定义 } # 正确位置 http { + limit_req_zone $binary_remote_addr zone=correct_zone:10m rate=1r/s; } ``` --- #### 关键注意事项 1. **作用域优先级** `location` > `server` > `http`，低层级配置会覆盖高层级配置 2. **内存区域计算** 内存大小估算公式： $$ \text{存储IP数} = \frac{\text{内存大小(字节)}}{128} $$ 例如 `10m` 内存可存储约 82,000 个 IP[^3] 3. **burst 参数作用** - `burst=20`：允许突发 20 个请求排队 - `nodelay`：立即处理突发请求（不延迟） 4. **配置验证命令** ```bash nginx -t # 测试配置语法 tail -f /var/log/nginx/error.log # 查看详细错误 ``` --- #### 调试技巧 1. **日志分析** 通过 `$limit_req_status` 字段监控限流状态[^1]： - `PASSED`：请求通过 - `DELAYED`：请求被延迟处理 - `REJECTED`：请求被拒绝 2. **压力测试工具** 使用 `wrk` 测试限流效果： ```bash wrk -t4 -c100 -d10s http://your-server/api ``` 3. **实时监控** ```bash watch -n1 "grep $limit_req_status /var/log/nginx/access.log | awk '{print \$NF}' | sort | uniq -c" ``` --- ### 相关问题 1. Nginx 的 `limit_conn` 和 `limit_req` 模块有何区别？ 2. 如何通过 Nginx 限制特定 User-Agent 的访问频率？ 3. `burst` 和 `nodelay` 参数如何影响请求处理？ 4. Nginx 返回 503 服务不可用错误时如何自动重试？ 5. 如何通过 Kubernetes Ingress 实现全局速率限制？
评论
成就一亿技术人!
拼手气红包6.0元
还能输入1000个字符
 
红包 添加红包
表情包 插入表情
表情包 代码片
 条评论被折叠 查看
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值