Zum Inhalt springen
Proxys · geoip · WebRTC · SOCKS5

Proxys, die zur Identität passen

Um eine US-Residential-IP in einem Browser mit der Zeitzone Europe/Amsterdam zu erkennen, genügt eine Zeile Code – und diese Abweichung passiert leicht aus Versehen. Geben Sie Clearcote einen Proxy mit aktiviertem geoip, und es schlägt die Exit-IP nach und stellt Zeitzone, Sprachen und WebRTC-Adresse passend ein, bevor die erste Seite lädt.

Proxy-Unterstützung und geoip sind in jedem Tarif enthalten.

Eine Option, die alles in Einklang bringt

import { launch } from "clearcote";

const browser = await launch({
  fingerprint: "account-42",
  proxy: { server: "http://gateway:8080", username: "u", password: "p" },
  geoip: true, // timezone + languages + WebRTC follow the exit IP
});

Highlights

geoip mit einer Option

Die Exit-IP wird in der Offline-Datenbank geoip-all-in-one nachgeschlagen, und Zeitzone, Hauptsprache, Accept-Language und WebRTC-Adresse werden für diese Region gesetzt.

Eine Locale überall

Accept-Language, navigator.language, Intl.DateTimeFormat und toLocaleString folgen derselben Sprache, in der Seite und in Workern.

SOCKS5 mit Zugangsdaten

Standard-Chromium kann sich nicht bei einem SOCKS5-Proxy authentifizieren. Jeder Clearcote-Build ab 151, auch der kostenlose offene Build, implementiert den Handshake mit Benutzername und Passwort (RFC 1929) in der Engine, ein lokales Relay ist also nicht nötig. Übergeben Sie die Zugangsdaten als separate Felder oder ab SDK 0.31.1 direkt in der Proxy-Adresse.

WebRTC ohne Leak

Standardmäßig kann WebRTC keinen Traffic am Proxy vorbei senden, Ihre eigene Adresse bleibt also privat. Mit aktiviertem geoip (oder webrtcIp) meldet es stattdessen die Adresse des Proxys, so wie ein Browser, der tatsächlich dahinter sitzt. Der lizenzierte Build hält WebRTC-Traffic auch dann von Ihrer eigenen Verbindung fern; der offene Build nicht, sodass ein von der Seite gewähltes Relay Ihre Adresse weiterhin sehen kann.

Passende Geolocation

--fingerprint-location legt Koordinaten passend zur Zeitzone fest, damit Geolocation-API und Uhr übereinstimmen.

Oder gar keine Proxys kaufen

Gehostete Browser enthalten einen Residential-Proxy, mit Targeting nach Land, Bundesstaat und Stadt sowie Sticky Sessions.

Warum der Standort stimmig sein muss

Der Standort zeigt sich an mehreren unabhängigen Stellen: IP-Adresse, Zeitzone, Sprach-Header, Zahlen- und Datumsformat, WebRTC und, sofern erlaubt, Geolocation. Ein Detektor muss nicht wissen, wo Sie sind. Es genügt, dass zwei dieser Angaben nicht zusammenpassen.

geoip macht die Exit-IP zur maßgeblichen Quelle. Beim Start ermittelt das SDK die Exit-Adresse des Proxys, schlägt sie in einer Offline-Datenbank nach und stellt den Rest passend ein, sodass schon die erste Seite eine konsistente Locale sieht.

Prüfen Sie immer den Exit, bevor Sie einer Session vertrauen. Ein Proxy, der bei einem Fehler unbemerkt auf eine direkte Verbindung zurückfällt, schickt Traffic von Ihrer eigenen IP, und alle anderen Vorkehrungen sind dann hinfällig. Eine einzige Anfrage an einen Adress-Reflektor beim Start genügt.

Wofür es eingesetzt wird

Regionsspezifische Ergebnisse

Preise, Suchergebnisse und Verfügbarkeit so, wie ein Besucher in dem jeweiligen Land sie sieht.

An eine Region gebundene Accounts

Halten Sie IP, Zeitzone und Sprache eines Accounts in jeder Session gleich.

Anzeigen- und Content-Checks

Sehen Sie die Anzeige, Seite oder das Angebot, die ein Besucher in einer bestimmten Stadt zu sehen bekommt.

Lokalisierungs-QA

Prüfen Sie Datumsangaben, Währungen und Übersetzungen so, wie lokale Besucher sie sehen.

Clearcote ist für Datenschutz, Tests, Forschung und rechtmäßige Automatisierung gebaut. Sie sind dafür verantwortlich, wie Sie es einsetzen, und dafür, die Nutzungsbedingungen der Websites einzuhalten, die Sie besuchen.

