URL прокси и percent-encoding: как не сломать специальные символы
Полный URL прокси удобен для импорта, но его части имеют строгие границы. Двоеточие, знак @, квадратные скобки и знак процента могут быть разделителями либо данными. Если склеить поля без кодирования, программа разберёт строку иначе, чем ожидал пользователь.
Главное за минуту
- Схема определяет протокол общения с прокси.
- Authority может включать userinfo, host и port.
- Зарезервированные символы в данных требуют percent-encoding.
- Один и тот же фрагмент нельзя кодировать или декодировать дважды.
Компоненты URI
URI начинается со схемы, после которой authority обычно содержит адрес и порт. Userinfo, если клиент его допускает, располагается перед @. Парсер сначала разделяет компоненты, и только затем безопасно декодирует данные внутри них.
Reserved и unreserved символы
Буквы, цифры и небольшой набор незарезервированных символов можно передавать напрямую. Разделители вроде @, двоеточия и процента имеют специальный смысл. Когда они являются частью логина или пароля, модуль экспорта преобразует соответствующие байты в percent-encoded форму.
Ошибка двойного кодирования
После кодирования знак процента уже участвует в последовательности. Повторная обработка превращает его в %25 и меняет исходное значение. Система должна хранить реквизит в исходном виде, а кодированную строку создавать только на границе экспорта.
Совместимость клиентов
Chromium и cURL принимают адрес прокси в определённых URI-формах, но поддержка встроенных реквизитов различается. Chrome понимает схему, адрес и порт, однако игнорирует логин и пароль, встроенные в ручную настройку прокси. Поэтому показывайте пример для выбранной программы и предлагайте вариант без userinfo, когда реквизиты вводятся отдельно.
Практический чек-лист
- 1Указать явную схему http или socks5.
- 2Кодировать только данные внутри компонента.
- 3Не применять percent-encoding дважды.
- 4Проверить IPv6-скобки и порт.
- 5Сверить формат с документацией программы.
Источники и документы
Материал подготовлен по первичным, официальным и техническим источникам. Формулировки статьи являются самостоятельным изложением.