跳到正文

从 puppeteer-extra-plugin-stealth 迁移

保留 Puppeteer,去掉插件。Clearcote 启动浏览器时,指纹已在引擎中设置好,Puppeteer 直接连接上去。你的页面代码保持不变。

改动

import puppeteer from "puppeteer-extra";
import StealthPlugin from "puppeteer-extra-plugin-stealth";
import puppeteer from "puppeteer-core";
import { serve } from "clearcote";

puppeteer.use(StealthPlugin());
const browser = await puppeteer.launch({ args: ["--proxy-server=http://proxy.example:8080"] });
const srv = await serve({
  fingerprint: "acct-1",               // one seed per account: the same device every run
  proxy: { server: "http://proxy.example:8080", username: "user", password: "pass" },
  geoip: true,                         // timezone, language and WebRTC follow the exit IP
});
const browser = await puppeteer.connect({ browserURL: srv.cdpUrl, defaultViewport: null });
const page = await browser.newPage();
await page.authenticate({ username: "user", password: "pass" });
await page.setUserAgent("Mozilla/5.0 ...");
await page.goto("https://example.com");
await browser.close();
await browser.disconnect();
await srv.close();                     // stops the browser and removes its temporary profile

用 npm install clearcote puppeteer-core 安装。serve() 首次使用时会下载经过校验的构建,并在本机回环地址上带 CDP 端点启动它。请保留 defaultViewport: null:没有它,Puppeteer 会把每个页面调整为 800×600,与身份画像 (persona) 给浏览器设定的窗口不再一致。

其他改动

使用插件时使用 Clearcote
page.emulateTimezone(), --lang配合代理使用 geoip: true,或者 timezone 和 acceptLanguage
page.setViewport()删除
evaluateOnNewDocument 规避代码片段删除。用脚本修改 navigator 或 WebGL,恰恰是页面要找的痕迹
userDataDirserve() 的 userDataDir(默认是临时配置文件,关闭时删除)
其他 puppeteer-extra 插件,例如广告拦截器保留:puppeteer-extra 包装 connect() 的方式与包装 launch() 相同。只去掉 stealth 插件

或者改用 Playwright

SDK 的 launch() 直接返回 Playwright Browser,并提供拟人化的鼠标、键盘和滚动(humanize: true),而通过 CDP 连接的客户端没有这项功能。page.goto、page.evaluate 和 page.screenshot 保持不变;page.$(sel) 改为 page.locator(sel),Playwright 会自动等待元素。

javascript
import { launch } from "clearcote";

const browser = await launch({ fingerprint: "acct-1", humanize: true });
const page = await browser.newPage();
await page.goto("https://example.com");
await page.locator("text=More information").click();   // moves and clicks like a person
await browser.close();

检查切换结果

npx clearcote info 会输出 SDK 解析到的构建以及启动测试结果。没有许可证密钥时就是开源版构建(BSD-3,无需账号);带用户名和密码的代理需要最新构建,通过 GitHub 登录即可免费获得(npx clearcote login)。然后分别在旧环境和新环境中打开 audit 页面。对比:Clearcote vs puppeteer-extra-plugin-stealth。

更新于 2026年10月20日 · SDK 0.70.5 · 浏览器 r63

这个页面有帮助吗?