Saltar al contenido

Opciones de lanzamiento

Las opciones de lanzamiento que no se tratan en las otras páginas: extensiones, Privacy Sandbox y el resto de la lista.

Más opciones de lanzamiento

  • extensions: una lista de rutas a directorios de extensiones desempaquetadas (genera --load-extension + --disable-extensions-except).
  • disablePrivacySandbox / disable_privacy_sandbox: ponlo en true para desactivar las APIs de Privacy Sandbox (Topics, FLEDGE / Protected Audience, Shared Storage, Private Aggregation, Fenced Frames). Desactivado por defecto desde la 0.23: la persona por defecto se presenta como Google Chrome, que incluye todas ellas. Actívalo solo cuando la persona sea un Chromium sin servicios de Google. WebUSB no se ve afectado.
  • agentTyping / agent_typing: la cadencia de tecleo del agente (human por defecto / fast / instant). Consulta Agente.
  • tlsProfile: mantiene el TLS ClientHello coherente con la versión de Chrome que declara la persona, para que la capa de red siga al UA (y no al TLS nativo del build). El valor por defecto, "match-persona", sigue a brandVersion; "native" lo deja sin tocar; "chrome-<major>" fija una versión mayor. Consulta Flags de huella digital.
  • platform: "android": una persona móvil en la medida de lo posible (táctil, puntero grueso, pantalla/DPR móvil, WebGL Mali/Adreno, viewport de teléfono). En un motor de escritorio, el renderizado de la GPU sigue siendo de escritorio; combínalo con el canvas bridge para lograr coherencia de renderizado.
  • storageQuota, fingerprintProfile, canvasBridge, webrtcIp, acceptLanguage, disableGpuFingerprint, fingerprintNoise: consulta Flags de huella digital.

Opciones más recientes (build con licencia)

Estas opciones necesitan el build con licencia (Gratis con GitHub o Pro). Entre corchetes se indica la revisión del motor que necesita cada una; con un motor más antiguo, el SDK omite las de 152 r22 con una advertencia, comprueba en el motor cada una de las de 154 r32 y la deja desactivada si el build no la tiene, y el motor ignora el resto.

  • stockRuntime / stock_runtime / StockRuntime (o CLEARCOTE_STOCK_RUNTIME=1): le devuelve a Playwright el comportamiento estándar de DevTools para una ejecución de depuración: eventos de consola y de errores de página, page.setContent() y exposeFunction() después de una navegación. Desactivado por defecto, porque las páginas pueden observarlo; un motor sin el switch lanza sin él y el SDK avisa una vez. Solo para lanzamientos locales y en Docker. Consulta Eventos y depuración. [154 r32; SDK 0.41.0]
  • personaEnv / persona_env / PersonaEnv: activado por defecto desde el SDK 0.41.0. Los switches de la persona (el seed, cada override de la persona, las credenciales del proxy y el token del canvas bridge) llegan al navegador a través de su entorno y no de su línea de comandos, que cualquier usuario local puede leer en la lista de procesos (/proc/<pid>/cmdline en Linux, los detalles del proceso en Windows). El motor también los mantiene fuera de las líneas de comandos de sus procesos auxiliares. false o CLEARCOTE_PERSONA_ENV=0 los deja en la línea de comandos, por ejemplo para una herramienta tuya que los lee ahí. La imagen de Docker hace lo mismo con el navegador del contenedor. [154 r32]
  • Token de persona — en la compilación licenciada de Chromium 156 (r51 y posteriores) el SDK obtiene en cada lanzamiento una persona firmada para tu seed o perfil desde el servicio de personas de Clearcote y la pasa al navegador junto con los switches anteriores. No se puede desactivar; sin ella el navegador no arranca. Requiere SDK 0.63.0, Profile Manager 0.27.0 o la imagen Docker correspondiente. [156 r51; SDK 0.63.0]
  • Claro u oscuro: desde 154 r32, la persona decide el esquema de colores (cerca de un perfil de cada tres prefiere el oscuro), y CSS, matchMedia, el header de solicitud Sec-CH-Prefers-Color-Scheme y los colores del sistema lo siguen. Playwright emula el modo claro en cada contexto que crea, lo que contradiría a una persona oscura, así que desde el SDK 0.41.0 los contextos que crea un lanzamiento local no tocan el esquema de colores en un build así. Pasa colorScheme / color_scheme / ColorScheme para emular uno de todos modos, o --fingerprint-color-scheme=light|dark en args para que la propia persona sea clara u oscura. Un build más antiguo mantiene el valor por defecto de Playwright. [154 r32]
  • allowThirdPartyCookies / allow_third_party_cookies: cookies de terceros, permitidas por defecto como en Chrome estándar (SDK 0.45.0+); false las bloquea. Los frames embebidos de inicio de sesión, de pago y de desafío dependen de ellas. Los builds anteriores a 152 r22 siempre las bloquean. [152 r22]
  • transparentProxy / transparent_proxy: oculta el proxy en los headers de las solicitudes y en los tiempos de conexión (las solicitudes HTTP sin cifrar no llevan ningún header de proxy; las conexiones a través del proxy reportan tiempos como los de una conexión reutilizada). Necesita un proxy. [152 r22]
  • fingerprintVoices: false / fingerprint_voices=False: conserva las voces de síntesis de esta máquina en lugar de la lista de la persona. [152 r22]
  • fingerprint: "off": lanza sin ninguna persona, para diagnosticar problemas. [152 r22]
  • socks5Udp / socks5_udp: lleva el UDP de WebRTC a través de un proxy socks5://, para que las conexiones de voz, video y peer-to-peer funcionen y sigan saliendo desde la dirección del proxy. El proxy tiene que permitirlo; muchos pools residenciales no lo hacen. [151 r17]
  • portableProfile / encryptionKey: perfiles que puedes copiar entre máquinas (ver arriba). [151 r14; Python, Node & .NET (0.58.0+)]
  • personaSchema / persona_schema: qué modelo de identidad deriva un seed. Déjalo sin definir para usar el modelo actual, 7 (servido desde 2026-10-26, r52): la tarjeta gráfica determina el tipo de máquina (portátil o de escritorio), su procesador, hilos, memoria y pantalla, cada uno tan común como en el tráfico real de navegadores. 5 deriva exactamente lo que derivaban r45 a r51, 4 lo que derivaban 154 r37 a 155 r44, 3 lo que derivaba 154 r36 y 2 lo que derivaban 153 r29 a 154 r35; define uno para conservar las identidades creadas con esos builds. 1 es el modelo original, anterior a r29. No existe el 6. Todos los SDK aceptan 5 y 7 desde 0.64.1. Consulta el mismo seed en máquinas distintas. Agrega realGpuHost / real_gpu_host solo en una máquina con una tarjeta gráfica real. [151 r19; Python, Node & .NET]
  • shaderDialect: "hlsl": activado por defecto para una persona de Windows en un host Linux o macOS desde el SDK 0.39.0; false lo desactiva. Consulta Dialecto de shaders. [151 r15]
  • profile: "auto": lanza una huella digital real capturada, elegida para esta máquina, en lugar de un seed; ajústala con profileSelect / profile_select. Python, Node & .NET (LocalProfile = "auto", 0.58.0+). En Node funciona con launch() por defecto, launchPersistentContext() y serve() a partir del SDK 0.31.1; con 0.31.0 y anteriores hacía falta ephemeralProfile: false y fallaba con serve().

