Кастомные VCL-правила Varnish: ускорение сайта и снижение нагрузки

Дефолтная конфигурация Varnish часто работает неэффективно: кэширует всё подряд или не кэширует критически важные страницы, игнорирует заголовки авторизации и падает на edge-кейсах с cookies. Результат — низкий hit rate (30–40%) и избыточная нагрузка на бэкенд. Если вы столкнулись с такой проблемой, закажите аудит текущей конфигурации Varnish. За 7+ лет мы провели более 50 проектов по оптимизации и гарантируем увеличение hit rate до 90%+ при полной сохранности бизнес-логики. Один из клиентов — интернет-магазин с трафиком 500 000 запросов в час — после внедрения кастомных правил увеличил hit rate с 35% до 93% всего за 2 дня. Это сократило нагрузку на бэкенд в 8 раз и сэкономило до 70% бюджета на серверы.

Varnish Cache использует VCL для описания политик кэширования.

Как кастомные VCL-правила ускоряют сайт?

Кастомные VCL-правила решают конкретные задачи: управление кэшем по условиям, нормализация запросов, обход CDN для определённых маршрутов, маршрутизация на разные бэкенды, grace-режим при падении origin. Рассмотрим ключевые аспекты.

Нормализация запросов

Без нормализации один и тот же ресурс хранится под десятками ключей: /?utm_source=google, /?utm_source=facebook — это разные записи в кэше, хотя контент идентичен. По статистике, URL с utm-метками занимают до 30% кэш-пространства впустую. Нормализация решает эту проблему.

vcl 4.1;
import std;
import directors;

backend default {
    .host = "127.0.0.1";
    .port = "8080";
    .connect_timeout = 2s;
    .first_byte_timeout = 60s;
    .between_bytes_timeout = 10s;
    .probe = {
        .url = "/healthz";
        .timeout = 1s;
        .interval = 5s;
        .window = 5;
        .threshold = 3;
    }
}

backend api {
    .host = "127.0.0.1";
    .port = "8081";
    .connect_timeout = 1s;
    .first_byte_timeout = 30s;
}

sub vcl_recv {
    # Удаляем маркетинговые параметры
    if (req.url ~ "(\?|&)(utm_source|utm_medium|utm_campaign|utm_term|utm_content|fbclid|gclid|yclid|_ga|mc_eid)=") {
        set req.url = regsuball(req.url, "&(utm_source|utm_medium|utm_campaign|utm_term|utm_content|fbclid|gclid|yclid|_ga|mc_eid)=[^&]*", "");
        set req.url = regsuball(req.url, "\?(utm_source|utm_medium|utm_campaign|utm_term|utm_content|fbclid|gclid|yclid|_ga|mc_eid)=[^&]*&", "?");
        set req.url = regsub(req.url, "\?$", "");
    }

    # Нормализуем Accept-Encoding
    if (req.http.Accept-Encoding) {
        if (req.url ~ "\.(jpg|jpeg|png|gif|webp|gz|tgz|bz2|tbz|mp3|ogg|swf|flv|mp4|woff2?)$") {
            unset req.http.Accept-Encoding;
        } else if (req.http.Accept-Encoding ~ "br") {
            set req.http.Accept-Encoding = "br";
        } else if (req.http.Accept-Encoding ~ "gzip") {
            set req.http.Accept-Encoding = "gzip";
        } else {
            unset req.http.Accept-Encoding;
        }
    }

    # Нормализуем cookies
    if (req.http.Cookie) {
        set req.http.Cookie = ";" + req.http.Cookie;
        set req.http.Cookie = regsuball(req.http.Cookie, "; +", ";");
        set req.http.Cookie = regsuball(req.http.Cookie, ";(session|auth_token|XSRF-TOKEN)=", "; \\1=");
        set req.http.Cookie = regsuball(req.http.Cookie, ";[^ ][^;]*", "");
        set req.http.Cookie = regsuball(req.http.Cookie, "^[; ]+|[; ]+$", "");
        if (req.http.Cookie == "") {
            unset req.http.Cookie;
        }
    }

    # Определение типа устройства для адаптивного кэша
    if (req.http.User-Agent ~ "(?i)mobile|android|iphone|ipod|blackberry|opera mini|iemobile") {
        set req.http.X-Device-Type = "mobile";
    } else {
        set req.http.X-Device-Type = "desktop";
    }

    # Маршрутизация по типу контента
    if (req.url ~ "^/api/") {
        return(pass);
    }
    if (req.http.Authorization || req.http.Cookie ~ "auth_token=") {
        return(pass);
    }
    if (req.method != "GET" && req.method != "HEAD") {
        return(pass);
    }
    if (req.url ~ "\.(css|js|jpg|jpeg|png|gif|ico|svg|woff|woff2|ttf|eot|webp|avif)(\?.*)?$") {
        unset req.http.Cookie;
        return(hash);
    }
    return(hash);
}

sub vcl_hash {
    hash_data(req.url);
    if (req.http.host) {
        hash_data(req.http.host);
    }
    hash_data(req.http.X-Device-Type);
    return(lookup);
}

Что такое grace-режим и как он работает?

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

