proxy_cache_min_uses

Директива `proxy_cache_min_uses` задаёт минимальное число использований кэшированного ответа, после которого он считается годным для отдачи.

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

Описание

proxy_cache_min_uses определяет, сколько раз кэшированный ответ должен быть отдан из кэша, прежде чем он будет признан допустимым и сможет эффективно переиспользоваться для последующих запросов клиентов. Это особенно полезно в сценариях, где ответы предварительно кэшируются с upstream-серверов, но для их эффективного использования может требоваться достижение определённого порога, исходя из таких характеристик, как коэффициент попаданий в кэш или схема балансировки нагрузки. Если кэшированный ответ был отдан меньшее число раз, чем заданное минимальное значение, запросы к этому содержимому будут обходить кэшированную версию и, возможно, получать свежую копию с upstream-сервера.

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

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

location /api {
    proxy_pass http://backend;
    proxy_cache my_cache;
    proxy_cache_min_uses 5;
}

Если установить это значение слишком высоким, это может привести к ненужным cache misses, увеличивая нагрузку на upstream servers.

Наоборот, если установить его слишком низко, это может привести к тому, что часто будут возвращаться stale data, если backend responses редко меняются.

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