iT-Ti.ruочерки сисадмина

Очерки сисадмина Linux и сети

Squid: ошибка URL-rewrite produces invalid request

Опубликовано: Обновлено: 4 мин чтенияАвтор: Редакция iT-Ti.ru

Ошибка URL-rewrite produces invalid request появляется, когда Squid получает от редиректора ответ, который не может разобрать как корректный адрес. Разберём причины, формат протокола хелпера и проверку версии.

Сообщение ERROR: URL-rewrite produces invalid request попадает в cache.log, когда Squid не смог превратить ответ внешнего редиректора в корректный запрос. Редиректор — это программа из директивы url_rewrite_program: SquidGuard, ufdbGuard, свой скрипт на Perl, Python или Bash. Squid передаёт ей данные запроса, а она отвечает, как поступить.

Основная причина: несоответствие версии и формата

В версиях Squid до 3.4 редиректоры общались по упрощённому протоколу: на вход приходила строка с URL и дополнительными полями, в ответ — новый URL или пустая строка. В Squid 3.4 формат обмена с хелперами был существенно расширен: ответы получили ключевое слово и пары «ключ=значение», в том числе кодом статуса и целевым адресом. Старые хелперы и более ранние сборки реализуют разные варианты протокола, и при несоответствии Squid получает строку, которую не может превратить в адрес.

Если вы всё ещё работаете на очень старой версии, первое, что стоит сделать, — обновиться до актуальной ветки. В 2026 году разумно ориентироваться на Squid 6 (в репозиториях Debian 12–13 и Ubuntu 24.04 версии определяются самим дистрибутивом). Учтите, что при смене версий конфигурации заметно отличаются: часть директив переименована или удалена, поэтому после обновления проверьте файл командой squid -k parse.

Формат ответа хелпера

Для современных версий допустимы такие ответы:

Ответ хелпера Значение
OK Принять запрос без изменений
ERR Нет решения, запрос не меняется
OK rewrite-url="http://new.example/path" Прозрачно подменить адрес запроса
OK status=302 url="http://block.example/denied" Отправить клиенту перенаправление (код 301, 302, 303, 307, 308)

Следите за деталями: адрес должен быть полным, с http:// или https://, без пробелов внутри и без управляющих символов. Любая лишняя строка в стандартном выводе хелпера (отладочные сообщения, предупреждения интерпретатора) воспринимается Squid как ответ и ломает протокол. Отладочный вывод всегда пишите в stderr или в файл.

Если включено url_rewrite_children ... concurrency=N, каждый запрос и ответ начинаются с номера канала, и этот номер хелпер обязан вернуть первым словом в ответе. Забытый номер канала — ещё одна частая причина странных сбоев.

Пример простого хелпера

Минимальный хелпер на Python для проверки (без параллелизма):

#!/usr/bin/env python3
import sys

for line in sys.stdin:
    parts = line.split()
    url = parts[0] if parts else ""
    if "blocked.example" in url:
        print('OK status=302 url="http://proxy.local/denied.html"')
    else:
        print("ERR")
    sys.stdout.flush()

Подключение в squid.conf:

url_rewrite_program /usr/local/bin/rewrite.py
url_rewrite_children 5 startup=1 idle=1
url_rewrite_access allow all

Обязательный flush после каждого ответа: без него Squid будет ждать, пока заполнится буфер вывода хелпера.

Диагностика по шагам

  1. Узнайте версию и параметры сборки:

    squid -v
    
  2. Запустите хелпер вручную и подайте тестовую строку, чтобы увидеть реальный ответ. Строка запроса состоит из URL, адреса клиента с именем, идентификатора пользователя и метода:

    echo "http://blocked.example/ 192.168.1.10/- - GET" | /usr/local/bin/rewrite.py
    
  3. Проверьте cache.log и access.log: по записям видно, на каком запросе возникла ошибка и какой адрес вернул хелпер.

  4. Если хелпер — готовый пакет вроде SquidGuard, выясните, какой формат ответа он выдаёт, и поддерживает ли его ваша версия Squid. При несовместимости самый надёжный путь — перейти на актуальный фильтр. О причинах и вариантах замены написано в статье про SquidGuard и редирект.

  5. Если Squid собран вручную, а не поставлен из репозитория, не забывайте, что нужные опции сборки (например, SSL) требуют заголовков OpenSSL, см. разбор ошибки library 'crypto' is required for OpenSSL.

Обновление Squid

В Debian и Ubuntu достаточно штатного обновления пакета, но перед этим сохраните конфигурацию и сверьте её с примером из новой версии:

sudo cp -a /etc/squid /etc/squid.bak
sudo apt update && sudo apt install --only-upgrade squid
sudo squid -k parse

Если дистрибутив поставляет слишком старую версию, можно пересобрать пакет из исходников более нового выпуска или поставить прокси в контейнере с актуальной версией. Описание протокола хелперов и всех директив — в документации Squid. Для установки и настройки прокси с веб-интерфейсом учёта пригодится статья про Squid и SAMS2.

Чем отличается подмена от редиректа

Это два разных поведения, и путать их не стоит. При подмене (rewrite-url) клиент ничего не замечает: Squid сам запрашивает другой адрес и отдаёт содержимое под исходным. При редиректе (status=302 url=) клиенту возвращается ответ с заголовком Location, и браузер переходит на новый адрес сам. Для страницы блокировки нужен именно редирект: пользователь должен увидеть понятное сообщение, а не чужое содержимое под знакомым адресом. Для HTTPS-запросов без расшифровки подмена URL невозможна вовсе, так как Squid видит только имя узла в запросе CONNECT.

Частые вопросы

Что значит ERROR: URL-rewrite produces invalid request в Squid?

Squid получил от хелпера (url_rewrite_program) строку, из которой не удалось построить корректный URL запроса. Обычно хелпер отвечает в формате, который не соответствует версии Squid, или возвращает адрес без схемы либо с лишними символами.

Как должен отвечать url_rewrite_program в современном Squid?

Ответ начинается с кода: OK означает успех, ERR — оставить запрос без изменений. Успешный ответ с изменением выглядит так: OK rewrite-url=«адрес» для подмены адреса и OK status=302 url=«адрес» для перенаправления клиента.

Как проверить версию Squid?

Выполните squid -v. В выводе первой строкой будет номер версии и параметры сборки. Хелперы в новом формате поддерживаются начиная с ветки 3.4, а в Squid 6 старые схемы лучше не использовать.