Меню документации

Кеш статических ответов

Режим кеша включается явно. Чтобы включить его, добавьте корректный суффикс _cache-... к паролю прокси. Суффикс сам по себе полностью включает режим: активация на уровне аккаунта и список разрешённых токенов не нужны. Без суффикса Litport ничего не перехватывает и не кеширует: обычная работа прокси не меняется. Работа с сертификатом нужна только для режима кеша.

Практическое применение#

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

Измеренный пример: 1,000 посещений страницы с билетами#

59 повторно используемых скриптов · 4.30 МБ на визит без кешаИзмерено по одной анонимной загрузке страницы; все 1,000 визитов идут через один хаб в пределах срока кеша по умолчанию — 120 минут.
≈4.30 ГБ бесплатно · 99.9%Примерно $6.41 сэкономлено по условной цене $1.49/ГБ.
Измеренный пример по чистой анонимной загрузке главной страницы StubHub; статические ресурсы со временем меняются.

Учитываются только декодированные тела ответов. На результат влияют обходы кеша, истечение срока хранения, вытеснение записей, смена хаба и ваша фактическая ставка; безлимитные пакеты показывают бесплатные байты, но денежный кредит не получают.

Где работает кеш#

Режим кеша доступен для каждого семейства продуктов Litport для клиентов: серверные, ISP/статические резидентские, резидентские, мобильные, безлимитные и с оплатой за ГБ. Каждый запрос с включённым кешем через эндпоинт HTTP-прокси проверяется. Подходящие статические HTTPS-запросы GET могут сохраняться в кеш или попадать в него; неподходящие обходят кеш и идут по обычному пути прокси. Вход по SOCKS5 никогда не кеширует.

КонфигурацияРезультат
Корректный суффикс + HTTP-прокси + подходящий статический HTTPS GETПодходит для кеша
Корректный суффикс + HTTP-прокси + другой, приватный или нестатический HTTPSОбход с обычной тарификацией
Корректный суффикс + HTTP-прокси + целевой сайт по обычному HTTPТарифицируется как обычно; не сохраняется
Корректный суффикс + SOCKS5 + HTTP или HTTPSОбычный SOCKS5; без кеширования
Без суффиксаОбычное поведение во всех случаях
Пригодность для кеша зависит от активации, входа, протокола целевого сайта и безопасности запроса.

Быстрый старт#

  1. Скачайте корневой сертификат кеша Litport и добавьте его в доверенные или используйте описанный на той странице изолированный вариант без проверки сертификата для автоматизации с публичными данными.
  2. Добавьте _cache-scripts к паролю прокси.
  3. Дважды запросите один и тот же подходящий HTTPS-URL через hub-us-7.litport.net.
  4. Откройте раздел «Статистика трафика», чтобы увидеть промах, попадание, бесплатные байты и экономию при оплате за ГБ.
# Proxy endpoint: http://hub-us-7.litport.net:PORT · Target: pinned Lodash on jsDelivr
curl --proxy 'http://hub-us-7.litport.net:PORT' \
  --proxy-user 'USER:PASSWORD_cache-scripts' \
  --cacert litport-cache-root.crt \
  'https://cdn.jsdelivr.net/npm/[email protected]/lodash.min.js'

URL прокси начинается с http://, потому что curl подключается к Litport через HTTP CONNECT. Это не делает целевой сайт обычным HTTP: URL в конце должен начинаться с https://.

Первый запрос · холодныйОплачивается как обычно
Ваш клиент HTTPS-цель через HTTP-прокси
Хаб Litport Проверяет свой локальный кеш
Апстрим-прокси Запрос к исходному серверу идёт через ваш продукт
Проверенный исходный сервер Ответ 200 сохраняется
Повторный запрос · тёплыйКешированные байты БЕСПЛАТНЫ
Ваш клиент Тот же подходящий HTTPS URL
Хаб Litport Отдаёт локальную копию
Без апстримаЗапрос заканчивается здесь
Холодные запросы идут на проверенный исходный HTTPS-сервер и оплачиваются как обычно. Повторное попадание на том же хабе Litport обслуживается локально, не открывает соединение с апстримом, а байты кешированного ответа бесплатны.

