Missing dependencies for SOCKS support: как исправить

Что означает ошибка

Полный текст: requests.exceptions.InvalidSchema: Missing dependencies for SOCKS support. В исходном коде requests это исключение возникает, когда не удалось импортировать модуль SOCKS из urllib3, а тот, в свою очередь, требует пакет PySocks. Сам requests устанавливается без него, потому что поддержка SOCKS по документации необязательна.

Ошибка появляется не при импорте, а в момент первого запроса через прокси со схемой socks5://, socks5h:// или socks4://. Поэтому код с HTTP-прокси работает, а после замены строки на SOCKS вдруг падает. Ни до прокси, ни до сайта запрос при этом не доходит, так что трафик не тратится.

После установки зависимостей важно выбрать схему. По документации requests со схемой socks5 имя сайта превращает в IP ваш компьютер, а со схемой socks5h это делает прокси. Для резидентских прокси обычно нужен socks5h: тогда DNS-запрос идёт из той же страны, что и IP.

Причины

• Не установлен PySocks. Пакет requests[socks] или PySocks не устанавливали, и urllib3 не может подключить модуль SOCKS.
• Пакет стоит в другом окружении. pip установил PySocks для другого Python или другого виртуального окружения, чем то, в котором запускается скрипт.
• Оболочка zsh съела квадратные скобки. Команда pip install requests[socks] без кавычек в zsh завершается ошибкой no matches found, и ничего не устанавливается.
• Сборка без дополнительных пакетов. Docker-образ, сервер или сборка приложения ставит только requests из requirements.txt, где нет PySocks.

Как исправить

1. Установите зависимости тем же интерпретатором, которым запускаете скрипт: python -m pip install 'requests[socks]'. Кавычки нужны для zsh.
2. Проверьте, что пакет на месте: python -c "import socks; print(socks.__file__)". Если импорт не удаётся, вы установили его в другое окружение.
3. Добавьте requests[socks] в requirements.txt или pyproject.toml, чтобы зависимость ставилась и на сервере, и в Docker.
4. Задайте прокси со схемой socks5h для обоих ключей: proxies={'http': 'socks5h://ЛОГИН:ПАРОЛЬ@gw.prokso.com:824', 'https': 'socks5h://ЛОГИН:ПАРОЛЬ@gw.prokso.com:824'}. Для фиксированного IP вместо 824 укажите порт из диапазона 10000–20000.
5. Если после установки приходит ConnectionError с текстом SOCKS5 authentication failed, прокси не принял логин или пароль: скопируйте строку из личного кабинета заново. Пример полного кода есть в инструкции Python requests.

Как проверить, что всё заработало

Выполните requests.get('https://prokso.com/ip', proxies=proxies, timeout=30).json(). Если в ответе IP, страна и ASN прокси, SOCKS работает. Затем откройте Мой IP без прокси и сравните: адреса должны отличаться.

Диагностика за 2 минуты

Сначала вставьте строку в проверку прокси. Если там прокси работает, причина в программе или её настройках. Если нет — проверьте строку из терминала:

curl -v -x "http://ЛОГИН:ПАРОЛЬ@gw.prokso.com:823" https://api.ipify.org

• Строка < HTTP/1.1 407 сразу после CONNECT — отвечает прокси. Название после кода, например NO_USER, подсказывает причину.
• Прокси ответил на CONNECT кодом 200, а дальше пришёл другой код — прокси работает, этот ответ дал сайт.
• Никакого ответа, только тайм-аут — соединение не дошло до прокси: проверьте хост, порт и сеть.

Инструкции, где встречается эта ошибка

• Настройка прокси в Python requests
• Настройка прокси в Scrapy
• Прокси в aiohttp: HTTP, HTTPS и SOCKS5
• Настройка прокси в httpx