0

0

nginx配置超时时间_nginx连接与请求超时参数优化配置

月夜之吻

月夜之吻

发布时间:2026-01-04 23:41:02

|

972人浏览过

|

来源于php中文网

原创

client_header_timeout 和 client_body_timeout 应按业务场景设置:普通页面设10s,文件上传系统设30s和300s,移动端接口统一设60s;proxy_read_timeout需基于后端P95响应时间加20%余量,proxy_send_timeout设60s即可;keepalive_timeout和keepalive_requests应区分静态与动态服务优化,且前者仅支持http/server级配置。

nginx配置超时时间_nginx连接与请求超时参数优化配置

client_header_timeout 和 client_body_timeout 怎么设才不丢请求

这两个参数控制 Nginx 等待客户端发送 HTTP 请求头和请求体的最长时间。设得太短,用户在弱网或大文件上传时容易触发 408 Request Timeout;设得太长,又可能让慢速攻击(如 Slowloris)长期占用 worker 进程。

推荐值取决于业务场景:

  • 普通 Web 页面(HTML/CSS/JS):client_header_timeout 10sclient_body_timeout 10s
  • 含文件上传的后台系统(如 CMS、表单提交):client_header_timeout 30sclient_body_timeout 300s(5 分钟足够传百 MB 文件)
  • 移动端 App 接口(网络波动大):建议统一设为 60s,避免因 TLS 握手延迟或中间代理重传导致 header 超时

注意:client_body_timeout 不影响已开始传输的 body,只限制两次 TCP 包之间的空闲时间。如果客户端断续发送数据,每次间隔不能超过该值。

proxy_read_timeout 和 proxy_send_timeout 影响后端交互稳定性

这两个是反向代理场景下的关键超时项,直接影响 Nginx 与 upstream(如 Python Flask、Java Spring Boot)之间通信是否“假死”。

proxy_read_timeout 是 Nginx 从 upstream 读响应的超时(比如后端生成报表要 2 分钟),proxy_send_timeout 是 Nginx 向 upstream 发送请求的超时(极少触发,除非 upstream 拒绝接收)。

常见误配:

  • proxy_read_timeout 设成 60,但后端接口实际耗时 90s → Nginx 中断连接,返回 504 Gateway Time-out
  • 没配 proxy_send_timeout,上游服务偶发卡住写 socket → Nginx 无限等待,worker 连接被占满

实操建议:

  • 先用 curl -w "@format.txt" -o /dev/null -s http://your-api 测真实后端 P95 响应时间,再加 20% 安全余量作为 proxy_read_timeout
  • proxy_send_timeout 设为 60 即可,比 proxy_read_timeout 小或相等都合理,不必更大
  • 若 upstream 支持流式响应(如 SSE、长轮询),proxy_read_timeout 必须设得足够大(例如 3600),并配合 proxy_buffering off

keepalive_timeout 和 keepalive_requests 容易被忽略的资源泄漏点

这两个参数管的是 HTTP/1.1 长连接生命周期,不是“连接多久没数据就关”,而是“连接空闲多久关”+“一条连接最多处理几个请求”。设错会导致 TIME_WAIT 暴增或连接复用率低。

聚彩手机网店系统 免费版
聚彩手机网店系统 免费版

聚彩手机商城系统,是一款专业于手机销售的独立手机网店系统,他拥有众多的手机参数选项,以及傻瓜式的设置选项,让您可以在5分钟内建立起专业而强大的手机销售网站。他拥有多套模版可以实时切换,前台拥有新闻中心、手机中心、配件中心、软件下载、手机报价、发货查询、保修查询、分店查询、产品的对比功能,代理与加盟的申请等功能,他拥有完善的会员中心,会员等级设置等,集成在线支付接口,超强SEO,可以设置所有页面的t

下载

典型问题:

  • keepalive_timeout 75(默认值)太长,客户端浏览器关了页面但连接还挂着,Nginx worker 无法释放 fd
  • keepalive_requests 100(默认)太小,高并发下频繁建连,TLS 握手开销大、TCP SYN 飙升

优化方向:

  • 静态资源服务(CDN、图片站):keepalive_timeout 15 + keepalive_requests 1000
  • 动态 API 服务(前后端分离):keepalive_timeout 5 + keepalive_requests 100(短连接更稳妥)
  • 若启用了 HTTP/2,keepalive_timeout 实际无效(HTTP/2 自带连接管理),但 keepalive_requests 仍生效,建议设为 1000

验证方式:用 ss -tan state established | grep :443 | wc -l 对比调参前后连接数变化。