Каждая запись кеша принадлежит одному хабу#

Записи кеша локальны для хаба и сохраняются после перезапуска сервиса хаба. На другие хабы они не копируются. Прогрев hub-us-7.litport.net не прогревает hub-eu-1.litport.net, но один и тот же корневой сертификат Litport работает на обоих хабах с включённым кешем.

Один URLТот же пароль с включённым кешем и тот же корневой сертификат Litport
hub-us-7.litport.net · тёплыйЛокальная запись найденаБЕСПЛАТНЫЙ HIT
hub-eu-1.litport.net · холодныйЛокальной записи пока нетПЛАТНЫЙ MISS
Один и тот же запрос с включённым кешем тёплый на hub-us-7.litport.net и холодный на hub-eu-1.litport.net, пока на этом хабе нет собственной записи.

Сколько вы сэкономили#

«Статистика трафика» может группировать использование по дням, часам или месяцам. Для каждого продукта показываются бесплатные кешированные байты; для трафика с оплатой за ГБ дополнительно показана экономия в долларах. Интеграции могут получать те же данные об использовании через API токенов.

У суффикса кеша нет надбавки или множителя. Промахи и обходы кеша оплачиваются по обычной цене выбранного продукта прокси или пула; бесплатны только байты ответов, отданных из кеша при попадании.

Какие запросы подходят для кеша#

Пароль выбирает кеш → вход по HTTP-прокси → целевой сайт работает по HTTPS → метод GET → путь заканчивается выбранным статическим типом → в запросе нет признаков приватных данных или частичного содержимого → ответ 200 и допускает кеширование. Если какой-то шаг не пройден, запрос становится обычным оплачиваемым запросом через прокси; он не завершается ошибкой только из-за того, что его нельзя кешировать.

Поддерживаемые группы:

  • Изображения: PNG, JPEG, GIF, SVG, ICO и WebP
  • Скрипты: JavaScript, CSS, WebAssembly и source maps
  • Шрифты: WOFF, WOFF2, TTF, EOT и OTF

Идентификатор записи кеша — полный URL, включая точную строку запроса. Ответы с cookie, авторизацией, диапазонами байтов, неподдерживаемым Vary или директивами запроса no-cache всегда обходят кеш.

Почему только HTTPS?#

HTTPS-цель Litport проверяет сертификат и имя хоста исходного сервера. Ответ с гарантией целостности · можно сохранять
Цель по обычному HTTP На этом сетевом участке нет подтверждённой личности исходного сервера. Обычный прокси · тарифицируется как обычно · не сохраняется
HTTPS даёт Litport независимо аутентифицированный участок до исходного сервера, прежде чем общий ответ будет сохранён. Обычный HTTP не может обеспечить такую гарантию целостности.

Litport продолжает проксировать обычные адреса http:// в штатном режиме. Они не кешируются, потому что непроверенный ответ могут изменить между хабом и исходным сервером; его сохранение превратило бы одно сетевое перехватывание в отравление общего кеша. Установка корневого сертификата Litport или отключение проверки сертификатов не делает цель с обычным HTTP подходящей для кеша.

Безопасные значения по умолчанию#

Срок хранения в кеше по умолчанию — 120 минут; он ограничивается значением s-maxage или max-age исходного сервера, если оно короче. _cacheignoreheader-1 позволяет сохранить ответ, даже если исходный сервер пометил его как private, no-cache или no-store; запрошенный срок отсчитывается с момента, когда Litport сохраняет ответ целиком. Используйте это переопределение только для публичных статических ресурсов без аутентификации. Записи общие для клиентов Litport на одном хабе, поэтому игнорировать инструкции исходного сервера о приватности для персонализированного содержимого небезопасно.

Перейдите к настройке сертификата или откройте полный справочник по кешу.