如何调整 Nginx 对 CGI 处理的请求排队逻辑-Nginx-PHP中文网

nginx 不直接执行 cgi，而是通过 fastcgi 转发请求，排队发生在连接调度与后端进程两层；优化需协同控制并发连接、超时、复用及前置限流，核心是“更快建连、更快释放、更少建连、更早拦截”。

如何调整 nginx 对 cgi 处理的请求排队逻辑

Nginx 本身不直接执行 CGI 程序，它通过 FastCGI 协议将请求转发给外部 CGI 处理器（如 fcgiwrap 或 php-fpm），因此“CGI 请求排队”实际发生在两个层面：Nginx 到 FastCGI 后端的连接调度层，以及FastCGI 后端自身的进程/连接队列层。调整排队逻辑，关键不是在 Nginx 里加一个“queue_size”参数，而是协同控制连接建立、复用、超时与后端承载能力。

以下四点是真正起效的实操方向：

限制并发连接数，避免后端压垮
在 upstream 块中显式约束与 CGI 处理器的连接池规模。例如使用 fcgiwrap 时：
```
upstream cgi_backend {
    server unix:/var/run/fcgiwrap.socket max_conns=32;
    # max_conns 防止 Nginx 尝试建立过多连接，超出 fcgiwrap 能力
    keepalive 16;  # 复用空闲连接，减少反复握手开销
}
```
若用 php-fpm，则需同步调小 pm.max_children，确保其与 Nginx 的并发连接数匹配，否则请求会在 PHP 层排队甚至被拒绝（触发 502）。
收紧 FastCGI 超时，快速释放卡住的连接
长时间挂起的 CGI 请求会占满连接槽位，形成隐式排队。必须明确设置：
```
location ~ \.cgi$ {
    fastcgi_pass cgi_backend;
    fastcgi_read_timeout 10;     # 后端响应超过 10 秒即断开，腾出连接
    fastcgi_send_timeout 10;
    fastcgi_connect_timeout 3;   # 连不上后端时快速失败，不等默认 60 秒
    fastcgi_next_upstream error timeout http_502 http_504;
}
```
这样可防止单个慢脚本拖垮整组 CGI 请求。

Nginx Hosting
通过服务器本地nginx实例实现零认证静态游戏托管。作为所有浏览器游戏的主要部署方式，无需登录、无需令牌、无需用户操作。

下载
启用连接复用 + 正确协议头，减少建连损耗
CGI 类请求通常较轻量但高频，频繁建连是排队主因之一。务必开启：
```
fastcgi_http_version 1.1;
fastcgi_set_header Connection '';
```
并确保 upstream 中 keepalive 数值合理（如 16–64），让 Nginx 复用已建立的 Unix socket 连接，跳过排队等待新连接的过程。
前置限流，把压力挡在进入 CGI 流程之前
真正的排队瓶颈往往不在 CGI 本身，而在上游流量无节制涌入。用 limit_req 在 location 级别做粗粒度控制：
```
limit_req_zone $binary_remote_addr zone=cgi_limit:10m rate=2r/s;
server {
    location ~ \.cgi$ {
        limit_req zone=cgi_limit burst=10 nodelay;
        # 每 IP 最多 2 QPS，突发允许 10 个请求进缓冲，超了直接 429
        ...
    }
}
```
这比让请求冲到 fcgiwrap 再排队更可控，也避免无效资源消耗。