在 nginx 中,全局设置 `keepalive_timeout` 需要在 http 块中配置该指令。这会影响所有未单独指定超时时间的 server 或 location 块。默认值为 75 秒,设置为 0 可禁用 keep-alive。

如何在全局 http 块中配置 keepalive_timeout
将 keepalive_timeout 指令直接放置在 http 块内即可实现全局生效。该设置会作为所有虚拟主机的默认值,除非在更具体的 server 或 location 层级被覆盖。

events {
worker_connections 1024;
}
http {
# 全局设置:保持连接 60 秒
keepalive_timeout 60;
server {
listen 80;
server_name example.com;
location / {
proxy_pass http://backend;
}
}
}
上述配置中,keepalive_timeout 60; 位于 http 块顶层。Nginx 启动后,所有通过该 http 上下文处理的请求,若未在 server 或 location 中重新定义此参数,均会使用 60 秒的超时值。客户端在建立 TCP 连接后,若 60 秒内无新请求,连接将被服务器主动关闭。
全局设置与局部设置的优先级关系
当 keepalive_timeout 在 server 或 location 中显式声明时,局部配置会覆盖全局设置。这种层级覆盖机制允许针对不同业务场景定制连接保持策略。

http {
keepalive_timeout 60; # 全局默认
server {
listen 80;
server_name api.example.com;
keepalive_timeout 10; # 局部覆盖:API 服务仅保持 10 秒
location /static {
keepalive_timeout 300; # 静态资源保持 5 分钟
root /var/www/static;
}
location /api {
proxy_pass http://backend_api;
}
}
}
在示例中,api.example.com 的根路径使用 10 秒超时,而其下的 /static 路径使用 300 秒。其他路径如 /api 继承 server 层的 10 秒设置。Nginx 按 location > server > http 的顺序应用配置,后出现的值优先。这种设计确保全局默认值不会意外影响需要短连接的高频 API 调用,同时允许静态内容享受长连接优势。
设置 keepalive_timeout 为 0 的实际效果
将 keepalive_timeout 设为 0 会强制关闭 HTTP 持久连接,每次请求都需新建 TCP 连接。这在某些高并发且请求极短的场景下可能减少服务器资源占用,但会增加客户端延迟。
http {
keepalive_timeout 0;
server {
listen 80;
server_name fast.example.com;
location / {
proxy_pass http://fast_backend;
}
}
}
当 keepalive_timeout 0; 生效时,Nginx 会在响应头中添加 Connection: close,告知客户端不保持连接。即使客户端发送 Keep-Alive 头,服务器也会忽略并立即关闭 TCP 套接字。此设置适用于请求生命周期极短、频繁创建连接的微服务架构,避免空闲连接占用文件描述符。验证方法:使用 curl -v 观察响应头是否包含 Connection: close,且后续请求必须重新握手。











