Параметры кеша и устранение неполадок

Параметры кеша задаются завершающей последовательностью в пароле прокси. Параметры логина, такие как пул, страна, город и сессия, не меняются. Суффикс сам по себе полностью включает режим: Litport не включает кеширование для токена неявно, а запрос без суффикса остаётся обычным запросом через прокси.

PASSWORD_cache-<types>[_cacheduration-<minutes>][_cacheignoreheader-1]

Примеры:

username:password_cache-images,fonts
username_country-us_sid-crawl-42:password_cache-all_cacheduration-30
username:password_cache-scripts_cacheduration-60_cacheignoreheader-1

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

Параметры#

Расширения: png,jpg,jpeg,gif,svg,ico,webp, js,css,wasm,map и woff,woff2,ttf,eot,otf. Пустой список или неподдерживаемое значение оставляет запрос некешируемым, не нарушая аутентификацию на прокси.

Результат запроса#

Подходящий HTTPS GET?Выбранный тип файла, безопасный запрос, режим кеша включён

ПопаданиеОтдаётся локальное телоКешированные байты бесплатны

ПромахЗапрос к проверенному исходному серверуОбычная тарификация; сохраняется, если можно кешировать

ОбходНебезопасно или не кешируетсяОбычный прокси и тарификация

• Попадание: байты тела ответа, отданные из записи на хабе, бесплатны. Обрыв соединения клиентом или ошибка чтения из кеша остаются видимыми в статусе доставки и никогда не переходят в тарифицируемый трафик.
• Промах: Litport использует обычный путь через апстрим. Байты запроса и ответа оплачиваются как обычно. Корректный полный ответ может быть сохранён для другого запроса.
• Обход кеша: Litport отправляет запрос в апстрим, не используя и не сохраняя запись кеша. Трафик оплачивается как обычно.

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

Допустимость и безусловные исключения#

Litport сохраняет только HTTPS-ответы на GET со статусом 200 и путём, заканчивающимся выбранным расширением. Объект определяется точным URL, включая порядок и кодирование параметров запроса. В стандартном режиме s-maxage приоритетнее max-age; побеждает меньшее из корректного срока свежести исходного сервера и запрошенной длительности. Запрошенная длительность — жёсткий максимум: если у ответа исходного сервера в стандартном режиме скорректированный Age уже равен ей или больше, Litport не сохраняет этот ответ. С _cacheignoreheader-1 запрошенный TTL отсчитывается с момента, когда Litport получает и сохраняет ответ целиком, без вычитания Date или Age исходного сервера.

Эти запросы всегда обходят кеш, даже с _cacheignoreheader-1:

• Authorization, Cookie, Range или условные заголовки запроса
• Cache-Control: no-cache, no-store или max-age=0 либо Pragma: no-cache в запросе
• Set-Cookie, неподдерживаемый Vary, частичное содержимое, слишком большие ответы или неполные тела
• сервис-воркеры, URL без расширения, API, документы, видео, аудио и архивы
• цели с обычным http://, вход по SOCKS5, UDP и HTTP/3/QUIC

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

Поведение протоколов#

Для HTTPS-запросов в режиме кеша поддерживаются клиенты HTTP/1.1 и HTTP/2. Litport также может согласовать HTTP/2 на проверенном участке до исходного сервера. HTTP/3 использует QUIC поверх UDP, а явный путь HTTP-прокси Litport — это TCP CONNECT; поэтому QUIC-запрос не попадает в этот путь кеширования. Приложения часто переключаются на HTTP/2, но Litport не заявляет о кешировании HTTP/3.

Эндпоинт прокси Litport можно записывать как http://HUB:PORT. Допустимость определяется URL целевого сайта, который должен быть https://....

Устранение неполадок#

Для целевых сайтов, чувствительных к транспортному уровню, прочитайте Кеш и транспортные отпечатки.