slowfs_big_file_size

Устанавливает минимальный порог размера файла, при котором файлы считаются «большими» в NGINX SlowFS Cache.

Синтаксисslowfs_big_file_size size;
По умолчанию128k
Контекстhttp, server, location
Аргументы1

Описание

Директива slowfs_big_file_size в модуле NGINX SlowFS Cache задаёт порог размера, который отличает «большие» файлы от обычных. Когда файл превышает указанный размер, NGINX обрабатывает его иначе в процессе кэширования. Главная цель такого разделения — оптимизировать копирование крупных файлов, так как они обычно потребляют больше ресурсов и при неправильном управлении могут привести к сбоям в обслуживании.

Когда файл определяется как «большой», NGINX форкает дочерний процесс перед его копированием в кэш. Это гарантирует, что основной рабочий процесс остаётся отзывчивым и может обслуживать входящие запросы, не блокируясь длительными файловыми операциями. Например, если размер файла превышает значение, установленное этой директивой, NGINX запустит фоновый процесс для обработки кэширования такого файла, что повышает производительность и снижает влияние на работу сервера в целом.

Значение slowfs_big_file_size задаётся в байтах и может быть установлено в разных контекстах, таких как http, server или location. Такая гибкость позволяет администраторам адаптировать порог размера под разные сценарии в зависимости от типичного распределения размеров файлов в их приложениях.

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

server {
    location /static/ {
        slowfs_cache my_cache;
        slowfs_temp_path /var/tmp;
        slowfs_big_file_size 512k;
    }
}

Установка этой директивы слишком низко может привести к ненужному расходу ресурсов из‑за частого создания процессов при обработке файлов среднего размера.

Значения следует указывать в байтах; отсутствие или некорректное указание единицы измерения может привести к непредвиденному поведению.

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