Подключение: Qrator.CDN

Прямо в личном кабинете Qrator Labs клиенты могут подключить и настроить услугу Qrator.CDN.

Домен и сертификат

Для использования Qrator.CDN вам необходимо настроить сайт таким образом, чтобы для статического контента использовался отдельный домен. Qrator.CDN будет обрабатывать запросы пользователей к этому домену, при необходимости обращаясь к вашему апстриму и обновляя контент оттуда.

Qrator.CDN автоматически создаёт для каждого сайта домен, который может быть использован для этих целей. Однако часто клиентам нужно, чтобы статический контент располагался на их собственном домене — например, определённом поддомене основного домена. В таком случае необходимо завести запись CNAME в соответствующей DNS-зоне.

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

См. руководство по использованию личного кабинета: Добавить HTTP-хост, Добавить HTTPS-хост.

Настройки заголовков

Хотя CDN не модифицирует тело контента, который кеширует (за исключением опциональной обработки изображений, см. ниже), зачастую возникает необходимость в том, чтобы CDN добавил тот или иной HTTP-заголовок к запросу пользователя или ответу апстрима. Qrator.CDN может добавлять произвольные заголовки, описанные в личном кабинете.

Также Qrator.CDN может указывать исходный IP-адрес пользователя в специальном заголовке, название которого вы можете настроить в личном кабинете.

См. руководство по использованию личного кабинета: Изменить настройки HTTP-заголовков.

Списки запрещённых и разрешённых URL

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

При необходимости клиент может также задать список разрешённых URL. В этом случае CDN будет запрашивать контент только для URL из этого списка, а на все остальные отвечать кодом ошибки. Код ошибки по умолчанию — 404 Not Found, но он может быть переопределён для отдельных страниц с помощью списка запрещённых URL.

См. руководство по использованию личного кабинета: Настроить политики для URL запросов.

Настройки кеширования

Эффективное кеширование является основной задачей CDN, и важно, чтобы оно выполнялось корректно, с учётом структуры размещения контента на сайте. Поэтому в личном кабинете клиент может настроить то, как CDN будет работать с HTTP-заголовком Cache-Control, а также включить или отключить кеширование ошибок определённых типов. Также клиент может включить игнорирование всех GET-параметров запроса. Например, это удобно, если вы полагаетесь на случайно сгенерированные GET-параметры для принудительного обновления закешированного контента браузером, но не хотите, чтобы это приводило к лишним запросам от CDN к апстриму.

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

Вы можете попросить специалистов технической поддержки Qrator Labs принудительно закешировать и обновить часть контента в CDN (выполнить так называемый прогрев CDN), не дожидаясь момента, когда этот контент впервые запросят пользователи. Это бывает нужно, если на сервере-источнике обновляется значительная часть контента. Без выполнения предварительного кеширования загрузка нового контента для первых пользователей может производиться дольше обычного, т. к. в CDN еще не будет закешированного контента и кеши будут наполняться постепенно.

См. руководство по использованию личного кабинета: Изменить настройки кеширования.

Обработка изображений

Для изображений JPEG, PNG, TIFF, WebP и AVIF (типы определяются по заголовку Content-Type) Qrator.CDN может выполнять простые операции в соответствии с GET-параметрами в запросе пользователя.

crop — обрезать изображение.

Значение GET-параметра должно иметь формат x⟨ЧИСЛО⟩,y⟨ЧИСЛО⟩,w⟨ЧИСЛО⟩,h⟨ЧИСЛО⟩. Операция возвращает содержимое прямоугольника, начинающегося в точке (x,y) от верхнего левого угла и имеющего размер w×h.

Пример ниже указывает, что Qrator.CDN должен загрузить изображение image.png из апстрима и вернуть его фрагмент размером 500×200 пикселей, отступив 10 пикселей слева и 15 пикселей сверху.
```
https://cdn.example.com/image.png?crop=x10,y15,w500,h200
```
resize — масштабировать изображение.

Значение GET-параметра должно иметь формат w⟨ЧИСЛО⟩ для масштабирования к указанной ширине или h⟨ЧИСЛО⟩ для масштабирования к указанной высоте. Пропорции изображения при масштабировании сохраняются.

Если resize используется вместе с crop, то масштабирование применяется к результату операции crop.

Пример ниже указывает, что Qrator.CDN должен загрузить изображение image.png из апстрима и вернуть его копию, уменьшенную или увеличенную до ширины 300 пикселей.
```
https://cdn.example.com/image.png?resize=w300
```
format — конвертировать изображение в нужный формат.

Значение GET-параметра может быть одной из строк: jpeg, png, webp, avif. Опциональный параметр q⟨ЧИСЛО⟩ (допустимы значения от 1 до 100) указывает конвертеру, насколько близким к оригиналу следует сохранять качество изображения. Реальное качество может отличаться в зависимости от выбранного формата.

Пример ниже указывает, что Qrator.CDN должен загрузить изображение image.png из апстрима и вернуть его копию в формате JPEG с уровнем качества 75.
```
https://cdn.example.com/image.png?format=jpeg,q75
```

Обратите внимание, что при невалидных или отсутствующих параметрах для операции Qrator.CDN вернёт оригинал изображения без изменений.

При использовании операций crop или resize без операции format Qrator.CDN вернёт изображение в формате JPEG либо WebP (если включено Преобразование изображений в WebP).

Преобразование изображений в WebP

Для ускорения работы сайта можно использовать режим автоконвертации изображений в формат WebP. Формат WebP обеспечивает более компактный размер файла при сравнимом качестве изображения.

Когда режим автоконвертации включён, Qrator.CDN определяет по заголовку Accept в запросе, поддерживает ли браузер пользователя формат WebP. Если формат поддерживается, то вместо каждого изображения пользователю отправляется версия этого изображения в формате WebP. Исходные версии изображений остаются в кеше Qrator.CDN. Если версия браузера пользователя не поддерживает WebP, то Qrator.CDN отправляет исходную версию изображения без изменений.

См. руководство по использованию личного кабинета: Настроить конвертацию изображений в WebP.

Настройки транспорта

По умолчанию Qrator.CDN отдаёт статический контент только по протоколу HTTP/1.1. Вы можете включить поддержку HTTP/2, чтобы обеспечить более эффективную передачу трафика за счёт сжатия заголовков, мультиплексирования запросов и некоторых других техник.

Как для HTTP/1.1, так и для HTTP/2 вы можете выбрать используемый формат потокового сжатия трафика. Qrator.CDN поддерживает форматы сжатия gzip, deflate, br, а также передачу без сжатия. Переключение между ними осуществляется в личном кабинете.

См. руководство по использованию личного кабинета: Изменить настройки транспорта.