Настроить кэширование контента

По умолчанию настройки кэширования контента выключены. Вы можете включить их и настроить:

время кэширования;
отдачу контента из кэша при ошибках источника;
кэширование контента с учетом параметров запроса;
кэширование контента с учетом cookies.

Настроить время кэширования

Время кэширования — время, в течение которого CDN-серверы хранят копию ответа от источника до повторного запроса контента. Время кэширования можно настроить для каждого HTTP-ответа.

В панели управления в верхнем меню нажмите Продукты и выберите CDN.
В разделе CDN-ресурсы откройте страницу CDN-ресурса → вкладка Кэширование.
Отметьте чекбокс Включить настройки кэширования.
В блоке Время кэширования контента настройте время кэширования для каждого типа ответа:
- для 2xx — время хранения успешных ответов;
- 3xx — время хранения редиректов;
- 4xx — время хранения ошибок клиента;
- 5xx — время хранения ошибок сервера;
- в браузере — время, на которое браузер может кэшировать ответ после его получения от CDN..
Если хотите переопределить настройки источника контента на свои, отметьте чекбокс Игнорировать заголовки управления кэшированием. CDN будет игнорировать заголовки Cache-Control и Expires, которые содержат информацию о кэшировании и которые источник контента может включать в ответ.
Нажмите Применить. Во время применения настроек ресурс будет находиться в статусе PROCESSING. В это время применение других настроек недоступно. Настройки применятся, когда ресурс перейдет в статус ACTIVE.

Отдавать контент из кэша при ошибках источника

Если источник контента отвечает ошибкой, пользователь может получать последнюю сохраненную в кэш версию контента (Use Stale). Пока источник недоступен, страницы сайта могут отображаться неполностью: например, могут работать не все изображения, видео или таблицы стилей. При этом CDN-серверы будут проверять его доступность с каждым новым запросом:

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

Чтобы отдавать контент из кэша при ошибках источника:

В панели управления в верхнем меню нажмите Продукты и выберите CDN.
В разделе CDN-ресурсы откройте страницу CDN-ресурса → вкладка Кэширование.
Отметьте чекбокс Включить настройки кэширования.
В блоке Последняя версия закэшированного контента (Use Stale) отметьте чекбокс Отдавать последнюю версию закэшированного контента, если источник недоступен.
В списке В каких случаях отдавать последнюю версию закэшированного контента: выберите ошибки, при которых нужно отдавать последний кэшированный контент:
- error (ошибка соединения с сервером)
- timeout (превышение времени во время соединения с сервером)
- invalid_header (сервер вернул пустой или неверный ответ)
- updating (использование устаревшего закэшированного ответа, пока файлы в кэше обновляются)
- http_500 (внутренняя ошибка сервера)
- http_502 (сбой при передаче данных между сервером и пользователем)
- http_503 (сервер не может обработать запрос)
- http_504 (превышение времени во время соединения с сервером)
- http_403 (ошибка доступа)
- http_404 (ресурс не найден)
- http_429 (слишком много запросов)
Нажмите Применить. Во время применения настроек ресурс будет находиться в статусе PROCESSING. В это время применение других настроек недоступно. Настройки применятся, когда ресурс перейдет в статус ACTIVE.

Кэшировать контент с учетом параметров запроса

По умолчанию CDN игнорирует параметры запроса (query string).

Вы можете включить кэширование контента с учетом параметров запроса.

Если в запросах к одному файлу присутствуют разные параметры (часть после знака вопроса в URL файла), то каждый запрос с новым параметром перенаправляется на источник.

В панели управления в верхнем меню нажмите Продукты и выберите CDN.
В разделе CDN-ресурсы откройте страницу CDN-ресурса → вкладка Кэширование.
Отметьте чекбокс Включить настройки кэширования.
В блоке Кэшировать с учетом query string отметьте чекбокс Кэшировать с учетом query string. По умолчанию будут учитываться все параметры запроса.
Если вы хотите учитывать определенные параметры в запросе, снимите чекбокс Учитывать все параметры.
Укажите разрешенные или запрещенные параметры запроса:
- включите White List, добавьте разрешенный параметр и нажмите . При обработке запроса будут учитываться только параметры, которые включены в этот список.
- или включите Black List, добавьте запрещенный параметр и нажмите . При обработке запроса будут учитываться все параметры, которые не включены в этот список.
Нажмите Применить. Во время применения настроек ресурс будет находиться в статусе PROCESSING. В это время применение других настроек недоступно. Настройки применятся, когда ресурс перейдет в статус ACTIVE.

Кэшировать контент с учетом cookies

По умолчанию CDN игнорирует cookies.

Вы можете включить кэширование контента с учетом параметров cookies.

CDN кэширует один файл с разными cookies из HTTP-заголовка запроса как разные файлы, и каждый новый запрос пользователя перенаправляется на источник.

В панели управления в верхнем меню нажмите Продукты и выберите CDN.
В разделе CDN-ресурсы откройте страницу CDN-ресурса → вкладка Кэширование.
Отметьте чекбокс Включить настройки кэширования.
В блоке Кэшировать с учетом cookies отметьте чекбокс Кэшировать с учетом cookies. По умолчанию будут учитываться все cookies.
Если вы хотите учитывать определенные cookies в запросе, снимите чекбокс Учитывать все параметры.
Укажите разрешенные или запрещенные параметры cookies:
- включите White List, добавьте разрешенный параметр cookies и нажмите . При обработке запроса будут учитываться только параметры cookies, которые включены в этот список.
- или включите Black List, добавьте запрещенный параметр cookies и нажмите . При обработке запроса будут учитываться все параметры, которые не включены в этот список.
Нажмите Применить. Во время применения настроек ресурс будет находиться в статусе PROCESSING. В это время применение других настроек недоступно. Настройки применятся, когда ресурс перейдет в статус ACTIVE.