# Proxy no Selenium: configuração para Chrome e Firefox | ProxyJam

Como configurar um proxy no Selenium para Chrome e Firefox, por que credenciais em --proxy-server falham e como a lista de IPs permitidos as substitui. Código Python testado.

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

Execute o Chrome ou o Firefox no Selenium por um endereço ISP estático. Todos os exemplos desta página foram executados contra um proxy local antes de serem publicados, e o que não funcionou é dito com clareza.


No Chrome, passe `--proxy-server=http://HOST:PORT` como argumento; no Firefox, defina um Proxy manual nas opções. O Firefox consegue responder ao pedido de senha do proxy pelo handler WebDriver BiDi do Selenium, `add_authentication_handler`. O Chrome não conseguiu no nosso teste: ele ignora credenciais em `--proxy-server`, e os dois handlers BiDi estouraram o tempo limite. Para o Chrome, coloque na lista de IPs permitidos do proxy o IP de onde os seus testes rodam, e o proxy dispensa credenciais, em HTTP ou SOCKS5.


## Configurar um proxy no Selenium

1. **Descubra o IP público de onde os seus testes rodam** O endereço da máquina ou do runner de CI como a internet o enxerga, não o local. O [Qual é o meu IP](/pt/what-is-my-ip/) mostra.
2. **Coloque esse IP na lista de IPs permitidos do proxy** Uma chamada à API, `PUT /orders/ORDER_ID/whitelist`, ou a ferramenta `set_proxy_whitelist` do servidor MCP; o painel ainda não tem um controle para isso. A lista aceita endereços IPv4 e é substituída a cada vez. 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.
3. **Copie o host e a porta do pedido** Em Meus Proxies ou pela API. Com a lista de IPs permitidos configurada, usuário e senha não são necessários.
4. **Defina o proxy nas opções do navegador** Chrome: `--proxy-server=http://HOST:PORT`, ou `socks5://HOST:PORT` depois de mudar o proxy para SOCKS5. Firefox: um `Proxy` manual com `httpProxy` e `sslProxy`.
5. **Abra uma página e confira o endereço de saída** Carregue o Qual é o meu IP no navegador controlado uma vez e confirme que mostra o endereço que você comprou; depois execute a suíte.

## Código testado para o Selenium 4 em Python

O exemplo de senha no Firefox envia usuário e senha, então exige um pedido sem lista de IPs permitidos definida. Os demais exemplos de navegador presumem que o IP da sua máquina está na lista de IPs permitidos do proxy; o de SOCKS5 também exige que o proxy seja mudado antes para SOCKS5, o que gera uma nova porta. Substitua os valores em maiúsculas pelos do seu pedido, e ORDER_ID, YOUR_API_KEY e YOUR_IP na chamada da lista de IPs permitidos.

### Chrome

Chrome por um proxy HTTP.

```
# The proxy has your machine's IP on its allowlist, so no credentials
# are sent: Chrome ignores them in --proxy-server anyway.
from selenium import webdriver

options = webdriver.ChromeOptions()
options.add_argument("--headless=new")  # remove to watch the browser
options.add_argument("--proxy-server=http://HOST:PORT")

driver = webdriver.Chrome(options=options)
try:
    driver.get("https://example.com/")
    print(driver.title)
finally:
    driver.quit()
```

### Firefox com senha

Firefox respondendo ao pedido de senha do proxy.

```
# Selenium 4.51+ with WebDriver BiDi; pip install selenium
from selenium import webdriver
from selenium.webdriver.common.proxy import Proxy, ProxyType

options = webdriver.FirefoxOptions()
options.enable_bidi = True
options.add_argument("-headless")  # remove to watch the browser
options.proxy = Proxy({
    "proxyType": ProxyType.MANUAL,
    "httpProxy": "HOST:PORT",
    "sslProxy": "HOST:PORT",
})

driver = webdriver.Firefox(options=options)
try:
    # Answers the proxy's 407 with your username and password
    driver.network.add_authentication_handler(
        lambda request: request.provide_credentials("USERNAME", "PASSWORD")
    )
    driver.get("https://example.com/")
    print(driver.title)
finally:
    driver.quit()
```

