Linux下Nginx超时配置与性能优化技巧

Linux下Nginx超时配置绝非简单调大或调小，而是一套需精准分层、按角色协同的系统工程：客户端侧（client_header_timeout/client_body_timeout）要适配网络环境与业务类型，代理侧（proxy_read_timeout/proxy_connect_timeout）必须紧贴后端真实性能并预留余量，连接生命周期（keepalive_timeout/keepalive_requests）则需依据服务性质差异化控制复用与释放，任何一环错配都可能导致请求丢失、worker卡死或连接堆积；所有修改必须经nginx -t校验并reload生效，且务必厘清各参数作用边界——它们分别生效于client↔nginx、nginx↔upstream或空闲连接阶段，理解这一点，才是稳定高效运维Nginx的核心关键。

直接说结论：超时参数不是统一调大或调小，而是按角色分层设值——客户端侧、代理侧、连接生命周期各管一段，配错一个就丢请求或卡死 worker。

client_header_timeout 和 client_body_timeout 怎么设才不丢请求

这两个值控制 Nginx 接收请求的“耐心程度”。client_header_timeout 是等完整 HTTP 头的时间，client_body_timeout 是等请求体（比如文件上传数据）两次 TCP 包之间的最大空闲时间。

• 普通 HTML/JS/CSS 页面：client_header_timeout 10s、client_body_timeout 10s 足够，弱网用户一般也能在 10 秒内发完头和小 body
• 含大文件上传的后台系统（如 CMS 表单）：client_header_timeout 30s（防 TLS 握手延迟），client_body_timeout 300s（5 分钟支持百 MB 断点续传）
• 移动端 App 接口：client_header_timeout 60s、client_body_timeout 60s 更稳妥，中间代理重传或蜂窝网络抖动容易拖慢 header 到达
• 注意：client_body_timeout 不是整个上传耗时上限，而是“两次数据包间隔不能超该值”，断续上传必须满足这个节奏

proxy_read_timeout 必须匹配后端真实 P95 响应时间

proxy_read_timeout 是反向代理场景下最常误配的参数。它不是“整个请求最长等多久”，而是“Nginx 从 upstream 开始读响应起，连续等待数据的最大时长”。一旦超时，直接返回 504 Gateway Time-out。

• 先用 curl -w "@format.txt" -o /dev/null -s http://your-api 测后端接口真实 P95 值（比如 82s），再加 20% 余量 → 设为 proxy_read_timeout 100s
• proxy_send_timeout 可设为 60s，它极少触发，只在 upstream 拒绝接收请求（如 socket 写阻塞）时起作用，没必要比 proxy_read_timeout 还大
• 流式接口（SSE、导出 CSV 流）必须关缓冲：proxy_buffering off，且 proxy_read_timeout 至少设 3600，否则连接中途被断

keepalive_timeout 和 keepalive_requests 容易引发连接堆积

keepalive_timeout 控制的是“空闲长连接存活多久”，不是“请求处理时限”；keepalive_requests 是单条连接最多服务几个请求。两者配不当，会悄无声息吃光 worker_connections。

• 静态资源服务（CDN 类）可设 keepalive_timeout 75s、keepalive_requests 100，复用率高
• 动态 API 服务建议 keepalive_timeout 30s、keepalive_requests 50，避免慢客户端长期占着连接不放
• keepalive_timeout 只能在 http 或 server 块里配，location 级无效 —— 很多人在这儿白改配置
• 浏览器实际保持连接时间可能比 Nginx 设的小（如 Chrome 最多 60s），设太高没意义

别漏掉 proxy_connect_timeout 和 send_timeout

proxy_connect_timeout 是 Nginx 连 upstream 的建连超时，send_timeout 是 Nginx 发响应给客户端的超时。它们不像前几个那么显眼，但线上故障常源于此。

• proxy_connect_timeout 建议设 5s～15s，太长会让失败上游拖住 worker；后端挂了又没健康检查时，这个值就是止损关键
• send_timeout 默认 60s，高并发下可压到 30s，防止弱网客户端拉长连接占用资源
• 所有 timeout 单位都支持 s（秒）、ms（毫秒），但 client_header_timeout 等不支持毫秒级精度，写 100ms 会被当 0 处理

真正难的不是记住每个参数含义，而是理解它们生效的边界：哪个在 client ↔ nginx 段起作用，哪个在 nginx ↔ upstream 段生效，哪个只影响空闲连接。改完必须用 nginx -t 校验 + nginx -s reload 生效，别信“改完自动热更”。

今天关于《Linux下Nginx超时配置与性能优化技巧》的内容就介绍到这里了，是不是学起来一目了然！想要了解更多关于Linux的内容请关注golang学习网公众号！