Настройка pip через прокси: пошаговое руководство

Быстрая настройка pip через прокси

Прокси нужен, если доступ к PyPI в вашей сети проходит через отдельный сервер. Он сам по себе не ускоряет установку и не устраняет ошибки версии пакета.

Проверьте выбранный интерпретатор:

python -m pip --version

Далее используется python; при необходимости замените его на python3 в Linux/macOS или py в Windows. В проекте с виртуальным окружением запускайте его интерпретатор.

Для разовой загрузки пакета через учебный HTTP-прокси:

python -m pip download --no-deps --no-cache-dir --dest pip-check --proxy "http://proxy.example:8080" requests

proxy.example и порт 8080 здесь условные. Замените их данными своего сервера. download сохраняет пакет в каталог pip-check без установки, а --no-cache-dir помогает проверить реальную загрузку. Успех команды подтверждает доступ к репозиторию при этих настройках, но не является отдельной проверкой выходного IP.

Если нужен прокси для разработки, выберите HTTP-прокси ProxyWing и используйте параметры выданного подключения. Перед заказом проверьте протокол и способ авторизации для вашей среды.

Способ 1. Параметр –proxy для одной команды

Передайте адрес прокси в вызове pip. Для установки пакета:

python -m pip install --proxy "http://proxy.example:8080" requests

Формат адреса с авторизацией: scheme://user:password@host:port. Замените учебные значения параметрами подключения. Если пароль содержит @, :, / или другие служебные символы URL, закодируйте их в части учётных данных. Например, @ превращается в %40.

Имя схемы описывает соединение с прокси. При доступе к HTTPS-сайту через обычный HTTP-прокси адрес прокси часто всё равно начинается с http://: HTTPS до сайта проходит внутри туннеля CONNECT. Схему https:// используйте, когда провайдер действительно поддерживает TLS к самому прокси.

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

Способ 2. Файл pip.ini или pip.conf

Сначала посмотрите, какие файлы читает именно ваш pip:

python -m pip config debug

Команда перечисляет конфигурацию и переменные. Вывод может содержать секреты, поэтому перед отправкой в поддержку скройте учётные данные.

Где находится пользовательский конфиг

Система	Пользовательский файл
Windows	%APPDATA%\pip\pip.ini
Linux	$HOME/.config/pip/pip.conf, с учётом XDG_CONFIG_HOME
macOS	$HOME/Library/Application Support/pip/pip.conf, если этот каталог существует; иначе $HOME/.config/pip/pip.conf

Существуют и другие уровни конфигурации. Полагайтесь на pip config debug, когда путь на вашей машине отличается.

Для записи пользовательской настройки без ручного создания файла:

python -m pip config --user set global.proxy "http://proxy.example:8080"

В файле это соответствует:

[global]
proxy = http://proxy.example:8080

global здесь обозначает раздел настроек pip, а --user выбирает пользовательский уровень файла. Опция --global имеет другое назначение: она записывает настройку в системный файл.

Для удаления записанного значения:

python -m pip config --user unset global.proxy

После удаления проверьте переменные окружения: они могут продолжать задавать другой прокси.

Способ 3. Переменные окружения

Для настройки самого pip можно использовать PIP_PROXY. Пример на текущую сессию PowerShell:

$env:PIP_PROXY = "http://proxy.example:8080"
python -m pip download --no-deps --no-cache-dir --dest pip-check requests

В Linux и macOS для текущего терминала:

export PIP_PROXY="http://proxy.example:8080"
python -m pip download --no-deps --no-cache-dir --dest pip-check requests

Сам pip также учитывает стандартные HTTP_PROXY, HTTPS_PROXY и исключения NO_PROXY. Эти переменные могут влиять на другие программы. Чтобы проще отследить источник настройки, сначала выберите один способ и проверьте его без нескольких одновременно заданных значений.

Для удаления PIP_PROXY в текущем PowerShell:

Remove-Item Env:PIP_PROXY -ErrorAction SilentlyContinue

В оболочке Linux/macOS:

unset PIP_PROXY

