Como Usar o pip com Proxies

Neste artigo, você aprenderá a configurar e usar proxies com pip para um gerenciamento de pacotes sem interrupções em redes restritas.

Diferenças Entre Proxies Públicos e Privados

Ao selecionar um proxy, determinar se ele será público ou privado é uma consideração importante.

Proxies Públicos

Os proxies públicos são abertos para qualquer pessoa usar e muitas vezes não possuem autenticação. Embora possam fornecer acesso rápido a um endereço IP, eles têm desvantagens—velocidades mais lentas, conexões instáveis e possíveis banimentos de IP. Por serem gratuitos e amplamente disponíveis, muitas vezes carecem de recursos essenciais como rotação de proxies, cache e controle de acesso, tornando-os pouco confiáveis em um ambiente de produção.

Uma URL pública pode ser formatada assim: https://proxyserver:port.

Proxies Privados

Proxies privados exigem autenticação, oferecendo maior segurança, estabilidade e recursos avançados—embora normalmente com um custo. Eles oferecem uma conexão segura, rápida e confiável a um endereço IP dedicado, junto com recursos como autenticação e rotação de proxy.

O acesso geralmente é controlado por meio de autenticação, muitas vezes incluindo um nome de usuário e senha como prefixo na URL do proxy, assim: https://username:password@proxyserver:port.

Usando Proxies com pip

Para começar a usar um proxy com pip, você precisa reunir alguns detalhes sobre seu proxy. O próximo exemplo usa um proxy público com os seguintes detalhes:

• Um endereço de proxy para o serviço de proxy
• A porta que o serviço de proxy requer para comunicação

O seguinte repositório proxy-list fornece endereços de proxy públicos testados diariamente que podem ser úteis para testes, mas não devem ser usados em ambientes de produção.

Dentro do repositório proxy-list, verifique o arquivo proxy-list-status.txt para encontrar um proxy público funcional. Isso pode ser feito verificando o arquivo em busca de um endereço com a marcação success ao lado, indicando que está funcionando:

Para este tutorial, use 45.185.162.203:999 como seu endereço de proxy público. Isso significa que o endereço do servidor proxy é http://45.185.162.203:999.

Configurando um Proxy pip com a Linha de Comando

A maneira mais rápida de configurar um proxy pip é passar o endereço ao chamar o comando pip install usando a opção de linha de comando --proxy.

Usando o endereço de proxy público, teste seu acesso ao proxy e aos pacotes usando o seguinte comando:

  # Public Proxy
pip install boto3 --proxy http://45.185.162.203:999

Este método é útil para testar e validar rapidamente proxies antes de configurar permanentemente um novo proxy. Se estiver publicando pacotes pip, ajuda a verificar a disponibilidade a partir de um IP diferente.

Configurando um Proxy pip com o Arquivo de Configuração pip

Para configurar permanentemente um proxy pip, o arquivo de configuração do pip é uma solução fácil e declarativa. Sua localização depende do seu sistema operacional e pode ser encontrada nos seguintes diretórios:

• Global: Arquivo de configuração de todo o sistema, compartilhado entre usuários.
• Usuário: Arquivo de configuração por usuário para o usuário que executa o processo pip.
• Site: Arquivo de configuração por ambiente usando ambientes virtuais Python.

Esses arquivos de configuração podem ser encontrados ou criados nos seguintes locais para cada sistema:

Linux/macOS

Em sistemas baseados em Linux, o arquivo de configuração do pip é chamado pip.conf e pode ser encontrado nos seguintes locais:

