Alterar idioma
Português English Русский Deutsch Español Français Italiano Українська Tiếng Việt Türkçe Bahasa Indonesia हिन्दी 日本語 中文
Menu
Preços
Proxies
TIPOS DE PROXY
Soluções
Recursos

Como usar um proxy com o Python requests

Aponte o requests para um endereço ISP estático: um único IP na rede de um provedor de internet identificado, mantido pelo período que você pagar. O código abaixo foi executado contra um proxy autenticado antes de ser publicado.

Em resumo: Passe um dicionário proxies com as chaves http e https, cada uma definida como http://USERNAME:PASSWORD@HOST:PORT, e o requests envia a chamada pelo proxy; destinos HTTPS passam por ele como um túnel. Para SOCKS5, instale requests[socks], mude o proxy para SOCKS5 no seu pedido e use o esquema socks5h, para que o proxy, e não a sua máquina, resolva os nomes de host.

O Python requests obtém o proxy de um dicionário que associa o esquema da URL de destino a uma URL de proxy. Este guia define esse dicionário para um endereço ISP estático e mostra os três lugares onde ele pode ficar: em uma chamada, em uma sessão ou no ambiente.

Proxy no Python requests com usuário e senha

A maioria dos proxies, os nossos inclusive, pede usuário e senha. O requests os lê da URL do proxy e os envia ao proxy a cada conexão. Para um destino HTTPS, o proxy abre um túnel e nunca vê o conteúdo da requisição. As abas de código mostram a forma por requisição e a de sessão.

Configurar um proxy no Python requests

  1. Copie os quatro valores do seu pedido

    Host, porta, usuário e senha, em Meus Proxies no painel ou no pedido pela API. Cada endereço tem os seus próprios quatro; não existe um gateway compartilhado.

  2. Monte uma URL de proxy

    http://USERNAME:PASSWORD@HOST:PORT. Se a senha contiver /, ?, # ou %, aplique antes a codificação de URL com urllib.parse.quote(password, safe="").

  3. Defina-a para os dois esquemas

    Dê a mesma URL à chave http e à chave https. Com apenas http definida, toda requisição HTTPS ignora o proxy e sai pelo seu próprio endereço.

  4. Confira o endereço de saída uma vez

    Solicite uma página que mostre o IP de quem chama, ou abra Qual é o meu IP pelo mesmo proxy, e confirme que é o endereço que você comprou.

  5. Execute o trabalho com timeout

    Passe sempre timeout=: por padrão o requests espera indefinidamente, e uma conexão travada passa a parecer um script congelado.

import requests

# The four values come with your order (dashboard or API)
proxy = "http://USERNAME:PASSWORD@HOST:PORT"

response = requests.get(
    "https://example.com/",
    proxies={"http": proxy, "https": proxy},
    timeout=30,
)
response.raise_for_status()
print(response.status_code)
import requests

proxy = "http://USERNAME:PASSWORD@HOST:PORT"

with requests.Session() as session:
    # HTTP_PROXY / HTTPS_PROXY in the environment would override
    # session.proxies; this makes the session use only its own setting.
    session.trust_env = False
    session.proxies.update({"http": proxy, "https": proxy})
    response = session.get("https://example.com/", timeout=30)
    response.raise_for_status()
    print(response.status_code)
# pip install "requests[socks]"
import requests

# Switch the proxy to SOCKS5 first; use the values the order then shows.
# socks5h: the proxy resolves the hostname, not your machine.
proxy = "socks5h://USERNAME:PASSWORD@HOST:PORT"

response = requests.get(
    "https://example.com/",
    proxies={"http": proxy, "https": proxy},
    timeout=30,
)
response.raise_for_status()
print(response.status_code)

Código testado para o requests

Cada exemplo se conecta por um proxy HTTP com usuário e senha, exceto o de SOCKS5, que exige que o proxy seja mudado antes para SOCKS5; o pedido passa então a mostrar uma nova porta e novas credenciais a usar. Substitua os quatro valores em maiúsculas pelos do seu pedido.

Documentação completa da API

Onde o proxy pode ser definido no requests

Extraído da documentação do requests e conferido com os exemplos de código desta página contra um proxy local autenticado. Quando mais de um está definido, um argumento proxies na chamada prevalece sobre o ambiente, e o ambiente prevalece sobre Session.proxies, a menos que a sessão defina trust_env como False, como faz o exemplo de sessão.
EscopoCredenciaisQuando usar
proxies= em uma chamadaApenas essa requisiçãoNa URLUm script com poucas chamadas
Session.proxiesTodas as requisições da sessãoNa URLQualquer coisa mais longa, com trust_env como False
HTTP_PROXY e HTTPS_PROXYTodas as chamadas do requests no processoNa URLCódigo que você não pode editar; NO_PROXY lista os hosts a ignorar
URL socks5h://O escopo em que for definidaNa URLQuando os nomes de host devem ser resolvidos no proxy

