跳到正文

Python SDK

Python 库自带浏览器引擎和指纹库,无需桌面应用即可运行。可在爬虫、CI 任务或服务端 worker 中使用。

包: PyPI · shardx (在新标签页中打开)

安装

bash
pip install shardx

快速开始

Python
# pip install shardx  (illustrative; see the SDK readme)
import asyncio
from shardx import ShardX

PROXY = "socks5://user:pass@host:1080"

async def main():
    sdk = ShardX()
    profile = sdk.create_profile("win-rtx4060")
    async with sdk.session(profile, proxy=PROXY) as browser:
        page = await browser.contexts[0].new_page()
        await page.goto("https://browserleaks.com/quic")
        print(await page.title())

asyncio.run(main())

SDK 为你做的事

  • 首次使用时下载引擎和 220 个配置的指纹库,并按 ETag 缓存。
  • 探测代理的 UDP 支持,并据此开启或关闭 QUIC。
  • 启动前根据代理出口国家解析时区、区域设置和地理位置。
  • 每个已保存的配置只随机化一次 CPU、内存和平台版本,保持硬件一致。

Python SDK 不依赖桌面应用。首次使用时,它会将打过补丁的 Chromium 152 引擎、Widevine CDM 和 220 个配置的指纹库下载到本地缓存,然后按需启动隔离的浏览器会话。

会话由 patchright(一个经过隐身补丁的 Playwright)驱动,因此 sdk.session() 直接交回一个就绪的 Browser,无需手动处理 CDP 连接。支持的宿主为 macOS arm64、Windows x64 和 Linux x64。以 root 身份或在 Docker 中启动时,通过 extra_args 传入 --no-sandbox 和 --disable-dev-shm-usage。

阅读 Python 说明文档 (在新标签页中打开)

下载 ShardBrowser

macOS (Apple Silicon)、Windows 和 Linux 的原生应用。

独立 SDK

Python、Node 和 Rust 库自带浏览器引擎,无需桌面应用即可运行。

pip install shardx
了解如何启动 (在新标签页中打开)