macOS下配置Nginx长连接需正确设置keepalive_timeout，首参数控制空闲连接保持时长，次参数决定响应头Keep-Alive timeout值；建议默认75s，SPA轮询设60–90s，WebSocket代理可设300s以上，并注意Safari兼容性。
在 macOS 下配置 Nginx 长连接，核心是正确设置 keepalive_timeout，它控制客户端空闲连接的保持时长。这个值不是越长越好，需兼顾资源占用与实际业务需求。
keepalive_timeout 的两个参数含义
keepalive_timeout 接受两个可选数值：
- 第一个值（必填）：Nginx 在收到一个请求后，等待客户端发起下一个请求的最长时间（单位秒）。超时即关闭 TCP 连接。
- 第二个值（可选）：写入响应头
Keep-Alive: timeout=XX的值，用于提示客户端也按此时间管理复用。若不写，Nginx 默认不发送该头；若写了但小于第一个值，仍以第一个值为准。
常见合理取值建议
默认是 75s，对多数静态资源或轻量 API 已足够。但以下场景建议调整：
macOS UI 自动化技能包 —— 用 Python 控制你的 Mac
下载
让 macOS 自动化像说话一样简单 —— 用代码控制你的 Mac，无需学习 AppleScript 系统要求 macOS 14+ (Sonoma) Python 3.9+ 需要开启：辅助功能 + 屏幕录制权限
- 前端 SPA 应用频繁轮询（如每 30 秒 fetch 一次），建议设为
60–90，避免连接过早断开重连。 - 使用 WebSocket 代理时，需配合
proxy_http_version 1.1和proxy_set_header Connection ''，此时keepalive_timeout可设为300或更高，确保底层 TCP 不被 Nginx 主动关闭。 - Mac 本地开发环境若搭配 Safari 浏览器，注意旧版 Safari（尤其 macOS 上）可能对长连接行为异常；可加
keepalive_disable safari;规避兼容问题。
配置位置与生效方式
该指令可出现在 http、server 或 location 块中，越靠下的作用域优先级越高：
- 全局统一控制：写在
http块内，如keepalive_timeout 120 120; - 仅对某虚拟主机生效：写在对应
server块中。 - 修改后必须重载配置：
sudo nginx -t && sudo nginx -s reload - 验证是否生效：用
curl -I http://localhost查看响应头是否含Keep-Alive: timeout=120。
注意与其他超时参数的区分
keepalive_timeout 管理的是“空闲连接”的生命周期，和下面这些无关：
-
client_header_timeout/client_body_timeout：控制请求接收阶段的等待时间。 -
send_timeout：控制响应发送过程中的写间隔。 -
proxy_read_timeout：反向代理时等待后端响应的时间，不影响客户端到 Nginx 的 keep-alive。
