GeekTools.Socks5Proxy 1.0.0

GeekTools.Socks5Proxy

GeekTools.Socks5Proxy 是一个高性能的 SOCKS5 代理实现库，专门为 .NET 平台设计。它支持连接池、异步操作和身份验证，可以轻松地与 HttpClient 集成使用。

特性

• ✨ 支持 SOCKS5 代理协议
• 🚀 异步操作支持
• 🔐 用户名/密码认证
• 📦 连接池支持
• ⌛ 连接超时控制
• 🔄 自动重试机制
• 📱 跨平台支持

安装

通过 NuGet 包管理器安装:

dotnet add package GeekTools.Socks5Proxy

使用方法

基本用法

// 创建代理实例
var proxy = new Socks5Proxy(
    proxyHost: "proxy.example.com",
    proxyPort: 1080,
    username: "user",  // 可选
    password: "pass"   // 可选
);

// 配置 HttpClient
var handler = new SocketsHttpHandler
{
    Proxy = proxy
};

var client = new HttpClient(handler);

使用连接池

var proxy = new Socks5Proxy(
    proxyHost: "proxy.example.com",
    proxyPort: 1080,
    useConnectionPooling: true,
    maxPoolSize: 100
);

自定义超时设置

var proxy = new Socks5Proxy(
    proxyHost: "proxy.example.com",
    proxyPort: 1080,
    connectionTimeout: 5000  // 5秒超时
);

异常处理

库定义了以下异常类型：

• ProxyProtocolException: 代理协议相关错误
• ProxyAuthenticationRequiredException: 需要认证
• ProxyAuthenticationFailedException: 认证失败
• ProxyConnectionException: 连接错误

try
{
    // 使用代理的代码
}
catch (ProxyAuthenticationFailedException ex)
{
    // 处理认证失败
}
catch (ProxyConnectionException ex)
{
    // 处理连接错误
}

性能优化建议

1. 启用连接池以重用连接
2. 适当设置最大连接池大小
3. 合理配置连接超时时间

许可证

本项目采用 MIT 许可证。详见 LICENSE 文件。

贡献

欢迎提交 Issue 和 Pull Request！

更新日志

1.0.0

• 初始发布
• 实现基本的 SOCKS5 代理功能
• 支持连接池
• 支持用户名密码认证