### Firefox

Firefox por um proxy HTTP com IP permitido.

```
# The proxy has your machine's IP on its allowlist, so no credentials
# are sent. For a password instead, see selenium-firefox-auth.
from selenium import webdriver
from selenium.webdriver.common.proxy import Proxy, ProxyType

options = webdriver.FirefoxOptions()
options.add_argument("-headless")  # remove to watch the browser
options.proxy = Proxy({
    "proxyType": ProxyType.MANUAL,
    "httpProxy": "HOST:PORT",
    "sslProxy": "HOST:PORT",
})

driver = webdriver.Firefox(options=options)
try:
    driver.get("https://example.com/")
    print(driver.title)
finally:
    driver.quit()
```

### Chrome SOCKS5

Chrome por um proxy SOCKS5.

```
# Switch the proxy to SOCKS5 first, then use the port the order shows.
# The allowlist applies to SOCKS5 as well, so no credentials here either.
from selenium import webdriver

options = webdriver.ChromeOptions()
options.add_argument("--headless=new")  # remove to watch the browser
options.add_argument("--proxy-server=socks5://HOST:PORT")

driver = webdriver.Chrome(options=options)
try:
    driver.get("https://example.com/")
    print(driver.title)
finally:
    driver.quit()
```

### Chamada da lista de IPs permitidos

Adicione o seu IP à lista de IPs permitidos do proxy.

```
# Put the public IPv4 address your code runs from on the proxy's
# allowlist. Replaces the list; an empty list turns allowlisting off
# and the proxy falls back to username and password.
curl -X PUT "https://api.proxyjam.com/public/v1/orders/ORDER_ID/whitelist" \
  -H "X-API-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"whitelisted_ips": ["YOUR_IP"]}'
```


## Opções de proxy no Selenium, navegador por navegador

|  | Proxy HTTP | Proxy SOCKS5 | Usuário e senha |
|---|---|---|---|
| Chrome | --proxy-server=http://HOST:PORT | --proxy-server=socks5://HOST:PORT | Ignorado em --proxy-server; use a lista de IPs permitidos |
| Firefox | Proxy com httpProxy e sslProxy | Proxy com socksProxy e socksVersion 5 | Funcionou com add_authentication_handler (BiDi), em HTTP |
| Chrome, handlers BiDi | add_auth_handler e add_authentication_handler estouraram o tempo limite | Não testado | Use a lista de IPs permitidos até que uma versão posterior do Selenium ou do Chrome mude isso |

Testado em 2026-10-22 com o Selenium 4.51, Chrome e Firefox em modo headless, contra um proxy local que exigia senha em uma porta e aceitava um cliente da lista de IPs permitidos em outra.


## O que um teste de navegador obtém do endereço

- **Sem senha no navegador:** A lista de IPs permitidos admite o endereço IPv4 do seu runner, então nenhum segredo fica nas opções nem nos logs
- **Os dois esquemas do navegador:** http:// para páginas comuns, socks5:// depois que o pedido é mudado
- **Mesma origem a cada execução:** A execução de ontem e a de hoje saem do mesmo IP, mantido por todo o período de cobrança
- **Drivers em paralelo:** Vários drivers podem compartilhar o endereço, ou cada driver pode ter o seu

## O que dá errado com Selenium e proxies

### Credenciais dentro de --proxy-server

O Chrome descarta usuário e senha desse argumento sem emitir erro, conecta sem eles e recebe um 407 do proxy. A página então não carrega, o que parece um problema de rede e não de autenticação.

### O download do driver passa pelo proxy

Quando as opções do Firefox trazem um proxy, o Selenium Manager baixa o driver por esse mesmo proxy. Com um proxy só de senha, esse download falha antes de o navegador iniciar; com a lista de IPs permitidos, funciona.

### A lista de IPs permitidos tem o endereço errado

Um runner de CI muitas vezes sai por um IP público diferente do seu notebook, e alguns mudam entre execuções. Coloque na lista o endereço de onde os testes rodam e atualize-o quando mudar, já que cada chamada substitui a lista.

