Протокол и журналирование

Таблица. Параметры секции icap

ПараметрЗначенияНазначение и особенности

alwaysOk.enabled

true / false; false в поставке

Заменяет часть протокольных ошибок ответом 204. При отсутствии объекта, ключа или логического значения режим включён — задавайте явно.

allow204.enabled

true / false; true

Разрешает 204 No Content, если клиент также отправил Allow: 204. Уменьшает объём обратной передачи.

preview.enabled

true / false; false

Разрешает предварительную передачу части тела.

preview.size

Байты; 4096

Размер preview-блока при включённом preview.

rawLog.enabled

true / false; false

Сохраняет сырые ICAP-заголовки и тела; существенно увеличивает дисковую нагрузку.

rawLog.path

./log/icap-dump/

Каталог сырых дампов.

requestLog.enabled

true / false; false

Журнал метаданных ICAP-запросов.

requestLog.httpEnabled

true в поставке; false без файла

Включение HTTP-метаданных в журнал.

requestLog.channel

icap-request в поставке

Канал должен быть согласован с ipc.json и watcher.json.

xHeaders[]

Массив поставки

Не управляет фактическим извлечением заголовков: состав фиксирован. Изменение enabled в массиве не отключает их обработку.

Режим alwaysOk заменяет ошибки 400, отдельные случаи 413, 500, 501 и 505 ответом 204, но не отменяет все ограничения. Он не заменяет 403 при превышении числа соединений, 413 при превышении max_request_size и 507 при ошибке чтения временного ответа. Выбирайте его вместе с политикой отказов прокси, а ошибки контролируйте в журнале.

Для привязки событий к пользователю и узлу настройте передачу прокси заголовков идентификации, например X-Client-IP, X-Authenticated-User и X-Client-Username. Наличие имени пользователя зависит от данных прокси. Не подменяйте этими заголовками проверку того, какой источник допущен к ICAP-серверу.

  1. Проверьте синтаксис icap.json.

  2. Выполните reload sensor-icap.

  3. Убедитесь, что endpoint отвечает на OPTIONS и в icap.log нет ошибки чтения.

  4. Выполните контрольный запрос через прокси, проверьте событие и время ответа.

  5. Если включалась отладочная запись, отключите её после диагностики и обработайте накопленные файлы по политике хранения.