CDN
Очистка кэша Kapsule CDN
Purging clears the copy of your content held at the edge so the next visitor gets a freshly fetched version from your origin, which is what you do when you have published a change and the old…
Очистка удаляет копию вашего контента, хранящуюся на граничных серверах, так что следующий посетитель получит свежую версию, загруженную с вашего оригинального сервера. Это необходимо сделать, когда вы опубликовали изменение, но старая версия всё ещё отображается.
Кэширование делает CDN быстрым, но оно же является причиной того, что сделанные вами изменения могут появиться не сразу. Вместо того чтобы устанавливать время жизни кэша на минимум, держите его долгим и очищайте кэш при необходимости. В этом руководстве рассмотрены оба подхода, а также объясняется разница между кэшем на граничном сервере и кэшем браузера, чтобы вы не искали в неправильном месте.
Когда требуется очистка кэша
Очищайте кэш после того, как изменили что-то, что посетители получают по URL:
- Вы заменили CSS или JavaScript файл, но старый всё ещё загружается.
- Вы загрузили новую версию изображения с тем же именем файла.
- Вы исправили ошибку на странице и хотите, чтобы неработающая версия исчезла повсеместно, прямо сейчас.
- Вы изменили содержимое страницы и не можете ждать истечения TTL на граничном сервере.
Очистка кэша не требуется, если вы добавили совершенно новую страницу или новое имя файла. Ничего не кэшируется для URL, который никогда не запрашивался.
Если вы указываете версию в именах файлов активов (style.a1b2c3.css вместо style.css), вам редко потребуется очистка кэша вообще. Новое имя файла представляет собой новый URL, поэтому он загружается заново с вашего оригинального сервера и кэшируется под своим собственным ключом.
Где находится элемент управления очисткой кэша
- Войдите в KPanel.
- Нажмите Websites на левой боковой панели, затем выберите ваш сайт.
- В меню сайта откройте Performance, затем Kapsule CDN.
- Прокрутите вниз до карточки Purge cache.
Прямой адрес: /websites/<site-id>/cdn.
Элемент управления очисткой кэша появляется только после включения CDN для сайта. Если на странице отображается баннер CDN is off for this site или предлагается подключить собственный домен, на граничных серверах ещё нечего очищать. Kapsule CDN также является функцией плана, поэтому сайт на плане Orbit или Container Hosting не имеет CDN вообще. Enabling Kapsule CDN on Your Site содержит информацию о том, какие именно планы его включают.
Очистка одного URL
- В карточке Purge cache введите полный публичный URL в поле URL to purge (leave blank for whole site). Подсказка поля показывает ожидаемый формат:
https://your-domain.tld/path. - Нажмите Purge.
- Появится подтверждение с текстом "Purged" и введённым вами URL.
Используйте точный URL, который запросит посетитель, включая схему (https://), хост и путь. Очистка соответствует URL, поэтому https://example.com/about и https://example.com/about/ представляют две разные записи кэша, как и одна и та же страница с добавленной строкой запроса.
Очистка одного URL это правильный первый шаг, когда вы точно знаете, что изменилось. Это происходит мгновенно и оставляет остальной кэш нетронутым, поэтому остальной сайт остаётся быстрым.
Очистка всего сайта
- Оставьте поле URL to purge полностью пустым.
- Нажмите Purge.
- Подтверждение гласит "Full cache purged."
Полная очистка удаляет все кэшированные объекты сайта на всех граничных серверах. До тех пор, пока каждый URL не будет запрошен снова, каждый посетитель будет получать данные с вашего оригинального сервера, поэтому оригинальный сервер столкнётся с всплеском трафика и первый посетитель каждой страницы ждёт полного обхода. На загруженном сайте предпочитайте очистку только тех URL, которые вы изменили.
Каждая выполненная очистка записывается в журнал действий аккаунта с URL или маркером всей зоны, поэтому вы можете видеть, кто и когда очистил кэш.
Время жизни кэша и их взаимодействие
Карточка Cache TTLs на той же странице управляет тем, как долго контент сохраняется без очистки:
| Параметр | Что он контролирует | По умолчанию |
|---|---|---|
| Edge TTL (seconds) | Как долго граничный сервер хранит копию перед повторной загрузкой с вашего оригинального сервера | 3600 (1 час) |
| Browser TTL (seconds) | Как долго браузер посетителя сохраняет собственную локальную копию | 3600 (1 час) |
Эти два параметра независимы друг от друга, и это самый частый источник путаницы. Очистка удаляет кэш на граничном сервере. Она не может повлиять на кэш браузера посетителя. Если вы очищаете кэш, но всё ещё видите старую версию, вы почти наверняка смотрите на кэш своего собственного браузера.
Чтобы проверить это, загрузите страницу в приватном или инкогнито окне или выполните полную перезагрузку. Если приватное окно показывает новую версию, очистка сработала, и вы просто ждёте, пока истечёт TTL вашего браузера и браузеров других посетителей.
Если вы часто публикуете контент и не можете указывать версию в именах файлов, установите Browser TTL на короткий промежуток времени (несколько минут) и оставьте Edge TTL длинным. Вы сохраняете большую часть преимущества граничного сервера, но даёте посетителям намного более короткое окно, в течение которого они могут видеть старую копию.
Оптимизация изображений и очистка кэша
Если включена On-the-fly image optimisation, граничный сервер хранит оптимизированную производную версию каждого изображения наряду с оригиналом. Очистка URL изображения также удаляет производную версию, поэтому заменённое изображение повторно оптимизируется при следующем запросе. Отдельной очистки для оптимизированных изображений нет.
То же самое применяется к Serve WebP to supported browsers: вариант WebP находится под тем же URL и удаляется той же очисткой.
Устранение неполадок
"CDN not provisioned for this site." На сайте ещё нет граничной зоны. Сначала включите CDN и дождитесь завершения подготовки сертификата.
"Purge failed." Запрос на очистку не достиг граничного сервера. Подождите момент и попробуйте снова. Если это продолжает происходить, граничная зона может быть в процессе подготовки; проверьте, что на странице отображается баннер CDN is on.
I purged and the page is still old. Сначала проверьте в приватном окне. Если приватное окно также показывает старую версию, убедитесь, что вы очистили точный URL, включая любой завершающий слэш и строку запроса, а затем попробуйте полную очистку.
Only some visitors see the update. Их браузеры всё ещё находятся в пределах Browser TTL. Здесь нет ошибки: они получат новую версию при истечении этого времени или сразу при полной перезагрузке.
The origin fell over after a full purge. Это всплеск некэшированного трафика, описанный выше. Увеличьте Edge TTL, и в следующий раз очищайте только те URL, которые изменились. Improving Website Speed содержит информацию о том, как сделать сам оригинальный сервер более устойчивым.
Если очистка выполняется успешно, но граничный сервер продолжает отправлять старый контент более чем несколько минут, напишите письмо на support@kapsulehost.com с указанием точного URL и времени очистки.