### SOCKS5 no navegador antes da mudança

Um endereço configurado em HTTP não responde em SOCKS5. Mude antes o proxy no seu pedido e use a porta que ele passa a mostrar; trocar só o esquema no argumento resulta em um navegador que não consegue conectar.


## Perguntas sobre proxies no Selenium

### Como uso um proxy com autenticação no Selenium?

No Firefox, ative o WebDriver BiDi e registre um handler com driver.network.add_authentication_handler que forneça usuário e senha; isso funcionou com o Selenium 4.51. No Chrome, nada que envie credenciais funcionou no nosso teste: ele as ignora na opção do proxy, e os dois handlers BiDi estouraram o tempo limite. Para o Chrome, coloque na lista de IPs permitidos o IP público de onde os seus testes rodam, e o navegador conecta sem nenhuma credencial.

### Como configuro um proxy no Selenium com Python para o Chrome?

Crie o ChromeOptions, adicione o argumento --proxy-server=http://HOST:PORT e passe as opções para webdriver.Chrome. Para SOCKS5, mude o proxy para SOCKS5 no seu pedido e use socks5://HOST:PORT com a porta que o pedido passa a mostrar.

### A lista de IPs permitidos funciona com SOCKS5?

Sim. Um endereço da lista é aceito sem credenciais em HTTP e em SOCKS5, o que torna o SOCKS5 utilizável no Chrome, já que o Chrome não consegue enviar usuário e senha de SOCKS5. A lista é definida pela API ou pelo servidor MCP e aceita endereços IPv4.

### Cada navegador de uma suíte de testes pode usar um proxy diferente?

Sim, um por driver: o proxy faz parte das opções com que o driver inicia, então dois drivers podem usar dois endereços. Não é possível mudar o proxy de um Chrome em execução; inicie um novo driver.

### Uma suíte longa troca de endereço no meio?

Não troca. O driver mantém o endereço com que iniciou até encerrar, e o próprio endereço permanece atribuído a você durante todo o período de cobrança. Suítes que precisam de muitas origens ao mesmo tempo precisariam de um pool que as alterne, e isso ainda não está à venda.

### Para que posso usar o proxy?

Testes de ponta a ponta do seu próprio produto, verificações regionais da sua loja, verificação de anúncios, pesquisa de preços e proteção de marca podem ser feitos sem análise prévia conforme a nossa política de uso aceitável. A seção 5 da política proíbe controlar um navegador em violação a CAPTCHAs, defesas contra bots, limites de requisições ou bloqueios de contas.


Um endereço estático mantém os testes de navegador repetíveis: a mesma suíte, executada na semana que vem, chega do mesmo lugar, então uma mudança no resultado vem do site. Peça um endereço em [proxies ISP](/pt/isp-proxies/), veja os [preços](/pt/pricing/) e defina o mesmo endereço em chamadas HTTP simples com o guia de [Python requests](/pt/integrations/python-requests/).



## Fontes

- [Selenium documentation, Proxy](https://www.selenium.dev/documentation/webdriver/drivers/options/#proxy): definir um proxy nas opções do navegador
- [Selenium documentation, Selenium Manager](https://www.selenium.dev/documentation/selenium_manager/): como os drivers são baixados e que o proxy configurado é usado para isso
- [Chromium, network settings](https://www.chromium.org/developers/design-documents/network-settings/): a opção `--proxy-server` e seus esquemas




O Selenium não roteia o tráfego por conta própria: ele inicia um navegador e entrega a ele o proxy como parte das opções do navegador. É por isso que a resposta difere entre Chrome e Firefox, e por que a autenticação do proxy é onde a maioria das configurações falha.

## Proxy do Selenium em Python para Chrome e Firefox

O Chrome lê o proxy de uma opção de linha de comando, o Firefox de um objeto proxy nas suas opções. Ambos aceitam um proxy com IP permitido sem nenhuma configuração adicional; o Firefox também consegue responder ao pedido de senha do proxy pelo WebDriver BiDi, o que o Chrome não fez no nosso teste.

