Nginx limit_conn 何时计数:为何不能当作全部 TCP 连接上限

23次阅读
没有评论

共计 1812 个字符,预计需要花费 5 分钟才能阅读完成。

limit_conn 不是全部 TCP 连接的硬上限。只有连接上存在服务器正在处理的请求,并且整个请求头已经读完,才进入 limit_conn 的计数。因此,把系统里看到的 socket 总数直接与它的阈值比较,往往混用了两种统计口径。 ↗

先问连接是否满足计数条件

文档明确说明,并非所有连接都会被统计。由“请求正在处理”和“完整请求头已读完”这两个条件可以推知,尚未提交完整请求头的连接不满足计数条件;只是在等待新请求的空闲连接,也不能直接当作该模块正在限制的处理请求。这是条件推论,不是额外的超时或协议规则。 ↗

官方文档规定,在 HTTP/2 和 HTTP/3 中,每个并发请求分别计为一个连接。 这是一条计数规则,不应据此把这些协议统称为 TCP 连接,也不应把一个底层传输上的并发请求都合并算作一次。 ↗

键、共享区和阈值各负责什么

limit_conn_zone 在 http 上下文定义键及共享内存区,limit_conn 引用该区并设置同一键值允许的计数上限。文档示例使用 $binary_remote_addr 作为客户端地址键;键为空值的请求不计入。使用自定义变量作键时,要先核对它在目标请求上是否有值。 ↗

可以同时定义多个 limit_conn,分别约束不同的键。继承条件也需核对:只有当前层级没有任何 limit_conn 指令时,才继承上一层级的相关指令。在位置块新增一条局部限制后,不能继续假设上层的全部限制仍然自动叠加。 ↗

先观察,再决定是否拒绝

官方文档标注,limit_conn_dry_run 自 1.17.6 引入。 ↗

limit_conn_dry_run on 启用观察模式:不限制连接数,但仍在共享区记录超出阈值的情况。$limit_conn_status 可记录 PASSED、REJECTED 或 REJECTED_DRY_RUN,用来区分通过、拒绝与只观察到超限。实际使用前应核对运行版本是否支持这些指令和变量。 ↗

limit_conn_status 的默认拒绝状态码是 503,可通过该指令调整。 把拒绝状态码与访问日志中的限流判定一起看,能够减少把其他模块产生的错误当成本模块超限的误判;这一步是排查建议,不是看到错误码就已确认限流。 ↗

下面为独立实验配置。共享区大小、监听端口和连接阈值均为自定义示例值,不是容量推荐;先创建同目录下的 logs、html 目录及待访问的测试文件,再在测试环境观察。示例保持 dry run 开启,不据此宣称已经发生拒绝。

pid logs/nginx.pid;
error_log logs/error.log notice;
events {}
http {
    access_log off;
    limit_conn_zone $binary_remote_addr zone=per_client:1m;
    server {
        listen 127.0.0.1:18082;
        server_name localhost;
        root html;
        location / {
            limit_conn per_client 2;
            limit_conn_dry_run on;
        }
    }
}

在实验目录使用实际安装的 Nginx 路径检查配置:

nginx -t -p "$PWD/" -c "$PWD/nginx.conf"

本次仅核对了该独立配置的语法,未启动服务,也未模拟并发请求验证拒绝行为。语法成功不等于阈值合理;还应确认访问协议、键值、共享区以及当前层级的继承关系。

关闭观察模式不是回滚

确认阈值后将 limit_conn_dry_run 设为 off,含义是结束“只记录不限制”的模式,让已有的限制配置开始执行拒绝;这不是撤销限流。若要取消本次实验,应恢复之前的配置,或明确移除实验增加的限制,再按自己的变更流程验证。不要把关闭 dry run 写成回滚方案。 ↗

共享区耗尽是另一个重要边界。文档说明,zone 存储耗尽时,服务器会对后续请求返回错误。大量失败不一定只是某个客户端的并发阈值过小,还应核对键的分布、共享区容量和对应日志。 ↗

排查顺序

  1. 先确认现象是请求被拒,还是仅系统连接数较高;不要混淆两者。
  2. 核对请求头是否已读完、请求是否正在处理,以及访问协议采用的计数规则。
  3. 核对键值、当前配置层级与继承关系;自定义空键会影响统计。
  4. 区分 dry run 与正式拒绝,再检查共享区是否耗尽。
  5. 取得日志和业务影响证据后再调整参数,不凭一次连接数截图直接改阈值。

原始资料:Nginx limit_conn 模块官方文档。本文不提供未经测试的吞吐量、内存容量换算或通用阈值。

常见问题

连接数比阈值高就说明配置无效吗?

不能直接这样判断。先核对系统连接数与模块计数口径是否一致,再检查键值、请求阶段、协议和配置继承。

引用资料

资料链接仅表示正文使用了该素材,不代表所有结论已独立核验。

正文完
 0
沐小悠
版权声明:本站原创文章,由 沐小悠 于2026-11-18发表,共计1812字。
转载说明:除特殊说明外本站文章皆由CC-4.0协议发布,转载请注明出处。
评论(没有评论)