Rust匿名网络库tor-hsclient使用指南

介绍

tor-hsclient是Rust生态中用于与Tor隐藏服务(.onion服务)交互的库，它提供了安全、隐私保护的Tor网络访问能力。该库是arti项目的一部分，旨在为Rust开发者提供简单易用的Tor功能集成。

主要特点：

• 支持通过Tor网络访问.onion隐藏服务
• 提供隐私保护的网络请求功能
• 可集成到现有Rust网络应用中
• 支持异步操作

安装

在Cargo.toml中添加依赖：

[dependencies]
tor-hsclient = "0.1"  # 请使用最新版本
tokio = { version = "1.0", features = ["full"] }

基本使用方法

1. 创建Tor客户端

use tor_hsclient::{HsClientConnector, HsClientError};
use tokio::io::{AsyncReadExt, AsyncWriteExt};

#[tokio::main]
async fn main() -> Result<(), HsClientError> {
    // 创建Tor客户端连接器
    let connector = HsClientConnector::new().await?;
    
    // 连接到.onion服务
    let mut stream = connector.connect("example.onion:80").await?;
    
    // 发送HTTP请求
    stream.write_all(b"GET / HTTP/1.1\r\nHost: example.onion\r\n\r\n").await?;
    
    // 读取响应
    let mut response = Vec::new();
    stream.read_to_end(&mut response).await?;
    
    println!("Response: {}", String::from_utf8_lossy(&response));
    
    Ok(())
}

2. 发送HTTPS请求

use tor_hsclient::{HsClientConnector, HsClientError};
use reqwest::Client;

#[tokio::main]
async fn main() -> Result<(), HsClientError> {
    let connector = HsClientConnector::new().await?;
    
    // 创建使用Tor的reqwest客户端
    let client = Client::builder()
        .proxy(reqwest::Proxy::all("socks5h://127.0.0.1:9050")?)
        .build()?;
    
    // 通过Tor网络发送请求
    let response = client.get("https://example.onion")
        .send()
        .await?;
    
    println!("Status: {}", response.status());
    println!("Body: {}", response.text().await?);
    
    Ok(())
}

高级配置

自定义Tor配置

use tor_hsclient::{HsClientConnector, HsClientConfig, HsClientError};

#[tokio::main]
async fn main() -> Result<(), HsClientError> {
    // 自定义配置
    let config = HsClientConfig {
        socks_port: 9050,  // 自定义SOCKS端口
        control_port: 9051,  // Tor控制端口
        data_directory: Some("/path/to/tor/data".into()),  // 数据目录
        ..Default::default()
    };
    
    let connector = HsClientConnector::with_config(config).await?;
    
    // 使用连接器...
    
    Ok(())
}

处理流式数据

use tor_hsclient::{HsClientConnector, HsClientError};
use tokio::io::{AsyncReadExt, AsyncWriteExt};

#[tokio::main]
async fn main() -> Result<(), HsClientError> {
    let connector = HsClientConnector::new().await?;
    let mut stream = connector.connect("example.onion:1234").await?;
    
    // 发送数据
    stream.write_all(b"PING").await?;
    
    // 读取响应
    let mut buf = [0u8; 1024];
    let n = stream.read(&mut buf).await?;
    
    println!("Received: {}", String::from_utf8_lossy(&buf[..n]));
    
    Ok(())
}

注意事项

1. 使用前需要确保系统已安装Tor服务并正常运行
2. 默认使用SOCKS5代理(127.0.0.1:9050)
3. 访问.onion服务时不需要"http://"或"https://"前缀
4. 错误处理很重要，网络操作可能会因各种原因失败

错误处理示例

use tor_hsclient::{HsClientConnector, HsClientError};

#[tokio::main]
async fn main() {
    if let Err(e) = try_connect().await {
        match e {
            HsClientError::TorNotRunning => eprintln!("Tor服务未运行"),
            HsClientError::ConnectionFailed => eprintln!("连接失败"),
            HsClientError::Timeout => eprintln!("请求超时"),
            _ => eprintln!("未知错误: {}", e),
        }
    }
}

async fn try_connect() -> Result<(), HsClientError> {
    let connector = HsClientConnector::new().await?;
    let _stream = connector.connect("example.onion:80").await?;
    Ok(())
}

完整示例DEMO

下面是一个完整的示例，展示了如何通过tor-hsclient访问Tor隐藏服务并获取网页内容：

use tor_hsclient::{HsClientConnector, HsClientError};
use tokio::io::{AsyncReadExt, AsyncWriteExt};

#[tokio::main]
async fn main() -> Result<(), HsClientError> {
    // 1. 初始化Tor客户端连接器
    println!("正在初始化Tor客户端...");
    let connector = HsClientConnector::new().await?;
    
    // 2. 连接到目标.onion服务 (示例使用port 80)
    println!("正在连接.onion服务...");
    let mut stream = connector.connect("example.onion:80").await?;
    
    // 3. 构造并发送HTTP GET请求
    println!("发送HTTP请求...");
    let request = b"GET / HTTP/1.1\r\nHost: example.onion\r\nConnection: close\r\n\r\n";
    stream.write_all(request).await?;
    
    // 4. 读取响应数据
    println!("正在接收响应...");
    let mut response = Vec::new();
    stream.read_to_end(&mut response).await?;
    
    // 5. 输出响应结果
    println!("=== 响应内容 ===");
    println!("{}", String::from_utf8_lossy(&response));
    println!("================");
    
    Ok(())
}

这个完整示例包含了以下关键步骤：

1. 初始化Tor客户端连接器
2. 建立与.onion服务的连接
3. 构造并发送HTTP请求
4. 接收并处理响应数据
5. 输出响应内容

使用前请确保：

• 系统已安装并运行Tor服务
• 替换示例中的"example.onion"为实际的.onion地址
• 根据目标服务选择合适的端口号