nginx的ngx_http_limit_req_module是默认内置模块，无需编译开关，只需正确配置limit_req_zone（http块）和limit_req（server或location块），并确保pcre等基础依赖已安装。
Nginx 的 ngx_http_limit_req_module 是默认内置模块，不需要额外启用或编译开关，只要使用官方源码编译，默认就包含它。
你真正需要做的，是确保配置语法正确、依赖项齐全，并在 nginx.conf 中合理使用 limit_req_zone 和 limit_req 指令。
✅ 确认模块已存在（无需 configure 开关）
该模块属于 Nginx 核心 HTTP 模块之一，不依赖 --with-* 或 --without-* 参数。
执行以下命令即可验证：
nginx -V 2>&1 | grep -o "limit_req"
只要输出中出现 limit_req，说明模块已编译进二进制。
⚠️ 注意：某些极简定制版（如通过
--without-http_rewrite_module连带禁用部分依赖）可能间接影响，但纯禁用 rewrite 不会移除 limit_req；它只依赖基础 HTTP 框架和pcre（用于变量匹配，如$binary_remote_addr）。
✅ 编译前需确保的依赖项
虽然模块本身不用显式开启，但它的功能依赖以下基础支持：
-
PCRE 库（含开发头文件）：用于解析
$binary_remote_addr、$http_user_agent等变量# CentOS/RHEL sudo yum install pcre-devel # Ubuntu/Debian sudo apt-get install libpcre3-dev
zlib-devel（可选但推荐）：若配合 gzip 压缩响应，或使用某些高级限流逻辑中的 header 处理
gcc、make、openssl-devel：常规编译依赖，与限流无直接关系，但缺失会导致 configure 失败
✅ 配置示例：在 nginx.conf 中启用限流
在 http{} 块中定义限流区域：
http {
limit_req_zone $binary_remote_addr zone=one:10m rate=5r/s;
server {
location /api/ {
limit_req zone=one burst=10 nodelay;
proxy_pass http://backend;
}
}
}
-
zone=one:10m：分配 10MB 内存存储客户端 IP 计数器 -
rate=5r/s：平均限速为每秒 5 个请求 -
burst=10：允许突发最多 10 个请求（先排队后处理） -
nodelay：不延迟执行，burst 内的请求立即处理（否则按速率匀速放出）
❌ 常见错误与排查
配置报错
unknown directive "limit_req_zone"
→ 通常是nginx -V显示未编译该模块（极少见），或你用了阉割版源码（如 OpenResty 的精简分支）。建议用 nginx.org 官方源码 重新编译。限流不生效
→ 检查是否写在http{}级别（limit_req_zone必须在 http 块）
→ 确认limit_req所在 location 是否被其他if、rewrite或proxy_pass覆盖
→ 查看 error.log 是否有limiting requests, excess: ...日志（开启error_log ... info;可见详情）CDN 后真实 IP 丢失导致限流失效
→ 需搭配set_real_ip_from+real_ip_header X-Forwarded-For，并启用--with-http_realip_module
不复杂但容易忽略。