No dependen de un build del motor:

  • version / releaseChannel: elige un build; consulta cómo elegir un build.
  • licenseKey / license_key / LicenseKey: la clave de licencia, si no está en CLEARCOTE_LICENSE_KEY ni en ~/.clearcote/license.key.
  • licenseThroughProxy / license_through_proxy (o CLEARCOTE_LICENSE_THROUGH_PROXY=1): envía las llamadas de licencia a través del proxy del lanzamiento en lugar de hacerlas desde esta máquina.
  • ephemeralProfile / userDataDir en launch(): consulta la nota de Con el SDK, más arriba.
  • widevine: true: reproducción con DRM (ambos builds); consulta Widevine & DRM.
  • quiet: silencia las advertencias de lanzamiento y la salida de progreso del SDK.
  • fontDirs / font_dirs / FontDirs: tus propias fuentes en Linux; consulta más abajo.

Tus propias fuentes en Linux (fontDirs)

En Linux, el navegador solo ve las fuentes a las que lo dirige el SDK: el conjunto de la versión, con fuentes parecidas a las de Windows y métricamente compatibles (Arial→Arimo, Segoe UI→Selawik, Times New Roman→Tinos, …). Ninguna fuente instalada en el host le llega, así que nada en la máquina puede cambiar lo que mide una página. Desde el SDK 0.41.0 (Python, Node y .NET; launch(), contextos persistentes y serve()), dos ajustes agregan directorios:

  • fontDirs / font_dirs / FontDirs, o CLEARCOTE_FONT_DIRS: tus propias fuentes, normalmente una copia de C:\Windows\Fonts de una máquina Windows, que se listan antes del conjunto. En el build con licencia desde 154 r32, cada familia que aportan se renderiza como ella misma, con su propio nombre, en lugar de su fuente parecida, y los nombres que la representan en Windows la siguen: Helvetica, Times y Courier, y las genéricas de CSS (sans-serif → Arial, serif → Times New Roman, monospace → Consolas, system-ui → Segoe UI). Un motor más antiguo sigue dibujando sus fuentes parecidas para las familias que lista una persona, y usa los directorios solo para los caracteres que ninguna otra fuente cubre. Una ruta que no es un directorio hace fallar el lanzamiento de inmediato, antes de ocupar un slot de licencia.
  • CLEARCOTE_FALLBACK_FONT_DIRS: fuentes que se usan solo para los caracteres que ninguna otra fuente cubre (CJK, escrituras índicas, emoji, …), listadas después del conjunto. No sustituyen a ninguna familia. La imagen de Docker la define con las fuentes de escrituras que incluye.
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 ":")
  • Las dos variables son listas separadas por :. Los nombres de familia se leen de los propios archivos de fuentes, así que no hacen falta las herramientas de fontconfig. Nunca apuntes ninguna de las dos a todo /usr/share/fonts: las familias latinas del host competirían con el conjunto y cambiarían los anchos que reporta una persona de Windows.
  • clearcote info (Python y Node) indica, en Linux, cuáles de 29 sistemas de escritura pueden dibujar las fuentes que vería un lanzamiento, tus directorios de fuentes y cuáles de las familias clave de Windows aportan de verdad.
  • Para conservar las fuentes parecidas aunque hayas indicado tus fuentes, pasa --disable-genuine-font-faces en args (154 r32+). El SDK lo detecta y deja sus propias reglas de fuentes como están, para que el motor y fontconfig coincidan en cada familia.
  • Se ignora en Windows y macOS, que usan sus propias fuentes, y se rechaza en un lanzamiento en la nube y en el lanzamiento de Docker en macOS: en tu propio contenedor, monta las fuentes y define CLEARCOTE_FONT_DIRS ahí (consulta Despliegue). Usa solo fuentes para las que tengas licencia.
  • Antes de la 0.41.0, el SDK de .NET no dirigía el navegador al conjunto en absoluto, así que un lanzamiento de .NET en Linux usaba las fuentes del host y ninguna de las fuentes parecidas. Ahora coincide con Python y Node, lo que cambia lo que mide ahí una persona de Windows.