Proxys und geoip
Leiten Sie den Browser über Ihren eigenen Proxy, auch über SOCKS5 mit Benutzername und Passwort, und lassen Sie geoip Zeitzone, Sprache und WebRTC-Adresse an die Exit-IP des Proxys anpassen.
Region des Proxys automatisch übernehmen (geoip)
geoip ist standardmäßig aktiv (seit SDK 0.66.0): Mit einem Proxy ermittelt das SDK die Exit-IP des Proxys, ohne Proxy die eigene öffentliche IP dieses Rechners — nachgeschlagen in der Offline-Datenbank geoip-all-in-one — und setzt für diese Region eine kohärente Kombination aus Zeitzone + primärer Navigator-Sprache + Accept-Language + WebRTC-IP. Sie müssen also nicht mehr für jeden Proxy die Zeitzone von Hand anpassen:
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
)Außerdem setzt es für die Region die Geolocation und die vollständige Liste navigator.languages, funktioniert über HTTP- und SOCKS5-Proxys (inklusive Zugangsdaten) und steckt in allen drei SDKs (Geoip = true in .NET). Beim ersten Lauf wird die Datenbank heruntergeladen (rund 50 MB). Standardmäßig gibt eine Region, die sich nicht ermitteln lässt, eine Warnung aus, und der Start läuft weiter. Übergeben Sie geoip: true, bricht der Start mit einem GeoipError ab, statt stillschweigend mit Uhr und Sprache dieses Rechners zu starten; setzen Sie sowohl timezone als auch acceptLanguage, um trotzdem zu starten. Für diesen Lookup gibt es 20 Sekunden (CLEARCOTE_GEOIP_TIMEOUT_SECONDS); unter .NET heißt der Fehler GeoipException. Mit geoip: false (oder CLEARCOTE_GEOIP=0) und ohne explizite timezone folgt die Zeitzone der Sprache — en-US bedeutet New York, auch hinter einem deutschen Proxy. Auf dem offenen Build hinter einem Proxy lässt der Standard-Lookup die WebRTC-Adresse ungesetzt, denn dort lässt eine WebRTC-Adresse WebRTC-UDP über Ihre eigene Verbindung hinausgehen; übergeben Sie geoip: true, um sie trotzdem zu setzen.
Lieber selbst einstellen? Verwenden Sie acceptLanguage (Node) / accept_language (Python), z. B. "en-US,en" — das setzt den Accept-Language-Header, das komplette Array navigator.languages und navigator.language —, und auch Intl / toLocaleString richten sich danach.
SOCKS5 mit Zugangsdaten
Standard-Chromium kann sich bei einem SOCKS5-Proxy überhaupt nicht authentifizieren — die Benutzername/Passwort-Subnegotiation ist schlicht nicht implementiert —, deshalb ist der übliche Workaround ein lokales Relay, das die Zugangsdaten hält. Clearcote implementiert sie in der Engine (RFC 1929), ein Relay ist also nicht nötig. Übergeben Sie Benutzername und Passwort als separate Felder oder in der Adresse (socks5://user:pass@host:port); in beiden Fällen reicht das SDK sie an die Engine weiter. Zugangsdaten in der Adresse erfordern SDK 0.31.1 oder neuer: Bei älteren SDKs hat Playwright sie verworfen, und der Proxy sah keinen Login.
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'sFunktioniert in jedem Build ab 151, auch im kostenlosen offenen Build. Offene Builds vor 151 können sich nicht bei einem SOCKS5-Proxy authentifizieren, verwenden Sie mit diesen also ein lokales Relay oder einen HTTP-Proxy.
Prüfen Sie immer die Exit-Adresse, bevor Sie einer Session vertrauen. Ein Proxy, der unbemerkt fail-open ausfällt, schickt den Traffic von Ihrer eigenen IP ab, und jede andere Vorsichtsmaßnahme wird bedeutungslos. Prüfen Sie die Adresse einmal beim Start gegen einen IP-Echo-Dienst, statt sie einfach vorauszusetzen.