timeout 相关指令必须放在 location 还是 server 块里

绝大多数 timeout 指令(client_header_timeoutproxy_read_timeout 等)支持在 httpserverlocation 三个作用域使用,但行为不同:

  • http 块设,是全局默认值,会被下级覆盖
  • server 块设,仅对本虚拟主机生效
  • location 块设,只对该路径生效 —— 这是最常用也最安全的方式,比如给 /api/upload 单独加大 client_body_timeout

特别注意:keepalive_timeoutlocation 块中设置无效,Nginx 会直接忽略,只能在 httpserver 级配置。

一个典型的安全配置片段:

location /api/ {
    proxy_pass http://backend;
    proxy_read_timeout 300;
    client_body_timeout 300;
}

location /static/ { alias /var/www/static/; expires 1h;

这里不需要 proxy_* 参数

}

超时参数不是越长越好,也不是越短越安全。真正难的是结合监控(如 Nginx stub_status、upstream 状态码分布)和真实流量特征做动态校准 —— 很多线上问题,其实是某次发布后 upstream 响应变慢,但 proxy_read_timeout 没同步调整导致的。

相关专题

更多
python开发工具
python开发工具

php中文网为大家提供各种python开发工具,好的开发工具,可帮助开发者攻克编程学习中的基础障碍,理解每一行源代码在程序执行时在计算机中的过程。php中文网还为大家带来python相关课程以及相关文章等内容,供大家免费下载使用。

755

2023.06.15

python打包成可执行文件
python打包成可执行文件

本专题为大家带来python打包成可执行文件相关的文章,大家可以免费的下载体验。

636

2023.07.20

python能做什么
python能做什么

python能做的有:可用于开发基于控制台的应用程序、多媒体部分开发、用于开发基于Web的应用程序、使用python处理数据、系统编程等等。本专题为大家提供python相关的各种文章、以及下载和课程。

759

2023.07.25

format在python中的用法
format在python中的用法

Python中的format是一种字符串格式化方法,用于将变量或值插入到字符串中的占位符位置。通过format方法,我们可以动态地构建字符串,使其包含不同值。php中文网给大家带来了相关的教程以及文章,欢迎大家前来阅读学习。

618

2023.07.31

python教程
python教程

Python已成为一门网红语言,即使是在非编程开发者当中,也掀起了一股学习的热潮。本专题为大家带来python教程的相关文章,大家可以免费体验学习。

1262

2023.08.03

python环境变量的配置
python环境变量的配置

Python是一种流行的编程语言,被广泛用于软件开发、数据分析和科学计算等领域。在安装Python之后,我们需要配置环境变量,以便在任何位置都能够访问Python的可执行文件。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

547

2023.08.04

python eval
python eval

eval函数是Python中一个非常强大的函数,它可以将字符串作为Python代码进行执行,实现动态编程的效果。然而,由于其潜在的安全风险和性能问题,需要谨慎使用。php中文网给大家带来了相关的教程以及文章,欢迎大家前来学习阅读。

577

2023.08.04

scratch和python区别
scratch和python区别

scratch和python的区别:1、scratch是一种专为初学者设计的图形化编程语言,python是一种文本编程语言;2、scratch使用的是基于积木的编程语法,python采用更加传统的文本编程语法等等。本专题为大家提供scratch和python相关的文章、下载、课程内容,供大家免费下载体验。

708

2023.08.11

C++ 单元测试与代码质量保障
C++ 单元测试与代码质量保障

本专题系统讲解 C++ 在单元测试与代码质量保障方面的实战方法,包括测试驱动开发理念、Google Test/Google Mock 的使用、测试用例设计、边界条件验证、持续集成中的自动化测试流程,以及常见代码质量问题的发现与修复。通过工程化示例,帮助开发者建立 可测试、可维护、高质量的 C++ 项目体系。

3

2026.01.16

热门下载

更多
网站特效
/
网站源码
/
网站素材
/
前端模板

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
Sass 教程
Sass 教程

共14课时 | 0.8万人学习

Bootstrap 5教程
Bootstrap 5教程

共46课时 | 2.9万人学习

CSS教程
CSS教程

共754课时 | 19.2万人学习

关于我们 免责申明 举报中心 意见反馈 讲师合作 广告合作 最新更新
php中文网:公益在线php培训,帮助PHP学习者快速成长!
关注服务号 技术交流群
PHP中文网订阅号
每天精选资源文章推送

Copyright 2014-2026 https://www.php.cn/ All Rights Reserved | php.cn | 湘ICP备2023035733号