Кеширование контента

В настройках CDN-ресурса можно включить кеширование контента — временное хранение копий файлов из источников. Кеширование бывает двух типов:

• на CDN-серверах, расположенных в точках присутствия.
• в браузерах-клиентах.

Кеширование на CDN-серверахКеширование на CDN-серверах

Если для ресурса включено кеширование на CDN-серверах, файлы копируются из источников в кеш серверов при следующих событиях:

• Пользователь запросил у CDN-ресурса файл, который в текущий момент не закеширован отвечающим сервером.
• Время жизни кеш-копии файла на CDN-сервере истекло, а файл в источнике за это время изменился (иначе время жизни продлевается на тот же период).
• Вы принудительно загрузили файлы из источников в кеш CDN-серверов в настройках CDN-ресурса.

Время жизни кешаВремя жизни кеша

Пока время жизни кеша не истекло, CDN-сервер возвращает клиентам кешированную копию файла и не обращается за ним к источникам.

Для определения времени жизни кеша можно выбрать один из двух режимов:

Режим	Описание
Как у источника	Файл кешируется на время, указанное в ответе источника на запрос. Источник должен добавлять к ответу HTTP-заголовок Cache-Control с директивами max-age (указывает на время жизни кеша в секундах) и public (разрешает кеширование файла на любом уровне). Если источник ответил HTTP-кодом состояния 200, 201, 204, 206, 301, 302, 303, 304, 307 или 308, но в ответе нет заголовка, удовлетворяющего условиям выше, файл кешируется на время, указанное в настройках ресурса. Файлы из ответов с другими кодами состояния при отсутствии заголовка не кешируются.
Свои настройки	В настройках ресурса указывается время жизни кеша по умолчанию. Оно действует для всех ответов источников с HTTP-кодами состояния 200, 206, 301 и 302. Также для любого кода состояния (вне зависимости от того, входит ли он в список выше) можно указать отдельное время жизни кеша, которое имеет приоритет над временем по умолчанию. Если код состояния не входит в список и для него не указано отдельное время жизни кеша, файл из ответа с таким кодом не кешируется.

Кеширование в браузерахКеширование в браузерах

Если для ресурса включено кеширование в браузерах, CDN-серверы будут добавлять в ответы с HTTP-кодами состояния 200, 201, 204, 206, 301, 302, 303, 304, 307 и 308 заголовок Cache-Control с директивами max-age (указывает на время жизни кеша в секундах) и public (разрешает кеширование файла на любом уровне). Время жизни кеша указывается в настройках ресурса.

Файлы из ответов с другими кодами состояния не кешируются.

Файлы cookie и query-параметрыФайлы cookie и query-параметры

Запросы к CDN-серверу могут содержать один и тот же путь в URI, но разные файлы cookie (HTTP-заголовок Cookie) и/или разные query-параметры.

Query-параметры, которые учитываются при кешировании, входят в ключ объекта в кеше. Запросы с разными значениями таких параметров соответствуют разным объектам в кеше. Параметры, которые не учитываются при кешировании, не входят в ключ: запросы, отличающиеся только значениями этих параметров, соответствуют одному объекту.

В настройках ресурса можно выбрать один из режимов кеширования query-параметров:

Режим	Учет query-параметров в ключе кеша
Не кешировать	Все query-параметры игнорируются. Для запросов с одним путем сохраняется одна копия файла независимо от значений параметров.
Кешировать всё	Учитываются все query-параметры. Для каждого уникального набора параметров сохраняется отдельная копия файла.
Кешировать всё, кроме	Указанные query-параметры игнорируются, остальные учитываются.
Кешировать только	Учитываются только указанные query-параметры, остальные игнорируются.

Например, если выбрать режим Кешировать только и указать параметр segment, запросам /file.m3u8?expires=1&segment=1 и /file.m3u8?expires=2&segment=1 будет соответствовать один объект в кеше. Запросу /file.m3u8?expires=1&segment=2 будет соответствовать другой объект.

Кеширование ответов на запросы с файлами cookie настраивается отдельно с помощью опции Игнорировать. Если опция выключена, ответы на запросы с заголовком Cookie не кешируются, и файлы запрашиваются из источника заново. Если опция включена, ответы кешируются, и CDN-сервер может возвращать файлы из кеша.

Принудительное кеширование контентаПринудительное кеширование контента

Отдельные файлы можно принудительно (вручную) загрузить из источников в кеш CDN-серверов, не дожидаясь запросов от клиентов. Вручную в кеш рекомендуется загружать большие файлы размером от 200 МБ.

Принудительно загрузить в кеш можно только контент, которого еще нет на CDN-серверах. Чтобы обновить в кеше уже имеющиеся там файлы, необходимо предварительно очистить кеш.

Для принудительного кеширования существуют технические ограничения — лимиты.

Очистка кешаОчистка кеша

Копии файлов, сделанные CDN-серверами, можно удалить — очистить кеш. Это позволяет быстро обновить в CDN контент, который изменился в источниках.

Кеш можно очистить полностью или частично. Рекомендуется частичная очистка: если удалить из кеша копии всех файлов, CDN-серверы сильно увеличат нагрузку на источники, обращаясь к ним за каждым запрошенным файлом.

Для частичной очистки кеша можно указывать пути к конкретным файлам и каталогам. Каждый путь должен начинаться с символа /.

Примеры путей:

Если файл закеширован с учетом всех или некоторых query-параметров, по умолчанию удаляются все его копии. Чтобы удалить только конкретные копии, явно укажите значения query-параметров, которые входят в ключ кеша. Например: /image/foo.png?id=12345.

Примеры использованияПримеры использования

• Организация сине-зеленого и канареечного развертывания версий веб-сервиса
• Публикация обновлений для игр с помощью Yandex Cloud CDN

Полезные ссылкиПолезные ссылки

• Инструкция по настройке кеширования
• Инструкция по принудительному кешированию контента
• Инструкция по очистке кеша