Squid: ошибка URL-rewrite produces invalid request
Ошибка 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 будет ждать, пока заполнится буфер вывода хелпера.
Диагностика по шагам
-
Узнайте версию и параметры сборки:
squid -v -
Запустите хелпер вручную и подайте тестовую строку, чтобы увидеть реальный ответ. Строка запроса состоит из URL, адреса клиента с именем, идентификатора пользователя и метода:
echo "http://blocked.example/ 192.168.1.10/- - GET" | /usr/local/bin/rewrite.py -
Проверьте
cache.logиaccess.log: по записям видно, на каком запросе возникла ошибка и какой адрес вернул хелпер. -
Если хелпер — готовый пакет вроде SquidGuard, выясните, какой формат ответа он выдаёт, и поддерживает ли его ваша версия Squid. При несовместимости самый надёжный путь — перейти на актуальный фильтр. О причинах и вариантах замены написано в статье про SquidGuard и редирект.
-
Если 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 старые схемы лучше не использовать.