• Global:
  • Sistemas baseados em Debian: Edite ou crie pip.conf no/etc` diretório.
  • Sistemas baseados em macOS: Edite ou crie /Library/Application Support/pip/pip.conf.
• Usuário:
  • Sistemas baseados em Debian: Edite ou crie o arquivo ~/pip/pip.conf.
  • Sistemas baseados em macOS: Edite ou crie o arquivo de configuração ~/.config/pip/pip.conf.
• Site: Quando carregado em um ambiente virtual Python, está localizado em $VIRTUAL_ENV/pip.conf.

Windows

Em um sistema Windows, o arquivo é um pip.ini e pode ser encontrado nos seguintes locais:

• Global: Edite ou crie o arquivo C:ProgramDatapippip.ini. Observe que este arquivo é oculto por padrão em sistemas Windows, mas pode ser editado.
• Usuário: Edite ou crie pip.ini em %APPDATA%pip.
• Site: Quando carregado em um ambiente virtual Python, edite ou crie o arquivo de configuração em %VIRTUAL_ENV%pip.ini.

Observação: Em vez de verificar uma lista de locais conhecidos, você pode pedir ao pip que liste os locais válidos:

  pip config -v list

Conteúdo do Arquivo de Configuração

Para este exemplo, é usado um arquivo de configuração pip de ambiente virtual Python. Em um ambiente virtual ativado, edite $VIRTUAL_ENV/pip.conf em sistemas baseados em Debian ou %VIRTUAL_ENV%pip.ini no Windows.

No arquivo de configuração, você precisa atualizar a chave proxy com o proxy HTTP ou HTTPS desejado:

  [global]
proxy = http://45.185.162.203:999

Uma vez que o arquivo é salvo, o proxy é usado automaticamente com qualquer comando pip, eliminando a necessidade da flag de proxy mencionada anteriormente:

  (venv) $ pip install boto3

Você pode encontrar mais detalhes sobre as opções de configuração disponíveis no arquivo de configuração pip na documentação do projeto.

Configurando um Proxy pip com Variáveis de Ambiente

Definir variáveis de ambiente do sistema garante que um proxy seja usado para o pip e todas as outras solicitações HTTP em um sistema. Isso é feito utilizando as variáveis de ambiente HTTP_PROXY e HTTPS_PROXY, que frequentemente são referenciadas por softwares como o pip como um proxy do sistema a ser usado ao fazer solicitações HTTP.

Linux/macOS

Se você estiver usando um sistema operacional Linux, atualize o arquivo /etc/environment, ou se você for um usuário macOS, atualize o arquivo .zshrc localizado no diretório home. Em seguida, atualize-o com novas entradas para seu servidor proxy:

  HTTP_PROXY=https://proxyserver:port
HTTPS_PROXY=https://proxyserver:port

Assim que você reiniciar suas sessões de terminal ou reiniciar seu sistema, as variáveis de ambiente estarão presentes.

Windows

Em um sistema Windows, você pode definir variáveis de ambiente com os seguintes comandos em um terminal de prompt de comando:

  $env:HTTP_PROXY "https://proxyserver:port" /M
$env:HTTPS_PROXY "https://proxyserver:port" /M

Reinicie o prompt de comando para que as alterações tenham efeito.

Testando a Configuração

Uma vez que você tenha uma configuração em nível de sistema habilitada por meio do arquivo de configuração pip ou variáveis de ambiente, você deve testar se o proxy pode se conectar com sucesso e receber dados por meio do proxy.

Linux/macOS

No Linux/macOS, use o seguinte comando:

  $ python -m venv venv
$ source venve/scripts/activate

# for pip config file or environment variables
(venv) $ pip install requests

Se você quiser substituir essas configurações com um proxy específico, pode recorrer ao uso das flags da CLI:

  # pip cli flag
(venv) $ pip install requests --proxy https://proxyserver:port

Neste comando, certifique-se de atualizar https://proxyserver:port com seu próprio proxy.

Windows

No Windows, use o seguinte comando:

  > python -m venv venv
> .venvScriptsActivate.bat
(venv) > pip install requests

Essas configurações sempre podem ser substituídas usando as flags da CLI do pip:

  # pip cli flag
(venv) $ pip install requests --proxy https://proxyserver:port

Solução de Problemas com Proxies pip

Ao conectar-se a um proxy HTTP ou HTTPS com pip, você pode encontrar os seguintes problemas comuns, especialmente se explorar o uso de proxies privados ou proxies HTTPS devido aos seus recursos aprimorados.

Problemas de Autenticação

Problemas de autenticação são comumente vistos como um erro 407 Proxy Authentication Required ao tentar se conectar ao proxy com pip. Isso indica que o proxy requer um nome de usuário e senha para se conectar ou que você forneceu as credenciais erradas para o proxy.

Problemas de Certificado

Ao conectar-se a um proxy HTTPS, você pode receber um erro Certificate verify failed do pip. Isso indica que há um problema com o certificado fornecido pelo servidor proxy.

Se o seu servidor proxy privado estiver usando um certificado autoassinado, você pode receber esse erro, e o certificado não pode ser verificado com uma autoridade certificadora. Você pode usar a opção de CLI --trusted-host ao se conectar a determinados domínios e ignorar erros de certificado autoassinado.

Usando pip com Proxies Rotativos

Proxies rotativos ajudam a evitar banimentos de IP ao alternar automaticamente os endereços IP para cada solicitação. Isso simula múltiplos usuários e contorna restrições.

Você pode implementar isso selecionando proxies aleatoriamente de uma lista. Abaixo está um script bash simples que instala pacotes pip enquanto alterna entre proxies públicos.

Crie o seguinte script bash chamado rotate-proxies.sh:

  proxy_list=(
  'http://45.185.162.203:999'
  'http://177.23.176.58:8080'
  'http://83.143.24.66:80'
)

pip_packages=(
  'requests'
  'numpy'
  'pandas'
)
chmod +x rotate-proxies.sh
# Loop through packages and install them
for package in "${pip_packages[@]}"
do
  # Randomly select a proxy from the list
  proxy=${proxy_list[$RANDOM % ${#proxy_list[@]}]}
  echo -e  "nInstalling $package with proxy $proxy"
  pip install --proxy $proxy $package
done

Uma vez criado, você pode executar o arquivo para baixar os pacotes pip e alternar entre um proxy aleatório para cada comando pip. Aqui está um resumo da saída do script:

  $ ./rotate-proxies.sh 

Installing requests with proxy http://177.23.176.58:8080
Collecting requests
  Downloading requests-2.32.3-py3-none-any.whl.metadata (4.6 kB)

….

Downloading urllib3-2.3.0-py3-none-any.whl (128 kB)
Installing collected packages: urllib3, idna, charset-normalizer, certifi, requests
Successfully installed certifi-2026.1.31 charset-normalizer-3.4.1 idna-3.10 requests-2.32.3 urllib3-2.3.0

Installing six with proxy http://45.185.162.203:999
Collecting numpy
 Downloading numpy-2.2.2-cp313-cp313-macosx_14_0_x86_64.whl.metadata (62 kB)

…

Installing collected packages: numpy
Successfully installed numpy-2.2.2

Installing pandas with proxy http://83.143.24.66:80
Collecting pandas
  Downloading pandas-2.2.3-cp313-cp313-macosx_10_13_x86_64.whl.metadata (89 kB)

….

Installing collected packages: pytz, tzdata, six, python-dateutil, pandas
Successfully installed pandas-2.2.3 python-dateutil-2.9.0.post0 pytz-2026.1 six-1.17.0 tzdata-2026.1

Benefícios de Usar Proxies com pip

Proxies ajudam os desenvolvedores a contornar restrições de rede, acessar recursos bloqueados e melhorar as velocidades de download de pacotes. Proxies privados oferecem cache, conexões mais rápidas e segurança aprimorada ao mascarar sua identidade.

Em comparação com uma VPN, os proxies são uma alternativa leve para solicitações pip. Embora uma VPN criptografe todo o tráfego de internet para uma privacidade mais ampla, isso pode tornar mais lentas as instalações de pacotes devido ao aumento de latência. Proxies fornecem uma solução mais rápida e eficiente para gerenciar dependências.

Erros Comuns e Melhores Práticas

Ao usar proxies com pip, é importante ficar atento a erros comuns, pois eles podem levar a vulnerabilidades de segurança. Erros como URLs de proxy incorretas ou formatos de URL mal configurados—como protocolo HTTP ou HTTPS ausente ou incorreto—podem interromper as conexões com os repositórios de pacotes.

Um problema de segurança frequente é codificar diretamente credenciais de proxy (por exemplo nomes de usuário e senhas) em códigos-fonte, scripts ou definições de pipeline de integração contínua e entrega contínua (CI/CD). Se esse código for redistribuído, pode ocorrer acesso não autorizado ao proxy. Se as credenciais forem comprometidas, o proxy pode ser utilizado indevidamente, levando a custos aumentados ou até mesmo sendo explorado por ciberataques.

Para evitar esses erros, recomenda-se manter as credenciais de proxy seguras armazenando-as em variáveis de ambiente ou arquivos de configuração criptografados, em vez de diretamente no código. Além disso, você deve testar a conectividade do proxy antes de usar o pip para garantir uma configuração adequada e evitar erros de tempo de execução. Usando ferramentas como curl ou ping, você pode verificar o desempenho do proxy antes de colocá-lo em serviço. Isso proporciona uma experiência de gerenciamento de pacotes mais tranquila.

Usando Proxies da Bright Data

Se você está procurando um provedor de proxies de alta qualidade e recursos avançados, confira a Bright Data. É uma solução de proxy que fornece uma variedade de endereços IP, incluindo residenciais, de datacenter e dispositivos móveis. Também fornece ferramentas especializadas para coleta de dados e scraping de dados, incluindo proxies rotativos e a API Web Unlocker.

A Bright Data pode ajudá-lo a criar facilmente proxies para as necessidades do seu projeto. Para mostrar como é fácil, vamos criar um proxy residencial privado que você pode usar com pip para acessar pacotes por meio de um endereço IP diferente.

Comece se cadastrando na Bright Data. Em seguida, navegue até o painel do usuário.

No menu lateral, clique em Proxies & Scraping:

Uma vez que o formulário for carregado, configure um novo proxy residencial. Se você usar as configurações padrão, obterá um proxy com um endereço IP compartilhado usado por múltiplos usuários da Bright Data:

Se você está visando uma região específica, também pode especificar o país no qual deseja que o endereço IP esteja localizado.

Após a criação, você é redirecionado para um painel que contém o endpoint e os detalhes de autenticação do seu proxy recém-criado. Anote o nome de usuário, a senha e o endereço do servidor:

Usando esses valores de endpoint, teste sua disponibilidade usando a flag --proxy:

  $ pip install pandas 
    --trusted-host pypi.org 
    --trusted-host files.pythonhosted.org 
    --proxy https://username:[email protected]:33335

Como o proxy da Bright Data usa um certificado autoassinado, você pode usar a flag trusted-host para colocar pypi.org e files.pythonhosted.org na lista branca como domínios confiáveis.

Conclusão

Usar um proxy com pip ajuda a aumentar o anonimato e o controle, permitindo que você contorne restrições de IP e bloqueios geográficos. Dependendo das suas necessidades, você pode escolher entre proxies públicos e privados.

Proxies privados oferecem vantagens, como rotação de IPs, cache aprimorado, velocidades mais rápidas e maior estabilidade, mas o custo depende da disponibilidade de IP e da localização geográfica.

Configurar um proxy para pip é simples, com múltiplas opções como flags de CLI, um arquivo de configuração pip e variáveis de ambiente. No entanto, os proxies públicos têm limitações e, como discutido anteriormente, não são ideais para grandes cargas de trabalho ou uso em produção. Para uma solução mais confiável, a Bright Data oferece IPs residenciais e de datacenter, fornecendo conexões rápidas e estáveis e ferramentas avançadas para scraping de dados e coleta de dados.