Node SDK
Node 库自带浏览器引擎和指纹库，无需桌面应用即可运行。可在爬虫、CI 任务或服务端 worker 中使用。
安装
bash
npm install @proxyshard/shardx快速开始
Node
// npm i @proxyshard/shardx (illustrative; see the SDK readme)
import { ShardX } from "@proxyshard/shardx";
const sdk = new ShardX();
const profile = await sdk.createProfile("win-rtx4060");
const { browser, close } = await sdk.session(profile, {
proxy: "socks5://user:pass@host:1080",
});
try {
const page = await browser.contexts()[0].newPage();
await page.goto("https://browserleaks.com/quic");
console.log(await page.title());
} finally {
await close();
}SDK 为你做的事
- 首次使用时下载引擎和 220 个配置的指纹库，并按 ETag 缓存。
- 探测代理的 UDP 支持，并据此开启或关闭 QUIC。
- 启动前根据代理出口国家解析时区、区域设置和地理位置。
- 每个已保存的配置只随机化一次 CPU、内存和平台版本，保持硬件一致。
Node SDK 是一个不依赖桌面应用的 TypeScript 库。首次使用时，它会将打过补丁的 Chromium 152 引擎、Widevine CDM 和 220 个配置的指纹库下载到本地缓存，然后按需启动隔离的浏览器会话。
会话由 patchright（一个经过隐身补丁的 Playwright）驱动，因此 sdk.session() 返回一个就绪的 Browser，以及一个同时关闭客户端和引擎的 close()。需要 Node 18 或更新版本；支持的宿主为 macOS arm64、Windows x64 和 Linux x64。