TrafficVeil
Вернуться к документации
Документация

Кэширование

Edge кэширование, TTL, правила и очистка кэша.

Обзор кэширования


Что такое Edge Caching?

TrafficVeil кэширует статический контент на своих серверах (Edge), чтобы ускорить загрузку для пользователей и снизить нагрузку на Origin.


Преимущества:

  • Быстрая загрузка (из ближайшего Edge)
  • Снижение нагрузки на Origin
  • Экономия трафика
  • Защита от пиковых нагрузок

  • Что кэшируется по умолчанию:

  • Изображения (jpg, png, gif, webp, svg)
  • Стили (css)
  • Скрипты (js)
  • Шрифты (woff, woff2, ttf)
  • Документы (pdf)

  • Что НЕ кэшируется:

  • HTML страницы (по умолчанию)
  • API ответы
  • POST запросы
  • Запросы с cookies
  • Контент с Cache-Control: no-cache

  • Время жизни кэша (TTL)


    Что такое TTL?

    Time To Live — время, в течение которого контент хранится в кэше.


    Настройка TTL:


    По типу контента:

  • Изображения: 1 год (31536000s)
  • CSS/JS: 1 месяц (2592000s)
  • Шрифты: 1 год
  • HTML: не кэшировать или 1 час

  • По расширению:

  • .jpg, .png, .gif: 86400 (1 день)
  • .css, .js: 604800 (1 неделя)
  • .html: 0 (не кэшировать)

  • Настройка в панели:

    1. Настройки домена → Кэширование

    2. Выберите TTL для каждого типа

    3. Сохраните


    Использование заголовков Origin:

    Можно использовать заголовки с Origin:

  • Cache-Control: max-age=3600
  • Expires: Thu, 01 Dec 2025 16:00:00 GMT

  • Приоритет:

    1. Page Rules (высший)

    2. Настройки панели

    3. Заголовки Origin

    4. Дефолтные значения


    Очистка кэша


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

  • Обновили CSS/JS
  • Изменили изображения
  • Обновили контент сайта
  • Исправили ошибку в файле

  • Способы очистки:


    1. Полная очистка:

    Очищает весь кэш домена.

  • Панель → Кэш → Очистить всё
  • Используйте осторожно — нагрузка на Origin

  • 2. По URL:

    Очистка конкретных URL:

  • Укажите точные URL
  • До 30 URL за раз
  • /styles/main.css
  • /images/logo.png

  • 3. По префиксу:

    Очистка по префиксу URL:

  • /images/* — все изображения
  • /blog/* — все страницы блога

  • 4. По тегу (Pro+):

    Очистка по Cache-Tag:

  • Добавьте Cache-Tag: product-123
  • Очистите по тегу

  • API очистка:

    ```bash

    curl -X POST "https://api.trafficveil.com/v1/domains/{id}/cache/purge"

    -H "Authorization: Bearer {token}"

    -d '{"urls": ["/style.css"]}'

    ```


    Правила кэширования


    Page Rules для кэширования:


    Кэшировать всё:

    URL: example.com/*

    Действие: Cache Everything

    TTL: 1 час

  • Кэширует даже HTML

  • Обход кэша:

    URL: example.com/admin/*

    Действие: Bypass Cache

  • Админка без кэша

  • Кэш для API:

    URL: example.com/api/public/*

    Действие: Cache Everything

    TTL: 5 минут

  • Только для публичных API

  • Кэш для статики:

    URL: example.com/static/*

    Действие: Cache Everything

    TTL: 1 год

  • Используйте версионирование файлов

  • Создание правила:

    1. Page Rules → Добавить

    2. Укажите URL паттерн

    3. Выберите действие

    4. Укажите TTL

    5. Сохраните


    Приоритет правил:

    Правила применяются сверху вниз. Первое совпавшее правило применяется.


    Аналитика кэша


    Метрики кэширования:


    Cache Hit Ratio:

    Процент запросов, обслуженных из кэша:

  • 90%+ — отлично
  • 70-90% — хорошо
  • <70% — нужна оптимизация

  • Сэкономленный трафик:

    Сколько трафика не пошло на Origin:

  • В GB
  • В процентах

  • Топ кэшированных URL:

    Какие URL чаще всего отдаются из кэша.


    Топ некэшированных URL:

    Какие URL не попадают в кэш — возможность оптимизации.


    Статистика:

  • HIT — из кэша
  • MISS — с Origin (закэшировано)
  • EXPIRED — истёк, обновлено
  • BYPASS — обошёл кэш
  • DYNAMIC — динамический контент

  • Заголовок CF-Cache-Status:

    В ответе TrafficVeil добавляет заголовок:

  • CF-Cache-Status: HIT
  • CF-Cache-Status: MISS

  • Оптимизация:

    1. Проверьте некэшированные URL

    2. Добавьте правила кэширования

    3. Увеличьте TTL для статики