Очистка удаляет копию вашего содержимого, хранящуюся на границе, чтобы следующий посетитель получил версию, заново загруженную с вашего исходного сервера. Это нужно, когда вы опубликовали изменение, а по-прежнему показывается старая версия.
Кэширование делает CDN быстрой, и именно из-за него только что внесённое изменение может появиться не сразу. Вместо того чтобы сокращать время жизни кэша до нуля, оставьте его длинным и очищайте кэш по мере необходимости. В этом руководстве описано и то и другое, а также как отличить кэш на границе от кэша браузера, прежде чем искать проблему не в том месте.
Когда нужна очистка
Очищайте кэш после изменения того, что посетители загружают по URL:
- Вы заменили файл CSS или JavaScript, а по-прежнему отдаётся старый.
- Вы загрузили новую версию изображения поверх существующего имени файла.
- Вы исправили ошибку на странице и хотите, чтобы неисправная версия исчезла повсюду прямо сейчас.
- Вы изменили содержимое страницы и не можете ждать, пока истечёт TTL на границе.
Очищать кэш не нужно, если вы добавили совершенно новую страницу или новое имя файла. Для URL, который ещё ни разу не запрашивался, в кэше ничего нет.
Если вы добавляете версию в имена файлов ресурсов (style.a1b2c3.css вместо style.css), очищать кэш почти никогда не придётся. Новое имя файла означает новый URL, поэтому он заново загружается с исходного сервера и кэшируется под собственным ключом.
Где находится очистка кэша
- Войдите в KPanel.
- Нажмите Веб-сайты на левой боковой панели, затем выберите свой сайт.
- В меню сайта откройте Производительность, затем Kapsule CDN.
- Прокрутите страницу до карточки Очистить кэш.
Прямой адрес: /websites/<site-id>/cdn.
Очистка появляется только после включения CDN для сайта. Если на странице показан баннер CDN отключена для этого сайта или предлагается подключить собственный домен, на границе пока нечего очищать. В статье Включение Kapsule CDN на сайте точно указано, какие тарифы её включают.
Очистка одного URL
- В карточке Очистить кэш введите полный публичный URL в поле URL для очистки (оставить пусто для всего сайта). Подсказка в поле показывает ожидаемый формат:
https://your-domain.tld/path. - Нажмите Очистить.
- Появится подтверждение о том, что кэш введённого URL очищен.
Используйте точно тот URL, который запросил бы посетитель, включая схему (https://), хост и путь. Очистка сопоставляется по URL, поэтому https://example.com/about и https://example.com/about/ являются двумя разными записями кэша, как и та же страница с добавленной строкой запроса.
Очистка одного URL будет правильным первым шагом, если вы точно знаете, что изменилось. Она выполняется мгновенно и не затрагивает остальной кэш, так что остальная часть сайта остаётся быстрой.
Очистка всего сайта
- Оставьте поле URL для очистки полностью пустым.
- Нажмите Очистить.
- В подтверждении будет сказано: «Кэш полностью очищен.»
Полная очистка удаляет все закэшированные объекты сайта во всех точках присутствия на границе. Пока каждый URL не будет запрошен снова, каждый посетитель обслуживается с вашего исходного сервера, поэтому на него приходится всплеск трафика, а первый посетитель каждой страницы ждёт полный цикл запроса. На сайте с высокой посещаемостью лучше очищать только те URL, которые вы изменили.
Каждая выполненная очистка записывается в журнал действий аккаунта с URL или отметкой о полной очистке зоны, так что вы можете увидеть, кто, что и когда очистил.
Время жизни кэша и как они взаимодействуют
Карточка TTL кэша на той же странице определяет, как долго содержимое хранится без очистки:
| Параметр | Что он определяет | По умолчанию |
|---|---|---|
| Edge TTL (секунды) | Как долго граница хранит копию, прежде чем снова загрузить её с исходного сервера | 3600 (1 час) |
| Browser TTL (секунды) | Как долго браузер посетителя хранит собственную локальную копию | 3600 (1 час) |
Эти два параметра не зависят друг от друга, и это самая частая причина путаницы. Очистка стирает кэш на границе. Она не может проникнуть в браузер посетителя. Если после очистки вы сами по-прежнему видите старую версию, почти наверняка вы смотрите на кэш своего браузера.
Чтобы исключить это, откройте страницу в приватном окне или в режиме инкогнито либо выполните принудительную перезагрузку. Если в приватном окне видна новая версия, очистка сработала, и осталось только дождаться обновления вашего браузера и браузеров других посетителей, которое произойдёт, когда истечёт их TTL браузера.
Если вы часто публикуете изменения и не можете добавлять версии в имена файлов, уменьшите Browser TTL до небольшого значения (несколько минут), а Edge TTL оставьте длинным. Так вы сохраните большую часть преимуществ границы и значительно сократите период, в течение которого посетители могут видеть старую копию.
Оптимизация изображений и очистка
Если включена Оптимизация изображений на лету (функция Kapsule CDN+), граница хранит оптимизированную версию каждого изображения рядом с оригиналом. Очистка URL изображения стирает и оптимизированную версию, поэтому заменённое изображение будет оптимизировано заново при следующем запросе. Отдельной очистки для оптимизированных изображений нет.
То же относится к Доставлять WebP поддерживающим браузерам: вариант WebP находится по тому же URL и стирается той же очисткой.
Устранение неполадок
«CDN не подготовлен для этого сайта.» У сайта ещё нет зоны на границе. Сначала включите CDN и дождитесь завершения выпуска сертификата.
«Ошибка очистки.» Запрос на очистку не дошёл до границы. Подождите немного и повторите попытку. Если ошибка повторяется, зона на границе, возможно, ещё подготавливается; убедитесь, что на странице показан баннер CDN включена.
Я очистил кэш, но страница всё ещё старая. Сначала проверьте в приватном окне. Если и в приватном окне видна старая версия, убедитесь, что вы очистили точно тот URL, включая завершающую косую черту и строку запроса, если они есть, а затем попробуйте полную очистку.
Обновление видят только некоторые посетители. Их браузеры ещё находятся в пределах TTL браузера. Ничего страшного: они получат новую версию, когда он истечёт, или сразу после принудительной перезагрузки.
После полной очистки исходный сервер не выдержал нагрузки. Это тот самый всплеск некэшированного трафика, описанный выше. Увеличьте Edge TTL и в следующий раз очищайте только изменившиеся URL. В статье Ускорение работы сайта описано, как сделать сам исходный сервер устойчивее.
Если очистка проходит успешно, но граница продолжает отдавать старое содержимое дольше нескольких минут, напишите на support@kapsulehost.com, указав точный URL и время очистки.