sub vcl_backend_response {
    set beresp.grace = 24h;
    if (beresp.status >= 500) {
        set beresp.ttl = 0s;
        set beresp.grace = 60s;
        return(deliver);
    }
    # Кастомный TTL по типу контента
    if (bereq.url ~ "^/news/") {
        set beresp.ttl = 10m;
    } else if (bereq.url ~ "^/static/") {
        set beresp.ttl = 30d;
        unset beresp.http.Set-Cookie;
    } else if (bereq.url ~ "^/product/") {
        set beresp.ttl = 1h;
    } else {
        set beresp.ttl = 5m;
    }
    if (beresp.http.Cache-Control ~ "no-store|private") {
        set beresp.uncacheable = true;
        return(deliver);
    }
}

sub vcl_hit {
    if (obj.ttl >= 0s) {
        return(deliver);
    }
    if (obj.ttl + obj.grace > 0s) {
        return(deliver);
    }
    return(restart);
}

Как реализовать инвалидацию кэша через VCL?

Purge по тегам (через xkey) — правильный подход для CMS с зависимостями между объектами.

import xkey;

acl purge_acl {
    "127.0.0.1";
}

sub vcl_recv {
    if (req.method == "PURGE") {
        if (!client.ip ~ purge_acl) {
            return(synth(405, "Not allowed"));
        }
        return(purge);
    }
    if (req.method == "XKEY-PURGE") {
        if (!client.ip ~ purge_acl) {
            return(synth(405, "Not allowed"));
        }
        set req.http.n-gone = xkey.softpurge(req.http.xkey-purge);
        return(synth(200, "Purged " + req.http.n-gone + " objects"));
    }
}

sub vcl_backend_response {
    if (beresp.http.Surrogate-Key) {
        set beresp.http.xkey = beresp.http.Surrogate-Key;
    }
}

Сравнение методов инвалидации:

Отладка и мониторинг

sub vcl_deliver {
    if (obj.hits > 0) {
        set resp.http.X-Cache = "HIT";
        set resp.http.X-Cache-Hits = obj.hits;
    } else {
        set resp.http.X-Cache = "MISS";
    }
    set resp.http.X-Served-By = server.hostname;
    unset resp.http.X-Powered-By;
    unset resp.http.Server;
    unset resp.http.X-Varnish;
    unset resp.http.Via;
}

# Текущий hit rate
varnishstat -f MAIN.cache_hit,MAIN.cache_miss

# Живой лог с фильтрацией по URL
varnishlog -q 'ReqURL ~ "^/news/"' -g request

# Топ cache miss по URL
varnishtop -i ReqURL -q 'VCL_call eq "MISS"'

Почему нормализация запросов критична для hit rate?

Нормализация запросов — основа эффективного кэширования. Без неё hit rate может быть ниже 50% даже при правильно настроенном TTL. Например, URL с utm-метками занимают до 30% кэш-пространства впустую. Нормализация также предотвращает проблемы с cookie-зависимым контентом и неверным кэшированием динамических страниц. Кастомные VCL-правила повышают hit rate в 2-3 раза по сравнению с дефолтной конфигурацией, что подтверждается нашими проектами.

Как настроить нормализацию запросов?

1. Определите параметры, которые нужно удалить (utm, fbclid, gclid и т.д.).
2. Напишите vcl_recv, который очищает эти параметры из req.url.
3. Нормализуйте Accept-Encoding — приоритет отдайте br, потом gzip.
4. Обработайте cookies: удалите все, кроме необходимых для сессии.
5. Добавьте device-aware хэш для разделения mobile/desktop.
6. Протестируйте с помощью varnishtest и мониторинга.

Процесс внедрения

Типовой проект внедрения кастомных VCL-правил включает этапы:

• Аналитика (1–2 дня): аудит текущего трафика, анализ заголовков ответов бэкенда, выявление некэшируемых паттернов (cookies, Cache-Control: private).
• Проектирование (1 день): разработка архитектуры VCL-правил, определение кэш-ключей, grace-периодов, маршрутизации.
• Реализация (2–3 дня): написание VCL-скриптов, настройка health checks, интеграция с CDN.
• Тестирование (1 день): проверка на стейджинге с varnishtest, замеры hit rate, сравнение с базовой конфигурацией.
• Деплой (1 день): выкатка на прод, настройка мониторинга, документация.

Сложные кейсы (A/B тестирование через Varnish, ESI-включения, многоуровневое кэширование с Nginx) добавляют 3–5 дней.

Что входит в работу

• Кастомные VCL-правила с учётом архитектуры проекта.
• Нормализация URL, cookies, Accept-Encoding.
• Grace-режим и stale-while-revalidate.
• Инвалидация кэша через PURGE/xkey.
• Интеграция с CDN и системами деплоя.
• Нагрузочное тестирование и настройка мониторинга (varnishstat, metrics).
• Документация по внедрённым правилам и процессу инвалидации.

Сравнение: дефолтная конфигурация vs кастомные VCL

Закажите аудит текущей конфигурации Varnish — мы определим узкие места и предложим кастомные решения. Свяжитесь с нами для получения индивидуального предложения.