# Proxy no Python requests: use um proxy ISP estático | ProxyJam

Como configurar um proxy no Python requests: por requisição, por sessão e em SOCKS5 com DNS remoto, com código testado para um endereço ISP estático.

- Canonical: https://proxyjam.com/pt/integrations/python-requests/
- Updated: 2026-11-17
- Language: pt

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.


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.


## 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](/pt/what-is-my-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.

## 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.

### Por requisição

Passe o proxy para uma única chamada.

```
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)
```

### Sessão

Defina o proxy uma vez para todas as chamadas de uma sessão.

```
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)
```

### SOCKS5

SOCKS5 com nomes de host resolvidos no proxy.

```
# 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)
```


## Onde o proxy pode ser definido no requests

|  | Escopo | Credenciais | Quando usar |
|---|---|---|---|
| proxies= em uma chamada | Apenas essa requisição | Na URL | Um script com poucas chamadas |
| Session.proxies | Todas as requisições da sessão | Na URL | Qualquer coisa mais longa, com trust_env como False |
| HTTP_PROXY e HTTPS_PROXY | Todas as chamadas do requests no processo | Na URL | Código que você não pode editar; NO_PROXY lista os hosts a ignorar |
| URL socks5h:// | O escopo em que for definida | Na URL | Quando os nomes de host devem ser resolvidos no proxy |

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.


## 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

## 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.


## 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.

### 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.

### 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.


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](/pt/isp-proxies/), veja os [preços](/pt/pricing/) e, se o mesmo trabalho roda em um navegador, os guias de [Selenium](/pt/integrations/selenium/) e [Playwright](/pt/integrations/playwright/) configuram lá o mesmo endereço.



## Fontes

- [Requests documentation, Proxies](https://requests.readthedocs.io/en/latest/user/advanced/#proxies): o argumento proxies, as variáveis de ambiente e o suporte a SOCKS
- [RFC 1928, SOCKS Protocol Version 5](https://www.rfc-editor.org/rfc/rfc1928): como um cliente pede a um proxy SOCKS5 um destino por nome ou por endereço
- [RFC 3986, URI Generic Syntax](https://www.rfc-editor.org/rfc/rfc3986#section-3.2.1): a parte userinfo de uma URL e os caracteres que precisam ser codificados nela




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.

