选项与身份

启动托管浏览器时可以设置的内容：各项选项、默认隐匿设置与身份、让你保持登录的 Profile、固定版本和起始页。

选项

以下选项均为可选，作为创建调用的 JSON 请求体发送。

默认隐匿设置与身份

每个会话都以推荐设置页面中的配置为起点：开启 lightStealth、使用一个种子（seed），时区和语言跟随出口 IP。在 lightStealth（默认）模式下，种子会从一小组设备配置中选出一个，这些配置在 CPU 核心数、内存和像素比上各不相同；canvas、WebGL 和音频则保持会话所在机器本身的值。设置 lightStealth: false 可获得完整的、按种子生成的身份画像（persona）：canvas 和 WebGL 的像素读回会带上由种子派生、按站点区分的噪声，GPU 字符串、屏幕和音频设置（采样率、延迟）也都跟随身份画像。如果不指定 identity 或 fingerprint，每个会话都会得到一个随机种子和一个新 IP。

传入 identity: "account-42"，之后的会话就会以同一个设备配置回来，并且只要该住宅 IP 仍然在线，就使用同一个 IP——这正是已登录账号所期望的。身份只在你的账号内有效：其他客户即使使用相同的标签，也会得到他们自己的种子和 IP。身份本身不会保留 cookie；如需保留，请使用 Profile。

Profile：只需登录一次

Profile 会以一个名称保存会话的 cookie、localStorage 和 IndexedDB，之后使用该名称的会话启动时就已处于登录状态。传入 profile: { name: "shop-account", persist: true } 会加载它，并在会话结束时保存回去；只传 profile: "shop-account" 则以只读方式加载。使用新名称的第一个会话从空白状态开始，并创建该 Profile。

// Every run: the same body. The first one starts signed out; sign in, then close the browser
// and the session saves the cookies and site storage. Every later run starts signed in.
const res = await fetch("https://www.clearcotelabs.com/api/v1/browsers", {
  method: "POST",
  headers: { authorization: "Bearer cc_live_...", "content-type": "application/json" },
  body: JSON.stringify({ profile: { name: "shop-account", persist: true }, country: "de" }),
});

• 同一设备，同一 IP。Profile 自带身份（profile:<name>），因此站点看到的是同一个指纹；只要该住宅 IP 仍在线，看到的也是同一个 IP，就像一位回头客。如需另作选择，可自行传入 identity 或 fingerprint，并在多次运行之间保持国家不变。
• 同一时间只有一个写入者。同一 Profile 只允许一个正在运行的会话写入；第二个带 persist: true 的会话会收到 409 PROFILE_IN_USE。只读会话可以同时运行，看到的是最后一次保存的状态。
• 在会话结束时保存，无论是你关闭浏览器、断开连接、停止会话，还是因达到某项限制而结束。如果浏览器崩溃，会保留上一次保存的状态，而不会被不完整的状态覆盖。会话 cookie（没有过期时间的 cookie）会被丢弃，就像真实浏览器重启时会丢弃它们一样。
• 压缩后最多约 3.5 MB。如果某个站点的 IndexedDB 使其超出这一大小，IndexedDB 将不予保存；cookie 和 localStorage 仍会保存。
• 私有。Profile 只属于你（其他客户的“shop-account”是另一个 Profile），加密存储，并且只会交给运行你会话的服务器。用 GET /api/v1/browsers/profiles 列出，用 DELETE /api/v1/browsers/profiles/<name> 删除，也可以使用仪表盘。

已经在别处登录了？Cookie 同步会把这些 Cookie 复制到配置文件中，这样第一个会话一开始就是登录状态。

固定版本

会话运行的是当前的 Clearcote 版本。要运行旧版本，请传入 version：可以是完整版本号（"152.0.7977.82-r21"）、仅重建编号（"r21"）、Chromium 版本号或主版本号（"152" 会选择该主版本的最新构建），或 "latest"。这些版本与 SDK 的 version 选项下载的是同一批，因此固定到同一版本的托管会话和本地运行使用的是同一个构建。

const res = await fetch("https://www.clearcotelabs.com/api/v1/browsers", {
  method: "POST",
  headers: { authorization: "Bearer cc_live_...", "content-type": "application/json" },
  body: JSON.stringify({ identity: "account-1", version: "152.0.7977.82-r21" }),
});
const { connectUrl, engine, warnings } = await res.json();
// engine   -> { version: "152.0.7977.82", revision: "r21", pinned: true }
// warnings -> [ "This session runs 152.0.7977.82-r21, older than the current ... " ]

• 检查 warnings。旧版本不具备后续版本新增的内容。在它之后才加入的选项和修复可能缺失，或者被静默忽略而不是报错拒绝，因此在当前版本上有效的设置，在固定的旧版本上可能悄无声息地不起任何作用。
• 无论是否固定版本，响应中的 engine 都会说明会话运行的是哪个版本。
• 指定不存在的版本会返回 400，错误码为 UNKNOWN_VERSION，错误信息中会列出可选的版本。
• 如果某个版本我们的服务器还没有用过，该版本上的第一个会话在获取构建期间，启动时间最多可能多出一分钟。之后该版本上的会话启动速度与其他会话一样快。

起始页与广告拦截

• url 会在你连接之前就在第一个标签页中打开一个页面，这样你的脚本接入时，页面已经在加载了。
• adblock: true 会在请求发出之前拒绝发往知名广告、广告验证和统计分析主机的请求，因此这些请求不会计费。该列表刻意保持保守（标签管理器、授权同意工具、登录 SDK 和 CAPTCHA 都不受影响），但少数网站会察觉到广告缺失；在这类场景下请保持关闭。