Proxies e geoip
Envie o navegador por um proxy seu, inclusive SOCKS5 com usuário e senha, e deixe ogeoip ajustar o fuso horário, o idioma e o endereço do WebRTC ao IP de saída do proxy.
Ajuste automático à região do proxy (geoip)
O geoip vem ativado por padrão (desde o SDK 0.66.0): com um proxy, o SDK resolve o IP de saída do proxy e, sem proxy, o IP público desta máquina — consultado no banco de dados offline geoip-all-in-one — e define fuso horário + idioma principal do navigator + Accept-Language + IP do WebRTC coerentes com essa região. Chega de ajustar o fuso horário à mão para cada proxy:
from clearcote import launch
browser = launch(
fingerprint="user-7423",
proxy={"server": "http://host:8080", "username": "u", "password": "p"},
geoip=True, # timezone + language auto-matched to the proxy's region
)Ele também define a geolocalização e a lista completa de navigator.languages da região, funciona com proxies HTTP e SOCKS5 (inclusive com credenciais) e está nos três SDKs (Geoip = true no .NET). A primeira execução baixa o banco de dados (cerca de 50 MB). Por padrão, uma região que não pode ser resolvida exibe um aviso e a inicialização segue em frente. Passe geoip: true e a inicialização para com um GeoipError, em vez de subir silenciosamente com o relógio e o idioma desta máquina; defina timezone e acceptLanguage para iniciar mesmo assim. Essa consulta tem 20 segundos (CLEARCOTE_GEOIP_TIMEOUT_SECONDS); no .NET, o erro é GeoipException. Com geoip: false (ou CLEARCOTE_GEOIP=0) e sem um timezone explícito, o fuso horário segue o idioma — en-US significa Nova York, mesmo atrás de um proxy alemão. No build aberto atrás de um proxy, a consulta padrão deixa o endereço WebRTC sem definir, porque ali um endereço WebRTC deixa o UDP do WebRTC sair pela sua própria conexão; passe geoip: true para defini-lo mesmo assim.
Prefere definir você mesmo? Use acceptLanguage (Node) / accept_language (Python), por exemplo "en-US,en" — ele define o header Accept-Language, o array completo navigator.languages e navigator.language — e Intl / toLocaleString também o seguem.
SOCKS5 com credenciais
O Chromium padrão simplesmente não consegue se autenticar num proxy SOCKS5 — ele não implementa a subnegociação de usuário/senha —, então a solução usual é um relay local que guarda as credenciais. O Clearcote implementa isso no motor (RFC 1929), então não é preciso relay. Passe o usuário e a senha como campos separados ou dentro do endereço (socks5://user:pass@host:port); de um jeito ou de outro, o SDK os entrega ao motor. Credenciais dentro do endereço exigem o SDK 0.31.1 ou mais recente: SDKs mais antigos deixavam o Playwright descartá-las, e o proxy não recebia login nenhum.
from clearcote import launch_persistent_context
ctx = launch_persistent_context(
"./profile",
proxy={"server": "socks5://proxy.example.net:1080", "username": "user", "password": "pass"},
)
page = ctx.pages[0] if ctx.pages else ctx.new_page()
page.goto("https://api.ipify.org?format=json") # confirm the exit IP is the proxy'sFunciona em todos os builds a partir do 151, inclusive no build aberto gratuito. Builds abertos anteriores ao 151 não conseguem se autenticar num proxy SOCKS5, então, com eles, use um relay local ou um proxy HTTP.
Sempre verifique o endereço de saída antes de confiar numa sessão. Um proxy que falha em modo aberto sem avisar envia o tráfego pelo seu próprio IP, e todas as outras precauções perdem o sentido. Confira uma vez, na inicialização, com um serviço que devolve o seu endereço IP, em vez de presumir.