Nginx的proxy buffer参数设置

最新推荐文章于 2025-06-25 23:31:27 发布

原创最新推荐文章于 2025-06-25 23:31:27 发布 · 5.3k 阅读

6 ·

CC 4.0 BY-SA版权

文章标签：

#nginx #运维 #服务器

nginx 专栏收录该内容

2 篇文章

订阅专栏

本文介绍了Nginx中与代理服务器响应缓冲相关的配置指令，如proxy_buffering、proxy_buffers、proxy_buffer_size、proxy_busy_buffer_size等，这些设置影响着Nginx如何处理后端服务器的响应内容，特别是在处理长轮询和Comet应用时显得尤为重要。此外，还提到了proxy_temp_path、proxy_max_temp_file_size和proxy_temp_file_write_size等与临时文件相关的配置。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

1. proxy_buffering

语法：proxy_buffering on|off
默认值：proxy_buffering on
上下文：http,server,location

作用：该指令开启从后端被代理服务器的响应body缓冲。
如果proxy_buffering开启,nginx假定被代理的后端服务器会以最快速度响应,并把内容保存在由指令 proxy_buffer_size 和 proxy_buffers 指定的缓冲区里边.
如果响应body无法放在内存里边,那么部分内容会被写到磁盘上。
如果proxy_buffering被关闭了,那么响应body会按照获取body的多少立刻同步传送到客户端。nginx不尝试计算被代理服务器整个响应body的大小,nginx能从服务器接受的最大数据,是由指令 proxy_buffer_size指定的。
对于基于长轮询(long-polling)的Comet 应用来说,关闭 proxy_buffering 是重要的,不然异步响应将被缓存导致Comet无法工作。
但是无论proxy_buffering是否开启，proxy_buffer_size都是生效的

2. proxy_buffers

语法：proxy_buffers  数量  size
默认值：proxy_buffers 256 8k
上下文：http,server,location

作用：设置存储被代理服务器响应的body所占用的buffer个数和每个buffer大小。
具体的意思是说，开辟256个长度为8k大小的read_buf用来存储body，当然不是连接建立初始化时就开辟256个，而是当当前buf不够存响应body时才会新申请一个，最多申请256个buf。

3. proxy_buffer_size

语法：proxy_buffer_size size
默认值：proxy_buffer_size 4k/8k
上下文：http,server,location

作用：Nginx使用该大小申请read_buf，即大小指定了 upstream header 最大长度，如果响应头超过了这个长度，Nginx会报upstream sent too big header错误，然后client收到的是502。

4. proxy_busy_buffer_size

语法：proxy_busy_buffer_size  size
上下文：http,server,location

作用：proxy_busy_buffers_size不是独立的空间，他是proxy_buffers和proxy_buffer_size的一部分。
nginx会在没有完全读完后端响应就开始向客户端传送数据，所以它会划出一部分busy状态的buffer来专门向客户端传送数据(建议为proxy_buffers中单个缓冲区的2倍)，然后它继续从后端取数据。
proxy_busy_buffer_size参数用来设置处于busy状态的buffer有多大。

1）如果完整数据大小小于busy_buffer大小，当数据传输完成后，马上传给客户端；
2）如果完整数据大小不小于busy_buffer大小，则装满busy_buffer后，马上传给客户端；

5. proxy_temp_path

语法：proxy_temp_path  path [level1 level2 level3]
默认值：proxy_temp_path proxy_temp
上下文：http,server,location

作用：定义proxy的临时文件存在目录以及目录的层级。

6. proxy_max_temp_file_size

语法：proxy_max_temp_file_size size;
默认值：proxy_max_temp_file_size 1024m;
上下文：http, server, location

作用：设置临时文件的总大小

7. proxy_temp_file_wirte_size

作用：设置同时写入临时文件的数据量的总大小。通常设置为8k或者16k。