# Очистка кэша Kapsule CDN

Source: https://support.kapsulehost.com/ru-ru/cdn-cache-purge

Очистка удаляет копию вашего содержимого, хранящуюся на границе, чтобы следующий посетитель получил версию, заново загруженную с вашего исходного сервера. Это нужно, когда вы опубликовали изменение, а по-прежнему показывается старая версия.

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

## Когда нужна очистка

Очищайте кэш после изменения того, что посетители загружают по URL:

- Вы заменили файл CSS или JavaScript, а по-прежнему отдаётся старый.
- Вы загрузили новую версию изображения поверх существующего имени файла.
- Вы исправили ошибку на странице и хотите, чтобы неисправная версия исчезла повсюду прямо сейчас.
- Вы изменили содержимое страницы и не можете ждать, пока истечёт TTL на границе.

Очищать кэш не нужно, если вы добавили совершенно новую страницу или новое имя файла. Для URL, который ещё ни разу не запрашивался, в кэше ничего нет.

> **Tip:** Если вы добавляете версию в имена файлов ресурсов (`style.a1b2c3.css` вместо `style.css`), очищать кэш почти никогда не придётся. Новое имя файла означает новый URL, поэтому он заново загружается с исходного сервера и кэшируется под собственным ключом.

## Где находится очистка кэша

1. Войдите в [KPanel](https://kpanel.kapsulehost.com).
2. Нажмите **Веб-сайты** на левой боковой панели, затем выберите свой сайт.
3. В меню сайта откройте **Производительность**, затем **Kapsule CDN**.
4. Прокрутите страницу до карточки **Очистить кэш**.

Прямой адрес: `/websites/<site-id>/cdn`.

![Карточка «Очистить кэш» на странице Kapsule CDN](https://support.kapsulehost.com/help/screenshots/cdn-cache-purge.881b7fa3.webp)

> **Note:** Очистка появляется только после включения CDN для сайта. Если на странице показан баннер **CDN отключена для этого сайта** или предлагается подключить собственный домен, на границе пока нечего очищать. В статье [Включение Kapsule CDN на сайте](https://support.kapsulehost.com/ru-ru/cdn-enabling) точно указано, какие тарифы её включают.

## Очистка одного URL

1. В карточке **Очистить кэш** введите полный публичный URL в поле **URL для очистки (оставить пусто для всего сайта)**. Подсказка в поле показывает ожидаемый формат: `https://your-domain.tld/path`.
2. Нажмите **Очистить**.
3. Появится подтверждение о том, что кэш введённого URL очищен.

Используйте точно тот URL, который запросил бы посетитель, включая схему (`https://`), хост и путь. Очистка сопоставляется по URL, поэтому `https://example.com/about` и `https://example.com/about/` являются двумя разными записями кэша, как и та же страница с добавленной строкой запроса.

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

## Очистка всего сайта

1. Оставьте поле **URL для очистки** полностью пустым.
2. Нажмите **Очистить**.
3. В подтверждении будет сказано: «Кэш полностью очищен.»

> **Warning:** Полная очистка удаляет все закэшированные объекты сайта во всех точках присутствия на границе. Пока каждый URL не будет запрошен снова, каждый посетитель обслуживается с вашего исходного сервера, поэтому на него приходится всплеск трафика, а первый посетитель каждой страницы ждёт полный цикл запроса. На сайте с высокой посещаемостью лучше очищать только те URL, которые вы изменили.

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

## Время жизни кэша и как они взаимодействуют

Карточка **TTL кэша** на той же странице определяет, как долго содержимое хранится без очистки:

| Параметр | Что он определяет | По умолчанию |
|---|---|---|
| **Edge TTL (секунды)** | Как долго граница хранит копию, прежде чем снова загрузить её с исходного сервера | 3600 (1 час) |
| **Browser TTL (секунды)** | Как долго браузер посетителя хранит собственную локальную копию | 3600 (1 час) |

Эти два параметра не зависят друг от друга, и это самая частая причина путаницы. Очистка стирает кэш на **границе**. Она не может проникнуть в браузер посетителя. Если после очистки вы сами по-прежнему видите старую версию, почти наверняка вы смотрите на кэш своего браузера.

Чтобы исключить это, откройте страницу в приватном окне или в режиме инкогнито либо выполните принудительную перезагрузку. Если в приватном окне видна новая версия, очистка сработала, и осталось только дождаться обновления вашего браузера и браузеров других посетителей, которое произойдёт, когда истечёт их TTL браузера.

> **Tip:** Если вы часто публикуете изменения и не можете добавлять версии в имена файлов, уменьшите **Browser TTL** до небольшого значения (несколько минут), а **Edge TTL** оставьте длинным. Так вы сохраните большую часть преимуществ границы и значительно сократите период, в течение которого посетители могут видеть старую копию.

## Оптимизация изображений и очистка

Если включена **Оптимизация изображений на лету** (функция Kapsule CDN+), граница хранит оптимизированную версию каждого изображения рядом с оригиналом. Очистка URL изображения стирает и оптимизированную версию, поэтому заменённое изображение будет оптимизировано заново при следующем запросе. Отдельной очистки для оптимизированных изображений нет.

То же относится к **Доставлять WebP поддерживающим браузерам**: вариант WebP находится по тому же URL и стирается той же очисткой.

## Устранение неполадок

**«CDN не подготовлен для этого сайта.»** У сайта ещё нет зоны на границе. Сначала включите CDN и дождитесь завершения выпуска сертификата.

**«Ошибка очистки.»** Запрос на очистку не дошёл до границы. Подождите немного и повторите попытку. Если ошибка повторяется, зона на границе, возможно, ещё подготавливается; убедитесь, что на странице показан баннер **CDN включена**.

**Я очистил кэш, но страница всё ещё старая.** Сначала проверьте в приватном окне. Если и в приватном окне видна старая версия, убедитесь, что вы очистили точно тот URL, включая завершающую косую черту и строку запроса, если они есть, а затем попробуйте полную очистку.

**Обновление видят только некоторые посетители.** Их браузеры ещё находятся в пределах TTL браузера. Ничего страшного: они получат новую версию, когда он истечёт, или сразу после принудительной перезагрузки.

**После полной очистки исходный сервер не выдержал нагрузки.** Это тот самый всплеск некэшированного трафика, описанный выше. Увеличьте Edge TTL и в следующий раз очищайте только изменившиеся URL. В статье [Ускорение работы сайта](https://support.kapsulehost.com/ru-ru/website-speed) описано, как сделать сам исходный сервер устойчивее.

Если очистка проходит успешно, но граница продолжает отдавать старое содержимое дольше нескольких минут, напишите на [support@kapsulehost.com](mailto:support@kapsulehost.com), указав точный URL и время очистки.