fastcgi_max_temp_file_size

指令 'fastcgi_max_temp_file_size' 设置用于 FastCGI 响应的临时文件允许的最大大小。 — NGINX HTTP Core

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

说明

指令 'fastcgi_max_temp_file_size' 指定由 NGINX 为缓冲 FastCGI 响应数据而创建的临时文件允许达到的最大尺寸。如果响应的大小超过此限制,NGINX 将返回 502 Bad Gateway 错误并拒绝该请求。此设置对于管理服务器资源尤其有用,可防止过大的 FastCGI 响应耗尽所有可用磁盘空间。 该指令可应用于多个上下文,包括 'http'、'server' 和 'location',根据使用情况提供灵活的配置。其值以字节为单位定义,应根据预期的 FastCGI 响应量谨慎设置。过小的值可能导致错误率上升,而过大的值则可能在高负载时导致磁盘使用过多。 在应用此指令时,需要考虑应用的工作负载特性和可用磁盘空间。随着响应大小随时间或用户负载模式变化,可能需要监控并调整此配置,以确保应用在意外流量激增时仍能保持性能和弹性。

配置示例

location /cgi-bin {
    fastcgi_pass 127.0.0.1:9000;
    fastcgi_max_temp_file_size 16m;
}

如果 FastCGI 响应超过限制,设置的值过低可能会导致频繁出现 502 错误。

并非所有 FastCGI 应用都会遵守临时文件限制,这可能导致意外行为。

在使用较大限制值时,请确保服务器有足够的磁盘空间可用于临时文件。