跳到正文

Rust SDK

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

包: crates.io · shardx (在新标签页中打开)

安装

bash
cargo add shardx

快速开始

Rust
// cargo add shardx  (illustrative; see the crate readme)
use shardx::{LaunchOptions, ShardX, ShardXOptions};

#[tokio::main]
async fn main() -> anyhow::Result<()> {
    let sdk = ShardX::new(ShardXOptions::default())?;
    let profile = sdk.create_profile(Some("win-rtx4060")).await?;
    let session = sdk.session(profile, LaunchOptions {
        proxy: Some("socks5://user:pass@host:1080".into()),
        ..Default::default()
    }).await?;
    let page = session
        .new_page("https://browserleaks.com/quic")
        .await?;
    println!("{:?}", page.get_title().await?);
    session.close().await
}

SDK 为你做的事

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

Rust crate 与 Python 和 Node SDK 拥有相同的接口:首次使用时,它会将引擎、Widevine CDM 和内置指纹库下载到每用户缓存中,然后使用与桌面应用相同的伪装参数启动隔离的配置。

启用默认的 control 特性时,session() 会在一次调用中启动引擎并附加一个 chromiumoxide CDP 浏览器。禁用该特性可获得更轻量的构建,并使用 launch_cdp 获取 cdp_url 供你自己的客户端使用。支持的宿主为 macOS arm64、Windows x64 和 Linux x64。

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

下载 ShardBrowser

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

独立 SDK

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

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