RustTLSX 🦀

. 一个面向 Rust 的高级隐身 HTTP 客户端。

专为注重隐私的开发者打造，让你能够完全掌控自己的网络指纹。

看起来像浏览器。行为像浏览器。用 Rust 编写。

致谢与基础

基于 bogdanfinn/tls-client 构建 —— 这是业界领先的 TLS 指纹库，受到全球安全专业人士的信赖。我们通过 FFI 绑定使用 bogdanfinn 久经考验的共享库（.dll/.so/.dylib），原因如下：

• 多年研究：数千小时打磨浏览器 TLS 行为的复现
• 久经考验：被全球安全公司和隐私工具用于生产环境
• 持续更新：定期更新以匹配不断演进的浏览器指纹
• 性能优化：原生 C/Go 实现，速度最大化

RustTLSX 以类型安全、人性化的 API 将这一成熟技术带入 Rust，其速度比 Python 替代方案快 6 倍。

RustTLSX 为何存在

现代 Web 应用会分析你 HTTP 请求的方方面面——不仅是请求头和 Cookie，还包括 TLS 握手的深层加密签名。标准 Rust HTTP 客户端（reqwest、hyper、ureq）会生成容易被检测的模式，从而立即识别出自动化流量。

RustTLSX 通过以下方式解决这一问题：

• 完美浏览器模仿：来自真实浏览器的正宗 TLS 指纹
• 请求修改控制：对请求头、Cookie 和时机的细粒度控制
• 隐私设计：你的流量看起来就像是合法的浏览器会话
• 性能领先：显著快于任何替代方案

核心能力

隐私与请求控制

• 真实浏览器身份：完美复现 Chrome、Firefox、Safari 和 Opera 的 TLS 签名
• 请求头操控：完全控制请求头、User-Agent 和 Accept 参数
• Cookie 管理：支持持久化 Cookie 的高级会话处理
• 时机控制：可配置的请求间隔与连接池
• 协议选择：支持 HTTP/1.1 和 HTTP/2，并带有与浏览器一致的偏好

性能优势

• 比 Python 快 6 倍：原生 Rust 性能，尽可能采用零拷贝操作
• 内存高效：与标准 HTTP 客户端相比开销极小
• 并发请求：针对高吞吐场景优化
• 连接复用：匹配浏览器行为的智能连接池

高级特性

• 30+ 浏览器配置文件：大量真实浏览器指纹集合
• 类型安全：完整的 Rust 编译期保证，配合全面的错误处理
• 跨平台：支持 Windows、Linux 和 macOS
• 绕过防护：作为完美模仿的副产品，可绕过检测系统

快速开始

前置条件

从 tls-client releases 下载适用于你平台所需的 TLS 客户端库：

• Windows：tls-client-windows-64-1.3.3.dll
• Linux：tls-client-linux-ubuntu-amd64-1.3.3.so
• macOS：tls-client-darwin-amd64-1.3.3.dylib

将库文件放在项目根目录、系统库路径（/usr/local/lib/）中，或确保可通过 PATH 访问。

安装

将 RustTLSX 添加到你的 Cargo.toml：

[dependencies]
rust-tlsx = "0.1"

基本用法

use rust_tlsx::{TlsClient, BrowserProfile};

fn main() -> anyhow::Result<()> {
    let client = TlsClient::new(BrowserProfile::Firefox120)
        .header("User-Agent", "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:120.0) Gecko/20100101 Firefox/120.0")
        .timeout(30);
    
    let response = client.get("https://example.com")?;
    
    println!("Status: {}", response.status);
    println!("Body: {}", response.body);
    
    Ok(())
}

可用的浏览器配置文件

RustTLSX 支持跨主流浏览器的 30 多种浏览器配置文件：

// Chrome versions
BrowserProfile::Chrome103
BrowserProfile::Chrome107  
BrowserProfile::Chrome109
BrowserProfile::Chrome120

// Firefox versions
BrowserProfile::Firefox102
BrowserProfile::Firefox105
BrowserProfile::Firefox108
BrowserProfile::Firefox120

// Safari versions
BrowserProfile::Safari15_6_1
BrowserProfile::Safari16_0
BrowserProfile::SafariIos16_0

// Opera and others
BrowserProfile::Opera89
BrowserProfile::Opera90

高级用法

自定义请求头与 Cookie

let client = TlsClient::new(BrowserProfile::Chrome109)
    .header("Accept", "application/json")
    .header("Accept-Language", "en-US,en;q=0.9")
    .cookie("session", "abc123")
    .cookie("token", "xyz789");

let response = client.get("https://api.example.com")?;

POST 请求

let body = r#"{"username": "user", "password": "pass"}"#;
let response = client.post("https://example.com/login", Some(body.to_string()))?;

请求超时

let client = TlsClient::new(BrowserProfile::Firefox120)
    .timeout(60); // seconds

let response = client.get("https://slow-api.example.com")?;

架构与设计理念

我们为何使用 bogdanfinn 的共享库

RustTLSX 建立在久经验证的卓越基础之上，而不是重复造轮子。我们通过 FFI 使用 bogdanfinn 编译好的库（.dll/.so/.dylib），原因如下：

