srcache_default_expire

Устанавливает время истечения по умолчанию для кэшированных записей в модуле srcache.

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

Описание

Директива srcache_default_expire используется для задания времени жизни (TTL) по умолчанию для сохранённых кэшированных ответов в прозрачной схеме кэширования на основе подзапросов для локаций NGINX. Эта директива играет ключевую роль в управлении кэшем, определяя, как долго кэшированная запись остаётся действительной, прежде чем её следует считать устаревшей и затем обновить. Время истечения применяется к записям кэша, когда для отдельных кэшированных элементов не задано явное время истечения или когда они отдаются без явных директив кэширования.

Для использования srcache_default_expire необходимо указать аргумент длительности, который следует синтаксису NGINX для значений времени, например 1m, 5h или 24s. Время истечения, заданное этой директивой, влияет на всё поведение кэширования в пределах конкретной области, где оно определено — в контекстах http, server, location и условном if in location. Установив разумное значение времени истечения по умолчанию, вы можете найти баланс между свежестью данных и снижением нагрузки на бэкенд, избегая ненужных повторных запросов одного и того же ресурса.

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

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

location /example {
    srcache_default_expire 10m;
    # Further configuration here
}

Время истечения должно быть указано в допустимом формате времени (например, 5m, 30s) и не может быть пропущено.

Если задать слишком короткое время истечения, это может привести к частым запросам к бэкенду, сведя на нет преимущества кеширования.

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

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

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