Proxys et geoip
Faites passer le navigateur par votre propre proxy, y compris en SOCKS5 avec identifiant et mot de passe, et laissez geoip aligner le fuseau horaire, la langue et l'adresse WebRTC sur l'IP de sortie du proxy.
Adapter automatiquement la région au proxy (geoip)
geoip est activé par défaut (depuis le SDK 0.66.0) : avec un proxy, le SDK résout l’IP de sortie du proxy, et sans proxy l’IP publique de cette machine — en la cherchant dans la base hors ligne geoip-all-in-one — puis définit pour cette région un ensemble cohérent fuseau horaire + langue principale de navigator + Accept-Language + IP WebRTC. Plus besoin d’associer à la main un fuseau horaire à chaque 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
)Il définit aussi la géolocalisation et la liste complète navigator.languages de la région, fonctionne avec les proxys HTTP et SOCKS5 (identifiants compris) et existe dans les trois SDK (Geoip = true en .NET). La première exécution télécharge la base de données (environ 50 MB). Par défaut, une région impossible à résoudre affiche un avertissement et le lancement continue. Passez geoip: true et le lancement s’arrête avec une GeoipError au lieu de démarrer discrètement avec l’horloge et la langue de cette machine ; définissez à la fois timezone et acceptLanguage pour lancer quand même. Cette recherche dispose de 20 secondes (CLEARCOTE_GEOIP_TIMEOUT_SECONDS) ; en .NET, l’erreur est GeoipException. Avec geoip: false (ou CLEARCOTE_GEOIP=0) et sans timezone explicite, le fuseau horaire suit la langue — en-US signifie New York, même derrière un proxy allemand. Sur le build ouvert derrière un proxy, la recherche par défaut laisse l’adresse WebRTC non définie, car une adresse WebRTC y permet à l’UDP WebRTC de sortir par votre propre connexion ; passez geoip: true pour la définir quand même.
Vous préférez le définir vous-même ? Utilisez acceptLanguage (Node) / accept_language (Python), par exemple "en-US,en" — il définit l’en-tête Accept-Language, le tableau complet navigator.languages et navigator.language — et Intl / toLocaleString le suivent également.
SOCKS5 avec identifiants
Chromium d’origine ne sait pas du tout s’authentifier auprès d’un proxy SOCKS5 — il n’implémente pas la sous-négociation nom d’utilisateur/mot de passe —, d’où la solution habituelle : un relais local qui détient les identifiants. Clearcote l’implémente dans le moteur (RFC 1929) : aucun relais n’est nécessaire. Passez le nom d’utilisateur et le mot de passe dans des champs séparés ou dans l’adresse (socks5://user:pass@host:port) ; dans les deux cas, le SDK les transmet au moteur. Les identifiants dans l’adresse nécessitent le SDK 0.31.1 ou plus récent : les SDK plus anciens laissaient Playwright les abandonner, et le proxy ne recevait aucun identifiant.
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'sFonctionne sur tous les builds à partir de la 151, build ouvert gratuit compris. Les builds ouverts antérieurs à la 151 ne savent pas s’authentifier auprès d’un proxy SOCKS5 : avec ceux-ci, utilisez un relais local ou un proxy HTTP.
Vérifiez toujours l’adresse de sortie avant de faire confiance à une session. Un proxy qui tombe en panne sans rien dire et laisse passer le trafic l’envoie depuis votre propre IP, et toutes les autres précautions deviennent vaines. Vérifiez-la une fois au lancement auprès d’un service qui renvoie l’adresse vue de l’extérieur, plutôt que de la tenir pour acquise.