proxy_max_temp_file_size

'proxy_max_temp_file_size' 指令设置用于存储被代理响应的临时文件的最大大小。 — NGINX HTTP Core

proxy_max_temp_file_size
httpserverlocation
语法proxy_max_temp_file_size size;
默认值1m
上下文http, server, location
模块NGINX HTTP Core
参数1

说明

'proxy_max_temp_file_size' 指令用于控制在处理被代理服务器响应时创建的临时文件的最大尺寸。如果响应超过该指定大小,NGINX 将不会把响应存储到临时文件中,而是返回错误。这在处理较大响应时尤其有用,可以避免耗尽磁盘空间。该指令可以在 http、server 和 location 上下文中配置,以便根据服务器配置结构进行更细粒度的控制。 在配置 'proxy_max_temp_file_size' 时,可以以字节为单位指定值,或使用后缀以提高可读性:'k' 表示千字节,'m' 表示兆字节,'g' 表示千兆字节。需要注意的是,将此值设置得过低可能会导致当某些被代理响应大于允许值时错误增多;反之,将其设置得过高则可能在临时缓存大量大响应时导致磁盘存储问题。因此,建议在定义此限制时评估预期的响应大小。

配置示例

location /api {
    proxy_pass http://backend_server;
    proxy_max_temp_file_size 5m;
}

将大小设置得过小可能会导致大型响应频繁出错。

在设置较高限制时不考虑磁盘空间,可能会耗尽可用存储。