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;
}

Установка слишком низкого значения может привести к частым ошибкам 502, если ответы FastCGI превышают лимит.

Не все приложения FastCGI соблюдают ограничения на временные файлы, что может привести к непредвиденному поведению.

Убедитесь, что на сервере достаточно свободного места на диске для временных файлов при использовании больших лимитов.