upload_max_file_size
Директива `upload_max_file_size` задаёт максимальный разрешённый размер файла для загрузок в модуле загрузки NGINX.
Описание
Директива upload_max_file_size указывает максимальный размер (в байтах) файла, который может быть загружен через модуль загрузки NGINX. Если файл превышает этот лимит, клиенту будет отправлен ответ с ошибкой 413 (Payload Too Large) вместо обработки загрузки. Эта директива имеет важное значение для контроля использования ресурсов и обеспечения того, чтобы ваш сервер мог эффективно обрабатывать запросы на загрузку, не перегружаясь из-за чрезмерно больших файлов.
Эта директива может быть определена в различных контекстах, включая http, server, location, if in location и limit_except. Параметр для upload_max_file_size должен быть единым числовым значением с суффиксом единицы (k, m, g — для килобайт, мегабайт или гигабайт соответственно). Конфигурация позволяет системным администраторам устанавливать соответствующие ограничения на основе ёмкости сервера и требований приложения, обеспечивая баланс между удобством использования и защитой от непредвиденного потребления ресурсов.
При загрузке файлов, если общий размер входящего запроса превышает этот лимит, модуль прекратит обработку загрузки и вернёт указанный HTTP-ответ с ошибкой. Рекомендуется устанавливать разумный лимит, исходя из потребностей вашего приложения: слишком высокий лимит может привести к чрезмерному использованию ресурсов сервера, а слишком низкий — ограничить легитимные сценарии использования.
Пример конфига
http {
upload_max_file_size 10m;
}Установка upload_max_file_size в неправильном контексте (например, в блоке location, вместо http) может привести к непредвиденному поведению.
Если значение не задано, загрузки могут проходить независимо от размера, что потенциально может привести к исчерпанию ресурсов.
Убедитесь, что вы проверили настройки client max body size в сочетании с этой директивой.