怎么配置 fastcgi_keep_conn on 强制开启与 PHP-FPM 的长连接复用避免路径调用时频繁创建套接字-Nginx-PHP中文网

fastcgi_keep_conn on 仅是fastcgi协议层握手控制指令，必须协同upstream连接池（含keepalive、keepalive_requests、keepalive_timeout）、fastcgi_http_version 1.1与空connection头，以及php-fpm的pm.max_children、pm.max_requests等参数对齐，三者缺一不可；unix socket不支持keepalive，须用tcp。

怎么配置 fastcgi_keep_conn on 强制开启与 php-fpm 的长连接复用避免路径调用时频繁创建套接字

fastcgi_keep_conn on 本身不是“强制开启长连接”的开关，它只是 FastCGI 协议层的一个握手控制指令。真正让 Nginx 与 PHP-FPM 复用 TCP 连接，必须三者协同：upstream 连接池 + 协议版本与头控制 + PHP-FPM 并发参数对齐。单独加这一行无效，还可能因其他配置冲突导致连接异常断开。

必须定义带 keepalive 的 upstream 块

Nginx 默认没有 upstream，所有 fastcgi_pass 127.0.0.1:9000 都是直连短连接，无法复用。

在 http { } 最上方（不能放在 server 或 location 内）添加：

upstream php_backend {
    server 127.0.0.1:9000;
    keepalive 8;
    keepalive_requests 1000;
    keepalive_timeout 60s;
}

keepalive 8：每个 Nginx worker 最多缓存 8 个空闲连接
该值不能超过 PHP-FPM 的 pm.max_children（如后者为 10，设 8 较稳妥）
keepalive_requests 1000 应与 PHP-FPM 的 pm.max_requests 接近，防止单连接超请求数被主动关闭
keepalive_timeout 60s 是空闲连接保持时间，和全局 keepalive_timeout 无关

在 location 中启用协议级复用控制

替换原有 fastcgi_pass，并补全三项关键指令：

location ~ \.php$ {
    fastcgi_pass php_backend;
    fastcgi_keep_conn on;
    fastcgi_http_version 1.1;
    fastcgi_set_header Connection "";
    include fastcgi_params;
}

fastcgi_keep_conn on 是必要但非充分条件，仅表示“不主动断开”
fastcgi_http_version 1.1 是协议基础，HTTP/1.0 不支持连接复用
fastcgi_set_header Connection "" 必须是空字符串（双引号内无空格、无字符），不是 "keep-alive" 或 "close"，否则 PHP-FPM 会误判并立即关闭连接
include fastcgi_params 不能省略，否则 SCRIPT_FILENAME 等关键参数丢失

同步调整 PHP-FPM 配置防止连接中断

PHP-FPM 必须“愿意留着连接”，否则 Nginx 复用也没用。检查 www.conf：

pm.max_children = 10 → upstream 的 keepalive 值建议 ≤ 8
pm.max_requests = 1000 → 和 upstream 的 keepalive_requests 对齐
request_terminate_timeout = 30s → 不宜过短，避免请求未完成就被 kill 导致连接异常中断
request_slowlog_timeout = 10s → 同理，避免慢日志触发中断
ping.path 和 ping.response 可保留，用于健康探测（非必需但推荐）

注意：若使用 Unix socket（如 fastcgi_pass unix:/run/php/php8.3-fpm.sock），keepalive 指令不生效，必须改用 TCP（127.0.0.1:9000）才能启用连接池。

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

下载

验证是否真正生效

配置重载后，执行以下命令观察连接状态：

查看活跃连接数（应稳定在 keepalive 设定值附近）：
```
ss -ant | grep :9000 | grep ESTAB | wc -l
```
对比优化前后 TIME_WAIT 数量（正常可从数百上千降至 20 以内）：
```
ss -ant | grep TIME_WAIT | wc -l
```
检查 Nginx 错误日志，搜索 upstream prematurely closed 或 recv() failed 类报错，常见原因是 Connection "" 写成 " " 或 "close"

不复杂但容易忽略

php免费学习视频：立即使用
踏上前端学习之旅，开启通往精通之路！从前端基础到项目实战，循序渐进，一步一个脚印，迈向巅峰！