Решение проблем в Cloud CDN

Ниже перечислены проблемы, часто возникающие при работе с Cloud CDN, и способы их решения.

На запросы файлов CDN отвечает кодами 3xx (перенаправление)На запросы файлов CDN отвечает кодами 3xx (перенаправление)

Проверьте, что в настройках ресурса указаны:

• Протокол (HTTP или HTTPS), который используется источниками в качестве основного. Если источники перенаправляют запросы с URI со схемой http на URI со схемой https, для ресурса нужно выбрать протокол HTTPS, и наоборот.

• Значение HTTP-заголовка Host, с которого источники не перенаправляют запросы.

  Например, если настроено значение заголовка www.example.com, а источники перенаправляют запросы с таким значением на example.com, измените значение в настройках на example.com.

На запросы файлов CDN отвечает кодами 4xx (ошибка клиента)На запросы файлов CDN отвечает кодами 4xx (ошибка клиента)

Проверьте, что:

• Доступ конечных клиентов к контенту разрешен в настройках ресурса.

• Источники возвращают файлы в ответ на прямые запросы (в обход CDN).

• Источники разрешают и корректно обрабатывают запросы, соответствующие настройкам ресурса:

  • по указанному протоколу: HTTP или HTTPS;
  • с указанным значением HTTP-заголовка Host и другими заголовками.

На запросы файлов CDN отвечает кодами 5xx (ошибка сервера)На запросы файлов CDN отвечает кодами 5xx (ошибка сервера)

Проверьте, что:

• Источники отвечают на запросы CDN-серверов в течение 5 секунд.

• Источники разрешают и корректно обрабатывают запросы, соответствующие настройкам ресурса:

  • по указанному протоколу: HTTP или HTTPS;
  • с указанным значением HTTP-заголовка Host и другими заголовками.

Также проверьте статус Cloud CDN на специальной странице Yandex Cloud.

Изменения настроек не применились к ресурсуИзменения настроек не применились к ресурсу

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

У CDN-ресурса статус Not active, и контент недоступен пользователямУ CDN-ресурса статус Not active, и контент недоступен пользователям

Ресурс может находиться в статусе Not active из-за того, что к нему нет пользовательских запросов в течение 90 дней, или потому что его деактивировали вручную. Чтобы ресурс снова стал активен, включите опцию Доступ конечных пользователей к контенту в основных настройках ресурса. Активировать и деактивировать ресурсы могут пользователи с ролью cdn.editor или выше.

Не удается настроить TLS-сертификатНе удается настроить TLS-сертификат

Поддерживаются сертификаты из Yandex Certificate Manager. Вы можете выпустить новый сертификат Let's Encrypt® или загрузить собственный.

Сертификат должен находиться в том же каталоге, в котором расположен ваш CDN-ресурс.

Ниже приведен пример ошибки в CLI, когда сертификат и CDN-ресурс находятся в разных каталогах:

ERROR: operation (id=bcdb6qaiw8mb********) failed: rpc error: code = InvalidArgument desc = folder ids of user and certificate don't match; operation-id: bcdb6qaiw8mb********

CDN отправляет сжатые файлы пользователям, которые не запрашивают сжатый контентCDN отправляет сжатые файлы пользователям, которые не запрашивают сжатый контент

Cloud CDN может отправлять сжатые файлы, даже если пользователи не запрашивают сжатый контент. Такое поведение возникает если:

1. Первый запрос от клиента на файл, которого еще нет в кеше CDN, был с заголовком Accept-Encoding: gzip. Этот же заголовок передается в источник.
2. Источник передает в кеш CDN сжатый файл, но не проставляет заголовок Vary: Accept-Encoding. Такое происходит, например, если в качестве источника настроен бакет Object Storage.

В такой ситуации в кеше CDN сохраняется сжатый файл, и его будут получать все клиенты. При этом не имеет значения, поддерживают ли их устройства сжатие и включают ли они заголовок Accept-Encoding: gzip в свои запросы.

Чтобы этого избежать, включите сжатие файлов. Тогда Cloud CDN будет всегда запрашивать из источника контент без сжатия, а при запросе от клиента с заголовком Accept-Encoding: gzip сожмет файлы самостоятельно, без отправки заголовка источнику.