← Cloudflare Cache / cache / how-to

Ключи кеша

Ключ кеша представляет собой идентификатор, который Cloudflare использует для файла в своём кеше, а шаблон ключа кеша (Cache Key Template) определяет этот идентификатор для конкретного HTTP запроса.

Ключ кеша по умолчанию включает:

1. Полный URL:
   • схема, то есть HTTP или HTTPS.
   • узел - например, www.cloudflare.com
   • URI со строкой запроса, например, /logo.jpg?utm_source=newsletter
2. Заголовок Origin, отправляемый клиентом (для поддержки CORS).
3. x-http-method-override, x-http-method, а также x-method-override заголовки.
4. x-forwarded-host, x-host, x-forwarded-scheme (кроме http или https), x-original-url, x-rewrite-url, а также forwarded заголовки.

Custom cache keys позволяют точно задать параметр кешируемости для любого ресурса. Они дают больше контроля, но могут снижать долю попаданий в кеш и приводить к шардингу кеша:

1. На панели управления Cloudflare перейдите к разделу Cache Rules страницу.

   Перейдите в Cache Rules ↗

2. Выберите Создать правило.

3. В разделе Когда входящие запросы соответствуют, задайте выражение правила.

4. В разделе Затем, в Допустимость кеширования разделе выберите Подлежит кешированию.

5. Добавьте Cache Key настройку к правилу и выберите подходящий Query String параметр.

6. Также можно выбрать настройки для Headers, Cookie, Host, а также Пользователь.

7. Чтобы сохранить и развернуть правило, выберите Развернуть. Если вы ещё не готовы развернуть правило, выберите Save as Draft.

Есть несколько распространённых причин изменить Cache Key Template. Вы можете изменить Cache Key Template, чтобы:

• Фрагментируйте кэш так, чтобы один URL хранился в нескольких файлах. Например, чтобы хранить разные файлы в зависимости от определённой строки запроса в URL.
• Объедините кеш так, чтобы разные HTTP-запросы сохранялись в одном файле. Например, чтобы убрать заголовок Origin, который Cloudflare по умолчанию добавляет в Cache Keys.

Cloudflare $scheme переменная играет ключевую роль в поведении кеша, но её значение различается в зависимости от типа ключа кеша:

• Default Cache Key: $scheme указывает на схема источника протокол, который Cloudflare использует для подключения к исходному серверу (HTTP или HTTPS). При такой конфигурации изменения настроек SSL (например, переключение с Flexible на Full) меняют схему источника. Поскольку ключ кэша включает схему источника, такие изменения приводят к сбросу кэша, и Cloudflare заново запрашивает содержимое у источника.

• Custom Cache Key: $scheme указывает на схема посетителя протокол, который клиент использует для запроса к Cloudflare. В этом случае изменения настроек SSL не влияют на ключ кэша, если только схема источника явно не включена в вашу пользовательскую конфигурацию.

Например, при использовании Flexible SSL Cloudflare всегда подключается к источнику по HTTP, независимо от того, использует ли посетитель HTTP или HTTPS. При настройках по умолчанию это приводит к одинаковому cache key для обоих протоколов.

Учитывайте, что изменение настройки SSL может приводить к сбросу кэша при использовании ключа кэша по умолчанию:

• Переход с Off к Full, Full (strict), или Строгий меняет схему источника с HTTP на HTTPS, что приводит к сбросу кеша.

• Переход с Flexible к Full, Full (strict), или Строгий аналогичным образом меняет схему источника на HTTPS и приводит к сбросу кеша.

Как работает $scheme взаимодействует с вашей конфигурацией кэширования, важно понимать при изменении режимов SSL, чтобы избежать непредвиденного поведения кэша.

Cache Level Ignore Query String создает ключ кеша, включающий все элементы ключа кеша по умолчанию, за исключением строки запроса в URI, которая больше не включается. Например, запрос для http://example.com/file.jpg?something=123 и запрос для http://example.com/file.jpg?something=789 в этом случае будут иметь одинаковый ключ кэша.

Следующие поля управляют Cache Key Template.

