Launch-Optionen
Die Launch-Optionen, die auf den anderen Seiten nicht behandelt werden: Erweiterungen, die Privacy Sandbox und der Rest der Liste.
Weitere Launch-Optionen
extensions— eine Liste von Verzeichnispfaden entpackter Erweiterungen (erzeugt--load-extension+--disable-extensions-except).disablePrivacySandbox/disable_privacy_sandbox— auftruesetzen, um die Privacy-Sandbox-APIs abzuschalten (Topics, FLEDGE / Protected Audience, Shared Storage, Private Aggregation, Fenced Frames). Seit 0.23 standardmäßig aus: Die Standard-Persona tritt als Google Chrome auf, und das bringt alle diese APIs mit. Schalten Sie die Option nur ein, wenn die Persona ein Chromium ohne Google-Dienste darstellt. WebUSB ist nicht betroffen.agentTyping/agent_typing— der Tipp-Rhythmus des Agenten (humanals Standard /fast/instant). Siehe Agent.tlsProfile— hält den TLS-ClientHello kohärent mit der Chrome-Version, die die Persona angibt, damit die Netzwerkschicht dem UA folgt (und nicht dem nativen TLS des Builds). Der Standardwert"match-persona"folgtbrandVersion;"native"lässt ihn unverändert;"chrome-<major>"pinnt eine Major-Version. Siehe Fingerprint-Flags.platform: "android"— eine mobile Persona auf Best-Effort-Basis (Touch, grober Pointer, mobiler Bildschirm/DPR, Mali/Adreno-WebGL, Smartphone-Viewport). Auf einer Desktop-Engine bleibt das GPU-Rendering das eines Desktops — für Render-Kohärenz kombinieren Sie die Persona mit der Canvas-Bridge.storageQuota,fingerprintProfile,canvasBridge,webrtcIp,acceptLanguage,disableGpuFingerprint,fingerprintNoise— siehe Fingerprint-Flags.
Neuere Optionen (lizenzierter Build)
Diese Optionen setzen den lizenzierten Build voraus (Kostenlos mit GitHub oder Pro). Die jeweils nötige Engine-Revision steht in eckigen Klammern; auf einer älteren Engine überspringt das SDK die mit 152 r22 gekennzeichneten mit einer Warnung, prüft bei jeder mit 154 r32 gekennzeichneten die Engine und lässt sie weg, wenn der Build sie nicht hat, und die übrigen ignoriert die Engine.
stockRuntime/stock_runtime/StockRuntime(oderCLEARCOTE_STOCK_RUNTIME=1) — gibt Playwright für einen Debugging-Lauf das Standardverhalten der DevTools zurück: Console- und Page-Error-Events,page.setContent()undexposeFunction()nach einer Navigation. Standardmäßig aus, weil Seiten es beobachten können; eine Engine ohne den Switch startet ohne ihn, und das SDK warnt einmal. Nur für lokale und Docker-Launches. Siehe Events und Debugging. [154 r32; SDK 0.41.0]personaEnv/persona_env/PersonaEnv— standardmäßig an ab SDK 0.41.0. Die Persona-Switches (der Seed, jeder Persona-Override, Proxy-Zugangsdaten und das Canvas-Bridge-Token) erreichen den Browser über seine Umgebung statt über seine Kommandozeile, die jeder lokale Benutzer in der Prozessliste lesen kann (/proc/<pid>/cmdlineunter Linux, die Prozessdetails unter Windows). Die Engine hält sie auch aus den Kommandozeilen ihrer Hilfsprozesse heraus.falseoderCLEARCOTE_PERSONA_ENV=0belässt sie auf der Kommandozeile, etwa für ein eigenes Tool, das sie dort ausliest. Das Docker-Image macht dasselbe für den Browser des Containers. [154 r32]- Persona-Token — auf dem lizenzierten Chromium-156-Build (ab r51) holt das SDK bei jedem Start eine signierte Persona für Ihren Seed bzw. Ihr Profil vom Clearcote-Persona-Dienst und übergibt sie zusammen mit den obigen Switches an den Browser. Das lässt sich nicht abschalten; ohne Token startet der Browser nicht. Erfordert SDK 0.63.0, Profile Manager 0.27.0 oder das passende Docker-Image. [156 r51; SDK 0.63.0]
- Hell oder dunkel — ab 154 r32 legt die Persona das Farbschema fest (etwa jedes dritte Profil bevorzugt dunkel), und CSS,
matchMedia, der Request-HeaderSec-CH-Prefers-Color-Schemeund die Systemfarben folgen ihm alle. Playwright emuliert in jedem Kontext, den es anlegt, ein helles Schema, was einer dunklen Persona widersprechen würde; deshalb lassen die Kontexte, die ein lokaler Launch anlegt, ab SDK 0.41.0 das Farbschema auf einem solchen Build unangetastet. Übergeben SiecolorScheme/color_scheme/ColorScheme, um trotzdem eines zu emulieren, oder--fingerprint-color-scheme=light|darkinargs, um die Persona selbst hell oder dunkel zu machen. Ein älterer Build behält den Standard von Playwright. [154 r32] allowThirdPartyCookies/allow_third_party_cookies— Drittanbieter-Cookies, standardmäßig erlaubt wie in einem Standard-Chrome (SDK 0.45.0+);falseblockiert sie. Eingebettete Anmelde-, Zahlungs- und Challenge-Frames sind darauf angewiesen. Builds vor 152 r22 blockieren sie immer. [152 r22]transparentProxy/transparent_proxy— verbirgt den Proxy in Request-Headern und im Verbindungs-Timing (reine HTTP-Requests tragen keinen Proxy-Header; Verbindungen über den Proxy melden ein Timing wie eine wiederverwendete Verbindung). Erfordert einen Proxy. [152 r22]fingerprintVoices: false/fingerprint_voices=False— behält die eigenen Sprachausgabe-Stimmen dieses Rechners statt der Liste der Persona. [152 r22]fingerprint: "off"— startet ganz ohne Persona, zur Fehlersuche. [152 r22]socks5Udp/socks5_udp— leitet das UDP von WebRTC über einensocks5://-Proxy, sodass Sprach-, Video- und Peer-Verbindungen funktionieren und trotzdem von der Adresse des Proxys ausgehen. Der Proxy muss das zulassen; viele Residential-Pools tun das nicht. [151 r17]portableProfile/encryptionKey— Profile, die Sie zwischen Rechnern kopieren können (siehe oben). [151 r14; Python, Node & .NET (0.58.0+)]personaSchema/persona_schema— welches Identitätsmodell ein Seed ableitet. Lassen Sie die Option für das aktuelle Modell,7(ausgeliefert seit 2026-10-26, r52), weg: Die Grafikkarte bestimmt die Art des Rechners (Laptop oder Desktop), seinen Prozessor, Threads, Arbeitsspeicher und Bildschirm, jeweils so häufig wie im echten Browser-Traffic.5leitet genau das ab, was r45 bis r51 abgeleitet haben,4das von 154 r37 bis 155 r44,3das von 154 r36 und2das von 153 r29 bis 154 r35; setzen Sie eines davon, um auf diesen Builds erstellte Identitäten zu behalten.1ist das ursprüngliche Modell aus der Zeit vor r29. Ein6gibt es nicht. Ab 0.64.1 akzeptiert jedes SDK 5 und 7. Siehe Derselbe Seed auf verschiedenen Rechnern. Fügen SierealGpuHost/real_gpu_hostnur auf einem Rechner mit echter Grafikkarte hinzu. [151 r19; Python, Node & .NET]shaderDialect: "hlsl"— seit SDK 0.39.0 standardmäßig aktiv für eine Windows-Persona auf einem Linux- oder macOS-Host;falseschaltet die Option ab. Siehe Shader-Dialekt. [151 r15]profile: "auto"— startet statt eines Seeds einen echten erfassten Fingerprint, der für diesen Rechner ausgewählt wird; feinjustieren lässt sich die Auswahl mitprofileSelect/profile_select. Python, Node & .NET (LocalProfile = "auto", 0.58.0+). In Node funktioniert es ab SDK 0.31.1 mit dem Standard-launch(), mitlaunchPersistentContext()und mitserve(); 0.31.0 und älter brauchtenephemeralProfile: falseund scheiterten anserve().
Nicht an einen Engine-Build gebunden:
version/releaseChannel— wählt einen Build; siehe Build auswählen.licenseKey/license_key/LicenseKey— der Lizenzschlüssel, falls er nicht inCLEARCOTE_LICENSE_KEYoder~/.clearcote/license.keyliegt.licenseThroughProxy/license_through_proxy(oderCLEARCOTE_LICENSE_THROUGH_PROXY=1) — schickt die Lizenzaufrufe über den Proxy des Launches statt direkt von diesem Rechner.ephemeralProfile/userDataDirbeilaunch()— siehe den Hinweis unter Über das SDK oben.widevine: true— DRM-Wiedergabe (beide Builds); siehe Widevine & DRM.quiet— unterdrückt die Launch-Warnungen und Fortschrittsausgaben des SDK.fontDirs/font_dirs/FontDirs— Ihre eigenen Schriften unter Linux; siehe unten.
Eigene Schriften unter Linux (fontDirs)
Unter Linux sieht der Browser nur die Schriften, auf die das SDK ihn verweist: das Bundle des Releases mit metrisch kompatiblen Nachbauten der Windows-Schriften (Arial→Arimo, Segoe UI→Selawik, Times New Roman→Tinos, …). Keine auf dem Host installierte Schrift erreicht ihn, also kann nichts auf dem Rechner ändern, was eine Seite misst. Ab SDK 0.41.0 (Python, Node und .NET; launch(), persistente Kontexte und serve()) fügen zwei Einstellungen Verzeichnisse hinzu:
fontDirs/font_dirs/FontDirsoderCLEARCOTE_FONT_DIRS— Ihre eigenen Schriften, typischerweise eine Kopie vonC:\Windows\Fontseines Windows-Rechners, vor dem Bundle eingereiht. Auf dem lizenzierten Build ab 154 r32 wird jede Familie, die sie mitbringen, als sie selbst unter ihrem eigenen Namen gerendert statt als ihr Nachbau, und die Namen, die unter Windows für sie stehen, folgen: Helvetica, Times und Courier sowie die generischen CSS-Familien (sans-serif→ Arial,serif→ Times New Roman,monospace→ Consolas,system-ui→ Segoe UI). Eine ältere Engine zeichnet für die Familien, die eine Persona auflistet, weiterhin ihre Nachbauten und nutzt die Verzeichnisse nur für Zeichen, die sonst keine Schrift abdeckt. Ein Pfad, der kein Verzeichnis ist, lässt den Launch sofort scheitern, noch bevor ein Lizenz-Slot belegt wird.CLEARCOTE_FALLBACK_FONT_DIRS— Schriften, die nur für Zeichen verwendet werden, die sonst keine Schrift abdeckt (CJK, indische Schriftsysteme, Emoji, …), hinter dem Bundle eingereiht. Sie übernehmen keine Familie. Das Docker-Image setzt die Variable auf die Schriften für weitere Schriftsysteme, die es mitliefert.
from clearcote import launch
# a copy of a Windows machine's C:\Windows\Fonts, on the Linux host
browser = launch(fingerprint="acct-1", platform="windows", font_dirs=["/srv/windows-fonts"])
# or: CLEARCOTE_FONT_DIRS=/srv/windows-fonts (several directories: separate them with ":")- Beide Variablen sind durch
:getrennte Listen. Die Familiennamen werden aus den Schriftdateien selbst gelesen, fontconfig-Tools sind also nicht nötig. Richten Sie keine der beiden auf ganz/usr/share/fonts: Dann konkurrieren die lateinischen Familien des Hosts mit dem Bundle und ändern die Breiten, die eine Windows-Persona meldet. clearcote info(Python und Node) meldet unter Linux, welche von 29 Schriftsystemen die Schriften, die ein Launch sehen würde, darstellen können, dazu Ihre Schriftverzeichnisse und welche der wichtigen Windows-Familien sie tatsächlich bereitstellen.- Um die Nachbauten auch mit Ihren aufgeführten Schriften zu behalten, übergeben Sie
--disable-genuine-font-facesinargs(154 r32+). Das SDK erkennt das und lässt seine eigenen Schriftregeln, wie sie sind, sodass Engine und fontconfig bei jeder Familie übereinstimmen. - Unter Windows und macOS, die ihre eigenen Schriften verwenden, wird die Option ignoriert, und für einen Cloud-Launch und den macOS-Docker-Launch wird sie abgelehnt: Mounten Sie in Ihrem eigenen Container die Schriften und setzen Sie dort
CLEARCOTE_FONT_DIRS(siehe Deployment). Verwenden Sie nur Schriften, für die Sie eine Lizenz haben. - Vor 0.41.0 hat das .NET-SDK den Browser überhaupt nicht auf das Bundle verwiesen, ein .NET-Launch unter Linux nutzte also die Schriften des Hosts und keinen der Nachbauten. Es verhält sich jetzt wie Python und Node, was ändert, was eine Windows-Persona dort misst.