TrafficVeil
Документация10 min

Кэширование

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

Обновлено 17 июня 2026 г.

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

Что такое 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 для статики