Nginx 缓存配置:如何处理大响应体

冬宇君_8057

冬宇君_8057

2026-06-05

977人浏览

原创

nginx代理大响应体需调大缓冲区、按需关闭proxy_buffering、延长proxy_read_timeout等超时参数:proxy_buffer_size设128k,proxy_buffers用8 256k,proxy_busy_buffers_size设512k;流式场景关闭proxy_buffering off;proxy_read_timeout至少300秒。

nginx 缓存配置:如何处理大响应体

Nginx 代理大响应体(比如大文件下载、长日志流、导出报表等)时,若缓冲配置不当,容易出现响应被截断、返回不完整、502/504 错误或连接中断等问题。根本原因不是“传不了”,而是 Nginx 默认的缓冲区太小、超时太短、或代理行为与后端不匹配。

下面从三个关键方向给出可落地的配置建议:

调大代理响应缓冲区

Nginx 默认用较小内存块暂存后端返回的数据;一旦响应体超过总缓冲容量,就会触发写临时文件或直接截断。需显式扩大:

  • proxy_buffer_size:用于缓存响应头,建议设为 128k 或更高(尤其当后端返回大量 header 字段时)
  • proxy_buffers:主响应体缓冲区,格式为 “数量 大小”,例如 8 256k 表示共 2MB 缓冲空间
  • proxy_busy_buffers_size:允许同时向客户端发送的最大缓冲数据量,建议设为 512k 或等于 proxy_buffers 总和的一半

示例:

proxy_buffer_size 128k;
proxy_buffers 8 256k;
proxy_busy_buffers_size 512k;

根据场景决定是否关闭缓冲

如果响应是持续流式输出(如实时日志、视频流、分块导出),开启缓冲反而导致延迟甚至卡死。此时应关闭代理缓冲:

Nginx Hosting
Nginx Hosting

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

下载
  • proxy_buffering off;
  • 同时确保 proxy_request_buffering off;(Nginx ≥1.16,防止 Nginx 将请求体也全缓存)

注意:关闭后 Nginx 不再暂存整个响应,而是边收边发,对内存更友好,但会失去响应重试、缓存命中等能力,仅适用于明确需要流式传输的 location。

同步延长超时与调优连接行为

大响应体传输耗时长,若超时设置仍为默认(通常 60 秒),极易触发 504 Gateway Timeout:

  • proxy_connect_timeout:与后端建连时间,一般保持 30–60s 即可
  • proxy_send_timeout:Nginx 向后端发送请求的超时,上传类接口才需调大
  • proxy_read_timeout:最关键——Nginx 等待后端返回响应的超时,大响应建议设为 300 或 600

补充建议:

  • 若后端使用 keepalive,可在 upstream 中配置 keepalive 32; 并在 location 中加 proxy_http_version 1.1; proxy_set_header Connection '';
  • 检查后端本身是否设置了响应体限制(如 Spring Boot 的 server.tomcat.max-http-header-size、Node.js 的 response.write() 分块策略)

不复杂但容易忽略

相关文章

PHP速学视频免费教程(入门到精通)
PHP速学视频免费教程(入门到精通)

PHP怎么学习?PHP怎么入门?PHP在哪学?PHP怎么学才快?不用担心,这里为大家提供了PHP速学教程(入门到精通),有需要的小伙伴保存下载就能学习啦!

下载

相关标签:

nginx nginx缓存配置

本站声明:本文内容由网友自发贡献,版权归原作者所有,本站不承担相应法律责任。如您发现有涉嫌抄袭侵权的内容,请联系admin@php.cn

相关专题

更多
服务器是什么
服务器是什么

服务器是一种计算机硬件设备或软件程序,它具有强大的计算和存储能力,用请求、存储数据和提供服务。它在互联网中着关重要的作用,为用户提供各种服务和资源。本专题为大家提供服务器相关的文章、下载、课程内容,供大家免费下载体验。

2023.08.15

457

5

连接apple id服务器时出错
连接apple id服务器时出错

连接apple id服务器时出错的原因包括网络连接问题、服务器问题、Apple ID账户问题、设备问题、防火墙或安全软件问题、时间和日期设置问题、Apple服务器维护等。本专题为大家提供apple id相关的文章、下载、课程内容,供大家免费下载体验。

2023.09.08

920

5

搭建互联网服务器
搭建互联网服务器

搭建互联网服务器需要:1、选择合适的硬件和操作系统,第一步是选择合适的硬件和操作系统;2、安装和配置操作系统,是搭建互联网服务器的关键步骤;3、安装和配置服务器软件,是搭建互联网服务器的下一步,常见的服务器软件包括Apache、Nginx、Tomcat等;4、配置防火墙和安全性,是搭建互联网服务器的重要步骤;5、域名解析和配置,是搭建互联网服务器的最后一步。

2023.09.19

2972

5

如何查看服务器状态
如何查看服务器状态

查看服务器状态的方法有使用命令行工具、图形界面工具、监控工具、日志文件和远程管理工具等。本专题为大家提供服务器状态相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.09

996

5

服务器域名转接慢怎么解决
服务器域名转接慢怎么解决

服务器域名转接慢的解决办法有DNS优化、服务器优化、CDN加速、前端优化和网络优化等。本专题为大家提供服务器相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.17

889

5

服务器评测软件
服务器评测软件

服务器评测软件有PassMark Software、CPU-Z、GPU-Z、CrystalDiskMark、IOmeter、JMeter、LoadRunner、Apache Bench等等。详细介绍:1、PassMark Software是一款综合性的服务器性能测试软件,可以评估服务器在各种负载条件下的性能;2、CPU-Z是一款可以提供服务器CPU详细信息的软件等等。

2023.10.17

454

3

如何开启TFTP服务器
如何开启TFTP服务器

开启TFTP服务器的步骤包括选择TFTP服务器软件、下载和安装软件、配置TFTP服务器以及启动和测试服务器等。本专题为大家提供服务器相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.18

2696

4

服务器负载不兼容怎么解决
服务器负载不兼容怎么解决

解决方法:1、增加服务器资源;2、负载均衡;3、优化应用程序;4、增加缓存机制;5、分布式架构;6、限流和熔断;7、自动化扩容。想知道更详细服务器负载不兼容的解决方法,可以访问本专题下面的文章。

2023.10.20

5052

4

宽带如何接入服务器
宽带如何接入服务器

宽带接入服务器的方法有ADSL宽带接入服务器、光纤接入服务器、无线接入服务器和以太网接入服务器等。本专题为大家提供相关的文章、下载、课程内容,供大家免费下载体验。

2023.10.20

807

5

热门下载

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

精品课程

更多
相关推荐
/
热门推荐
/
最新课程
phpEnv手册
phpEnv手册

共0课时 | 0人学习

nginx手册
nginx手册

共0课时 | 0人学习

进程与SOCKET
进程与SOCKET

共6课时 | 0.5万人学习