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 Selenium

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.

Em resumo: 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.

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.

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

# 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()
# 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()
# 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()
# 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()
# 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"]}'

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.

Documentação completa da API

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

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.
Proxy HTTPProxy SOCKS5Usuário e senha
Chrome--proxy-server=http://HOST:PORT--proxy-server=socks5://HOST:PORTIgnorado em --proxy-server; use a lista de IPs permitidos
FirefoxProxy com httpProxy e sslProxyProxy com socksProxy e socksVersion 5Funcionou com add_authentication_handler (BiDi), em HTTP
Chrome, handlers BiDiadd_auth_handler e add_authentication_handler estouraram o tempo limiteNão testadoUse a lista de IPs permitidos até que uma versão posterior do Selenium ou do Chrome mude isso

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.

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

Outros guias e o produto

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

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. Política de Uso Aceitável

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, veja os preços e defina o mesmo endereço em chamadas HTTP simples com o guia de Python requests.

Fontes