在 nginx 源码编译时添加 limit_req 限流模块,需要在执行 configure 脚本时显式指定 --with-http_limit_req_module 参数。该模块默认通常已包含在标准发行版中,但为了确保编译结果包含此功能,必须将其加入构建配置。配置完成后,运行 make 和 make install 即可完成安装。

如何验证 limit_req 模块是否成功加载
编译安装完成后,可以通过命令行工具检查 Nginx 二进制文件是否链接了该模块。使用 -V 参数(大写)运行 Nginx 可执行文件,输出信息中会列出所有已编译的模块。如果在 nginx -V 的输出中看到 --with-http_limit_req_module,则说明模块已成功集成。

./nginx -V nginx version: nginx/1.24.0 built by gcc 11.4.0 ... configure arguments: --prefix=/etc/nginx --sbin-path=/usr/sbin/nginx --modules-path=/usr/lib64/nginx/modules --conf-path=/etc/nginx/nginx.conf --error-log-path=/var/log/nginx/error.log --http-log-path=/var/log/nginx/access.log --pid-path=/var/run/nginx.pid --lock-path=/var/run/nginx.lock --with-http_limit_req_module
如果输出中缺少该参数,说明编译时未正确添加模块,需要重新执行 configure 并确认参数无误后再次编译。注意区分大小写,且参数之间用空格分隔。
如何在配置文件中启用具体的限流规则
模块加载成功后,需在 nginx.conf 或相关虚拟主机配置中定义限流策略。首先使用 limit_req_zone 指令在 http 块中定义共享内存区域,用于存储请求频率状态。然后在 location 或 server 块中使用 limit_req 指令引用该区域,并设置允许的频率和突发处理行为。

# http 块内定义区域
limit_req_zone $binary_remote_addr zone=mylimit:10m rate=1r/s;
# server 或 location 块内应用规则
server {
listen 80;
server_name example.com;
location /api/ {
limit_req zone=mylimit burst=5 nodelay;
proxy_pass http://backend;
}
}上述配置中,$binary_remote_addr 作为键值,基于客户端 IP 进行限流。zone=mylimit:10m 定义了名为 mylimit 的区域,大小为 10MB,可存储约 16 万个 IP 的状态。rate=1r/s 表示每秒允许一个请求。burst=5 允许最多 5 个请求排队等待,nodelay 表示超出速率的请求立即处理而不延迟。若省略 nodelay,超出部分将被延迟处理以平滑流量。当请求超过限制时,Nginx 默认返回 503 Service Temporarily Unavailable 错误,可通过 limit_req_status 指令自定义状态码。


















