proxy_temp_file_write_size
`proxy_temp_file_write_size` 指令设置在处理代理响应时写入临时文件的大小限制。 — NGINX HTTP Core
proxy_temp_file_write_size
httpserverlocation
语法proxy_temp_file_write_size size;
默认值none
上下文http, server, location
模块NGINX HTTP Core
参数1
说明
`proxy_temp_file_write_size` 指令在 NGINX 中指定可写入代理响应临时文件的最大数据大小。当来自被代理服务器的响应大于此大小时,NGINX 会将其缓冲到临时文件而不是内存中,这在高负载场景下管理内存使用非常重要。该指令通过控制在将数据转存到磁盘之前可驻留在内存中的响应数据量,帮助避免内存不足的情况。 该指令接受单个参数,用于定义大小限制,取值例如 '1m' 表示一兆字节,'512k' 表示半兆字节等。此指令的上下文包括 `http`、`server` 和 `location`,使用户能够根据代理设置的作用范围灵活配置。在调整此设置时必须考虑磁盘 I/O 的影响,尤其是在资源受限的服务器或频繁提供大文件的情况下。 实际使用中,如果响应大小超过配置的限制,代理服务器会开始将数据写入位于指定目录的临时文件,从而允许后续处理继续进行而不会压垮服务器内存。管理员应密切监控响应大小并相应调整此设置,以优化性能和资源管理。
配置示例
http {
proxy_temp_file_write_size 1m;
server {
location / {
proxy_pass http://backend;
}
}
}⚠
将 `proxy_temp_file_write_size` 设置得过低可能导致频繁写入磁盘,影响性能,尤其在高负载下。
⚠
确保系统为临时文件留有足够的磁盘空间;否则,可能在处理请求时导致错误。
⚠
在正在运行的配置中更改此指令可能不会影响正在进行的请求;可能需要重新加载或重启。