研究投入：Bogdanfinn 投入了数千小时逆向工程浏览器 TLS 行为。重复这项研究需要数年时间，而且很可能得到较差的结果。

久经考验的可靠性：这些库被全球主要安全公司、隐私工具和研究机构使用。它们已经过所有主要防护系统的测试。

持续演进：浏览器指纹不断变化。Bogdanfinn 的库会定期更新，以匹配新的浏览器版本和防护系统更新。

性能优化：原生 C/Go 实现对速度和内存效率进行了深度优化，提供了纯 Rust 实现无法企及的性能。

技术实现

运行时动态加载：使用 FFI 按需加载库，消除了静态链接的复杂性，同时保持性能。

内存管理：Rust 的所有权模型确保了与原生库的安全交互，防止了 C/C++ 实现中常见的内存泄漏和释放后使用（use-after-free）错误。

错误处理：基于 Result 的全面错误处理在保持类型安全的同时提供详细的诊断信息。

连接管理：对 TLS 连接进行智能池化与复用，行为模式与浏览器一致。

所处理的指纹组件

底层库管理浏览器 TLS 行为的方方面面：

• 密码套件排序：精确复现浏览器的密码套件偏好
• TLS 扩展处理：所有 TLS 扩展的正确排序与取值
• HTTP/2 设置：匹配浏览器行为的帧处理与设置
• 证书验证：与浏览器一致的证书链验证
• 会话管理：正确的 TLS 会话恢复与票据处理
• ALPN 协商：与应用层协议协商（ALPN）匹配浏览器

示例

基本 HTTP 请求

use rust_tlsx::{TlsClient, BrowserProfile};

fn main() -> anyhow::Result<()> {
    let client = TlsClient::new(BrowserProfile::Chrome109);
    let response = client.get("https://httpbin.org/get")?;
    
    println!("Status: {}", response.status);
    println!("Body: {}", response.body);
    
    Ok(())
}

TLS 指纹验证

use rust_tlsx::{TlsClient, BrowserProfile};

fn main() -> anyhow::Result<()> {
    let client = TlsClient::new(BrowserProfile::Firefox120);
    let response = client.get("https://tls.peet.ws/api/all")?;
    
    println!("TLS Fingerprint Analysis:\n{}", response.body);
    
    Ok(())
}

带认证的请求

use rust_tlsx::{TlsClient, BrowserProfile};

fn main() -> anyhow::Result<()> {
    let client = TlsClient::new(BrowserProfile::Chrome109)
        .header("Authorization", "Bearer YOUR_TOKEN")
        .header("Content-Type", "application/json");
    
    let response = client.get("https://api.example.com/data")?;
    
    match response.status {
        200 => println!("Success: {}", response.body),
        401 => eprintln!("Authentication failed"),
        _ => eprintln!("Request failed with status {}: {}", response.status, response.body),
    }
    
    Ok(())
}

注重隐私的网页抓取

use rust_tlsx::{TlsClient, BrowserProfile};

fn main() -> anyhow::Result<()> {
    // Create a client that appears as a real Firefox browser
    let client = TlsClient::new(BrowserProfile::Firefox120)
        .header("User-Agent", "Mozilla/5.0 (Windows NT 10.0; Win64; x64; rv:120.0) Gecko/20100101 Firefox/120.0")
        .header("Accept", "text/html,application/xhtml+xml,application/xml;q=0.9,image/avif,image/webp,*/*;q=0.8")
        .header("Accept-Language", "en-US,en;q=0.5")
        .header("Accept-Encoding", "gzip, deflate, br")
        .header("DNT", "1") // Privacy-focused: Do Not Track
        .timeout(30);
    
    // Include session cookies for authenticated requests
    let client = client.cookie("session_id", "your_session_token");
    
    let response = client.get("https://example-site.com/data")?;
    
    match response.status {
        200 => println!("Data retrieved successfully with browser-like privacy"),
        403 => println!("Authentication required - check session cookies"),
        _ => println!("Response: {}", response.status),
    }
    
    Ok(())
}

高级请求修改

use rust_tlsx::{TlsClient, BrowserProfile};
use std::collections::HashMap;

fn main() -> anyhow::Result<()> {
    // Simulate a specific browser environment
    let mut headers = HashMap::new();
    headers.insert("User-Agent".to_string(), 
        "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36".to_string());
    headers.insert("Sec-Fetch-Site".to_string(), "same-origin".to_string());
    headers.insert("Sec-Fetch-Mode".to_string(), "navigate".to_string());
    headers.insert("Sec-Fetch-Dest".to_string(), "document".to_string());
    
    let client = TlsClient::new(BrowserProfile::Chrome120)
        .headers(headers)
        .timeout(45);
    
    // Make request that's indistinguishable from real browser
    let response = client.get("https://api.example.com/sensitive-data")?;
    
    println!("Retrieved data with perfect browser mimicry");
    println!("Protocol used: {}", response.used_protocol);
    
    Ok(())
}

为什么 RustTLSX 胜过所有替代方案

Rust HTTP 客户端对比

与所有标准 Rust HTTP 客户端相比，RustTLSX 提供卓越的性能与隐私保护：