Для такой временной настройки права администратора не нужны. Команды удаления выше меняют только среду текущего терминала. Если значение ранее записано постоянно в профиль пользователя или настройку системы, удалите его и в этом источнике.

Как проверить, какие настройки применяются

1. Выполните python -m pip --version и убедитесь, что это нужное окружение.
2. Выполните python -m pip config debug и посмотрите используемые файлы и переменные.
3. Выполните python -m pip config list -v, чтобы проверить значения конфигурации. Скройте секреты перед копированием вывода.
4. Загрузите небольшой пакет с pip download, используя новый пустой каталог и --no-cache-dir. При повторе поменяйте --dest pip-check на --dest pip-check-2: прежний файл иначе может использоваться повторно.
5. Сопоставьте результат с журналом или статистикой прокси, если они доступны. Один успешный доступ к PyPI не доказывает, что остальные приложения используют тот же маршрут.

Параметр командной строки имеет приоритет над соответствующей переменной pip, а та над значением файла. Общие HTTP_PROXY/HTTPS_PROXY обрабатываются сетевым уровнем отдельно. При неожиданном маршруте проверьте все источники и исключения NO_PROXY.

PIP_CONFIG_FILE позволяет выбрать дополнительный конфигурационный файл. Он имеет отдельные правила загрузки и может менять использование пользовательского конфига. Не удаляйте его наугад в корпоративной среде: сначала проверьте назначение файла.

pip через прокси в виртуальном окружении

Виртуальное окружение изолирует пакеты Python. Настройки сети и переменные процесса могут продолжать поступать из окружения терминала.

После активации среды проверьте путь через python -m pip --version. Чтобы сохранить правило на уровне активного виртуального окружения:

python -m pip config --site set global.proxy "http://proxy.example:8080"

Для удаления:

python -m pip config --site unset global.proxy

Пользовательский и системный файлы читаются раньше конфигурации окружения. Переменные и параметры командной строки могут переопределить её. Для диагностики используйте pip config debug; не редактируйте скрипт активации только ради одной проверки.

Ошибки 407, SSL, таймаут и отказ в доступе

Сообщение	Что проверить
407 Proxy Authentication Required	Логин, пароль, способ авторизации и привязку к разрешённому IP
ProxyError, отказ в соединении	Адрес, порт, протокол, доступность сервера и правила сети
ReadTimeout или повторные попытки	Доступ к PyPI, ограничения сети, задержку сервера; сравните с прямым доступом, если он разрешён
CERTIFICATE_VERIFY_FAILED	Доверенную цепочку сертификатов и требования корпоративной сети
403 от репозитория	Источник ответа, разрешения и политику доступа; смена IP не гарантирует решение

При корпоративной TLS-инспекции получите доверенный CA-сертификат у администратора. Для отдельной проверки можно явно задать доверенный PEM-файл:

python -m pip download --cert company-ca.pem --no-cache-dir --no-deps --dest pip-check requests

Здесь company-ca.pem обозначает путь к проверенному набору сертификатов вашей организации. Опция --cert и переменная PIP_CERT задают файл для pip. Не скачивайте сертификат из случайного источника и не используйте --trusted-host как обычное исправление SSL: ослабление проверки скрывает причину ошибки.

Для каждой проверки используйте новый пустой каталог назначения, например --dest pip-check-2, затем --dest pip-check-3. Уже скачанный файл в прежнем каталоге может использоваться повторно даже при --no-cache-dir. Эта опция отключает кэш pip, но не очищает папку назначения. Сопоставьте запрос со статистикой сервера. При ограничениях репозитория соблюдайте его правила; автоматическая ротация IP не является универсальным решением.

Что выбрать для своей задачи

Для одного запуска подойдёт --proxy. Для постоянной настройки пользователя используйте pip config --user, для активного виртуального окружения pip config --site. Переменная PIP_PROXY подходит для временной сессии или настроенной среды CI.

После проверки удалите учебные и временные значения. Для сетевых запросов самой программы настройки pip не применяются автоматически: настройте прокси в Python Requests отдельно. Если ошибка возникает уже при выполнении HTTP-запроса, проверьте таймауты Requests.