upload_limit_rate

Директива `upload_limit_rate` контролирует максимальную скорость загрузки файлов в NGINX.

Синтаксисupload_limit_rate size;
По умолчаниюnone
Контекстhttp, server, location, if in location
Аргументы1

Описание

Директива upload_limit_rate используется для управления скоростью загрузки файлов на сервер. Эта директива позволяет задать ограничение пропускной способности для входящих загрузок файлов, выраженное в байтах в секунду. Установив это ограничение, администраторы могут предотвратить перегрузку ресурсов сервера в периоды пиковых загрузок, ограничивая скорость, с которой данные принимаются от клиентов. Директива может быть указана со значением, таким как 1m, чтобы задать максимальную скорость загрузки 1 мегабайт в секунду, или в других байтовых обозначениях, например 500k для килобайт.

Эту директиву можно использовать в различных контекстах, включая http, server, location и if внутри блока location. Настройка влияет на все загрузки, обрабатываемые в указанном блоке, гарантируя, что каждая загрузка соответствует заданному ограничению скорости. Дополнительно это может быть особенно полезно для улучшения пользовательского опыта в условиях высокой нагрузки, поскольку помогает более равномерно распределять пропускную способность и может предотвращать перегрузку сервера из‑за интенсивных операций загрузки.

Важно отметить, что эта директива не ограничивает объём передаваемых данных; она лишь контролирует скорость загрузки, что влияет на время, необходимое для завершения загрузки. Следовательно, пользователи могут столкнуться с увеличением времени загрузки, а не с ограничением доступа к возможностям загрузки.

Пример конфига

location /upload {
    upload_pass /handle_upload;
    upload_store /tmp/uploads;
    upload_limit_rate 1m;
}

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

Будьте осторожны при использовании нескольких директив upload_limit_rate во вложенных контекстах, поскольку применяется наиболее конкретная из них, что может привести к непредвиденному поведению.

← Ко всем директивам