跳到正文

启动选项

其他页面没有涉及的启动选项：扩展、Privacy Sandbox，以及列表中的其余选项。

更多启动选项

  • extensions——未打包扩展的目录路径列表（会生成 --load-extension + --disable-extensions-except）。
  • disablePrivacySandbox / disable_privacy_sandbox——设为 true 可关闭 Privacy Sandbox API（Topics、FLEDGE / Protected Audience、Shared Storage、Private Aggregation、Fenced Frames）。自 0.23 起此选项默认关闭：默认身份画像呈现为 Google Chrome，而 Google Chrome 提供了上述所有 API。只有当身份画像是去 Google 化的 Chromium 时才开启它。WebUSB 不受影响。
  • agentTyping / agent_typing——智能体的击键节奏（默认 human / fast / instant）。参见智能体。
  • tlsProfile——让 TLS ClientHello 与身份画像声称的 Chrome 版本保持一致，使网络层跟随 UA（而不是构建自身原生的 TLS）。默认值 "match-persona" 跟随 brandVersion；"native" 保持原样不做改动；"chrome-<major>" 固定为某个主版本。参见指纹参数。
  • platform: "android"——尽力而为的移动端身份画像（触控、粗略指针、移动端屏幕/DPR、Mali/Adreno WebGL、手机视口）。在桌面引擎上，GPU 渲染仍然是桌面端的——请搭配 canvas bridge 实现渲染一致性。
  • storageQuota、fingerprintProfile、canvasBridge、webrtcIp、acceptLanguage、disableGpuFingerprint、fingerprintNoise——参见指纹参数。

较新的选项（授权版构建）

以下选项需要授权版构建（GitHub 免费版或 Pro）。方括号中是各选项所需的引擎修订版本；在较旧的引擎上，SDK 会跳过标注 152 r22 的选项并给出警告，其余选项则会被引擎忽略。

  • allowThirdPartyCookies / allow_third_party_cookies——像原版 Chrome 一样允许第三方 Cookie。去 Google 化的底座默认会阻止第三方 Cookie，导致依赖它们的嵌入式登录、支付和验证框架无法正常工作。[152 r22]
  • transparentProxy / transparent_proxy——在请求头和连接时序中隐藏代理（纯 HTTP 请求不携带代理请求头；经代理的连接上报的时序与复用连接相同）。需要配合代理使用。[152 r22]
  • fingerprintVoices: false / fingerprint_voices=False——保留本机自己的语音，而不使用身份画像的语音列表。[152 r22]
  • fingerprint: "off"——完全不使用身份画像启动，用于排查问题。[152 r22]
  • socks5Udp / socks5_udp——让 WebRTC 的 UDP 流量经由 socks5:// 代理传输，这样语音、视频和点对点连接都能正常工作，而且仍然从代理的地址发出。代理必须允许这样做；很多住宅代理池并不允许。[151 r17]
  • portableProfile / encryptionKey——可在机器之间复制的 profile（见上文）。[151 r14；Python & Node]
  • personaSchema: 2 / persona_schema=2——一种可选的身份模型，其中屏幕和显卡芯片与身份画像声称的处理器和内存相匹配。默认关闭，因此每个现有种子都保持原来的身份。只在配有真实显卡的机器上添加 realGpuHost / real_gpu_host。[151 r19；Python & Node]
  • shaderDialect: "hlsl"——参见着色器方言。[151 r15]
  • profile: "auto"——启动一个为本机挑选的真实采集指纹，而不是使用种子；可以用 profileSelect / profile_select 调整。支持 Python & Node。在 Node 中，从 SDK 0.31.1 起它可用于默认的 launch()、launchPersistentContext() 和 serve()；0.31.0 及更早版本需要 ephemeralProfile: false，且配合 serve() 使用时会失败。

与引擎构建无关的选项：

  • version / releaseChannel——选择构建；参见选择构建。
  • licenseKey / license_key / LicenseKey——许可证密钥（如果它不在 CLEARCOTE_LICENSE_KEY 或 ~/.clearcote/license.key 中）。
  • licenseThroughProxy / license_through_proxy（或 CLEARCOTE_LICENSE_THROUGH_PROXY=1）——通过本次启动所用的代理发送许可证请求，而不是从本机直接发出。
  • launch() 上的 ephemeralProfile / userDataDir——参见上文使用 SDK 一节中的说明。
  • widevine: true——DRM 播放（两种构建均支持）；参见 Widevine & DRM。
  • quiet——关闭 SDK 的启动警告和进度输出。