O que dá errado com requests e proxies

Só a chave http está definida

A chave indica o esquema do destino, não o do proxy. Um dicionário só com http roteia o HTTP simples e deixa todas as chamadas HTTPS saírem direto, sem nenhum erro que avise.

socks5 onde se queria socks5h

Com socks5, a sua máquina resolve o nome de host e entrega ao proxy um IP. Com socks5h, o proxy o resolve, então a consulta e a resposta vêm da rede do proxy, o que importa para sites que respondem de acordo com a localização.

Uma senha que quebra a URL

Uma barra, um ponto de interrogação ou uma cerquilha na senha corta a URL, e o requests falha antes de chegar ao proxy; um sinal de porcentagem é decodificado como sequência de escape. Codifique a senha na URL ou use a autenticação por lista de IPs permitidos e deixe as credenciais de fora.

Uma variável de ambiente esquecida

O requests lê HTTP_PROXY, HTTPS_PROXY e NO_PROXY, a menos que você defina trust_env como False na sessão, e essas variáveis se sobrepõem a Session.proxies. Uma variável esquecida em um servidor pode mandar o tráfego de uma sessão para onde você não queria, ou contornar o proxy.

A que o requests se conecta

Protocolos
HTTP, que transporta HTTPS, ou SOCKS5, ativado no pedido
Autenticação
Usuário e senha, ou uma lista de IPs permitidos definida pela API
Endereço
Um IP estático durante o período, na rede de um provedor de internet identificado
Rotação
Nenhuma: o mesmo endereço em todas as requisições

Outros guias e o produto

Perguntas sobre proxies no Python requests

Como uso um proxy com autenticação no Python requests?

Coloque usuário e senha na URL do proxy, http://USERNAME:PASSWORD@HOST:PORT, e passe-a para as chaves http e https. O requests envia as credenciais ao proxy, que responde 407 se estiverem erradas. Codifique uma senha que contenha caracteres reservados ou use uma lista de IPs permitidos.

Como uso um proxy SOCKS5 com o requests?

Instale o extra com pip install requests[socks], mude o próprio proxy para SOCKS5 no seu pedido e use a porta e as credenciais que o pedido passa a mostrar em uma URL socks5h://. Trocar apenas o esquema não basta: um endereço configurado em HTTP não responde em SOCKS5 até ser alterado. SOCKS5

Posso usar autenticação por lista de IPs permitidos em vez de senha?

Sim. Adicione à lista de IPs permitidos do proxy o endereço IPv4 público de onde o seu script roda, com uma chamada à API, PUT /orders/ORDER_ID/whitelist, ou pelo servidor MCP; o painel ainda não tem um controle para isso. O proxy passa a aceitar conexões desse endereço sem credenciais, em HTTP e em SOCKS5, e a URL passa a ser http://HOST:PORT. Enquanto uma lista de IPs permitidos estiver definida, o proxy admite apenas os endereços listados e o usuário e a senha deixam de funcionar para esse pedido; enviar uma lista vazia desativa a lista de IPs permitidos e o login com senha volta a funcionar.

O endereço muda entre as requisições?

Não. Um proxy ISP estático é um único endereço pelo período que você pagar, e toda requisição enviada por ele sai desse endereço. Se um trabalho precisa de um endereço diferente por requisição, isso é um pool rotativo, que ainda não vendemos.

Como verifico qual IP um site enxerga?

Solicite pelo mesmo proxy uma página que devolva o endereço de quem chama, ou abra o Qual é o meu IP em um navegador configurado com ele. Se aparecer o seu próprio endereço, provavelmente falta a chave https. Qual é o meu IP

Para que posso usar o proxy?

Testes dos seus próprios sites por região, verificações de qualidade, verificação de anúncios, pesquisa de preços e de mercado e proteção de marca não exigem análise conforme a nossa política de uso aceitável. A seção 5 da política proíbe usar o proxy em violação a CAPTCHAs, detecção de bots, limites de requisições ou bloqueios de contas. Política de Uso Aceitável

Um endereço estático combina com trabalhos que devem chegar sempre do mesmo lugar: um monitoramento, uma verificação regional, um teste que compara hoje com a semana passada. Peça um endereço por trabalho em proxies ISP, veja os preços e, se o mesmo trabalho roda em um navegador, os guias de Selenium e Playwright configuram lá o mesmo endereço.

Fontes