Der Diff

38.921 Zeilen zwischen Standard-Chromium und Clearcote Pro.

So weit ist der Pro-Build von dem Chromium entfernt, das Google ausliefert. Jeder Wert, den eine Website lesen kann, wird dort gesetzt, wo Chromium ihn berechnet. So beschreiben die Seite, ihre Worker und ihre iframes alle dasselbe Gerät.

  • Canvas
  • WebGL
  • WebGPU
  • Audio
  • Schriften
  • Bildschirm und Fenster
  • WebRTC
  • TLS
  • Client Hints
  • Eingabe-Timing
  • Stimmen und Codecs
Die Patches des offenen Builds auf GitHub lesen

Pro-Build, gezählt am Patch-Stack von r57 (Chromium 156.0.8078.47). Der kostenlose offene Build ist ein kleinerer, öffentlicher Patch-Satz.

Chromium 156.0.8078.47 → Clearcote Pro r57

345 files changed, 35915 insertions(+), 3006 deletions(-)

240 Patches

Geänderte Dateien nach Bereich

  • Rendering-Engine (Blink)118
  • Browser (chrome/)52
  • Content-Schicht42
  • Komponenten39
  • Netzwerk-Stack22
  • UI und Fenster14
  • TLS (BoringSSL)11
  • V8 und URL17
  • Alles andere30

In welchem Tarif enthalten

Proxy-Unterstützung, automatischer Abgleich von Zeitzone und Sprache, WebRTC, das die Adresse des Proxys meldet, und ab 151 auch SOCKS5 mit Zugangsdaten sind in jedem Tarif enthalten. Dafür, dass WebRTC dabei keinen Traffic über Ihre eigene Verbindung schickt, brauchen Sie den lizenzierten Build (kostenlos mit GitHub).

Tarife vergleichen

FAQ

Was macht geoip genau?

Es ermittelt die Exit-IP des Proxys, schlägt sie in der Offline-Datenbank geoip-all-in-one nach und setzt für diese Region passende Werte für Zeitzone, Sprachliste (Accept-Language, navigator.languages), Geolocation und WebRTC-IP. Lässt sich die Region nicht ermitteln, bricht der Start mit einem Fehler ab, statt mit Uhrzeit und Sprache Ihres eigenen Rechners zu starten.

Unterstützt Clearcote SOCKS5-Proxys mit Authentifizierung?

Ja, in jedem Build ab 151, auch im kostenlosen offenen Build. Übergeben Sie Benutzername und Passwort als separate Proxy-Felder oder ab SDK 0.31.1 auch direkt in der Adresse (socks5://user:pass@host:port); ältere SDKs verwarfen in die Adresse geschriebene Zugangsdaten, bevor sie den Browser erreichten. Clearcote implementiert die SOCKS5-Authentifizierung mit Benutzername und Passwort in der Engine, was Standard-Chromium nicht tut. Ein lokales Relay brauchen Sie also nicht.

Verrät WebRTC meine echte IP?

Standardmäßig nicht. Das SDK konfiguriert WebRTC so, dass es kein UDP außerhalb des Proxys senden kann, und hält Ihre eigene Adresse damit privat. Mit geoip (oder webrtcIp) meldet es stattdessen die Adresse des Proxys, so wie ein Browser hinter dieser IP. Der lizenzierte Build sendet auch dann keinen WebRTC-Traffic über Ihre eigene Verbindung; der offene Build schon, sobald geoip aktiv ist – ein Relay, das die Seite auswählt, könnte also Ihre echte Adresse lesen. Mehr dazu: Was ein WebRTC-Leak ist.

Welche Proxy-Typen funktionieren?

HTTP- und SOCKS5-Proxys, mit oder ohne Zugangsdaten (SOCKS5-Zugangsdaten erfordern Build 151 oder neuer). Residential- oder Mobile-Exits passen am besten zu einem Endkunden-Browser; gehostete Browser enthalten Residential-Exits.

Muss ich die Zeitzone selbst setzen?

Mit geoip nicht. Wenn Sie sie lieber von Hand setzen, übergeben Sie timezone und acceptLanguage (Python: accept_language); Intl und toLocaleString folgen dann ebenfalls der Sprache.

Mehr dazu in der Dokumentation

Verwandte Funktionen

Clearcote ausprobieren

Direkt einsetzbar mit Playwright & Puppeteer, kohärent bis hinunter zum TLS-Handshake, mit einem Open-Source-Build als Ausgangspunkt.

Kostenlos für einen Browser: GitHub, eine Kartenprüfung oder ein Google-Firmenkonto. Nie belastet.