Строка запроса определяет, какие параметры URL попадают в Cache Key. Вы можете include конкретные параметры строки запроса или exclude их с помощью соответствующих полей. Если вы указываете параметр строки запроса, value параметра строки запроса используется в ключе кеша.

Если включить строку запроса foo в URL-адрес вида https://www.example.com/?foo=bar, то bar появляется в Cache Key. Ровно одно из include или exclude ожидается.

• Чтобы включить все параметры строки запроса (поведение по умолчанию), используйте include: "\*"
• Чтобы игнорировать строки запроса, используйте exclude: "\*"
• Чтобы включить большинство параметров строки запроса, но исключить некоторые из них, используйте поле exclude, которое предполагает включение остальных параметров строки запроса.

Заголовки определяют, какие заголовки входят в Cache Key. Как и с Query String, здесь можно включать определённые заголовки или исключать заголовки по умолчанию.

Если вы добавляете заголовок, его значение включается в Cache Key. Например, если HTTP-запрос содержит HTTP-заголовок вида X-Auth-API-key: 12345, и вы включаете X-Auth-API-Key header в Cache Key Template, то 12345 отображается в Cache Key.

В Включать заголовки и выбранные значения разделе можно добавить имена заголовков и их значения в ключ кеша. Для пользовательских заголовков значения необязательны, но для следующих ограниченных заголовков необходимо указать от одного до 10 конкретных значений:

• accept
• accept-charset
• accept-encoding
• accept-datetime
• accept-language
• referer
• user-agent

Чтобы проверить наличие заголовка без учёта его фактического значения, используйте Проверка наличия опцию.

В настоящее время можно исключить только Origin заголовок. Origin заголовок всегда включается, если явно не исключён. Включение Заголовок Origin ↗ в ключе кэша важно для обеспечения CORS ↗.

Кроме того, нельзя включать следующие заголовки:

• Заголовки, повторно реализующие функции кеша или прокси
  • connection
  • content-length
  • cache-control
  • if-match
  • if-modified-since
  • if-none-match
  • if-unmodified-since
  • range
  • upgrade
• Заголовки, которые уже учитываются другими функциями Cache Key
  • cookie
  • host
• Заголовки, специфичные для Cloudflare, с префиксом cf-, например, cf-ray
• Заголовки, уже включённые в пользовательский шаблон Cache Key, например origin

Host определяет, какой заголовок host включается в Cache Key.

• Если Use original host (resolved: false в API), Cloudflare добавляет Host заголовок в HTTP-запросе, отправляемом источнику.
• Если Resolved host (resolved: true в API), Cloudflare добавляет Host заголовок, который был обработан, чтобы получить origin IP для запроса. Host заголовок может отличаться от фактически отправленного заголовка, если он был изменён с помощью Origin Rule.

Подобно query_string или header, cookie определяет, какие cookie попадают в Cache Key. Вы можете включить значение cookie или просто проверять наличие определённого cookie.

Нельзя включать cookie, специфичные для Cloudflare. Имена cookie Cloudflare начинаются с префикса __cf, например, __cflb

Поля функции User добавляют в Cache Key характеристики конечного пользователя (клиента).

• device_type классифицирует запрос как mobile, desktop, или tablet на основе User Agent
• geo включает страну клиента, определённую по IP-адресу
• lang включает первый код языка, указанный в Accept-Language заголовок, отправленный клиентом

Доступность параметров ключа кеша зависит от вашего тарифного плана.

Вы можете использовать Cloudflare Trace чтобы узнать, какие настройки Cache Key были применены к вашему запросу. Если вы отправляете запрос через инструмент Trace и он был обслужен из кеша, это отобразится как попадание в кеш в Параметры кеша раздел. Затем выберите Просмотр сведений о параметре чтобы точно увидеть, какие свойства Cache Key были использованы.

Предзагрузка функция несовместима с Custom Cache Keys. При Cache Rules, пользовательский cache key используется для кеширования всех ресурсов. Однако Prefetch всегда использует cache key по умолчанию. Из-за этого возникает несовпадение ключей.