SocksProxy 1.0.5

GeekTools.SocksProxy

一个高性能、易用的 .NET SOCKS 代理实现，支持 SOCKS4/4a/5 协议。

✨ 特性

• 支持 SOCKS4、SOCKS4a 和 SOCKS5 协议
• 支持用户名/密码认证 (SOCKS5)
• 支持用户标识 (SOCKS4/4a)
• 智能的资源管理
  • 自动复用相同配置的代理实例
  • 默认跟随 HttpClientHandler 生命周期
  • 可选的自动清理模式
  • 线程安全的实现

📦 安装

dotnet add package GeekTools.SocksProxy

🚀 快速开始

基本用法（扩展方法）

// 1. 默认跟随handler生命周期
var handler = new HttpClientHandler()
    .UseSocksProxy("127.0.0.1", 1080);

// 2. 启用自动清理（30分钟后清理）
var handler2 = new HttpClientHandler()
    .UseSocksProxy(
        "127.0.0.1", 
        1080,
        enableAutoCleanup: true
    );

// 3. 启用自动清理（自定义清理时间）
var handler3 = new HttpClientHandler()
    .UseSocksProxy(
        "127.0.0.1", 
        1080,
        enableAutoCleanup: true,
        idleTimeout: TimeSpan.FromMinutes(10)
    );

// 4. 带认证的SOCKS5代理
var handler4 = new HttpClientHandler()
    .UseSocksProxy(
        "127.0.0.1",
        1080,
        username: "user",
        password: "pass"
    );

// 使用配置好的handler创建HttpClient
using var client = new HttpClient(handler);

原始工厂方法

// 1. 默认跟随handler生命周期
var handler = new HttpClientHandler();
handler.Proxy = SocksWebProxy.GetProxy(
    "127.0.0.1", 
    1080,
    handler: handler
);

// 2. 启用自动清理
var options = new SocksWebProxyOptions 
{
    EnableAutoCleanup = true,
    IdleTimeout = TimeSpan.FromMinutes(30)
};

var handler2 = new HttpClientHandler
{
    Proxy = SocksWebProxy.GetProxy("127.0.0.1", 1080, options: options)
};

🔧 资源管理

生命周期跟随模式（默认）

• 代理实例跟随 HttpClientHandler 的生命周期
• 当 handler 被回收时，对应的代理实例也会被清理
• 适合大多数使用场景
• 无需额外配置

自动清理模式（可选）

• 需要显式启用
• 代理实例在闲置超时后自动清理
• 适合长期运行且需要定期清理的应用
• 可自定义清理间隔和闲置超时时间

📝 注意事项

1. SOCKS4 只支持 IPv4
2. SOCKS4a 添加了域名解析支持
3. SOCKS5 支持 IPv4、IPv6 和域名
4. 相同配置的代理实例会被自动复用
5. 建议根据使用场景选择合适的资源管理模式：
   • 一般情况下使用默认的生命周期跟随模式即可
   • 对于需要定期清理资源的长期运行应用，可以启用自动清理模式

🔍 性能考虑

• 实例复用
  • 相同配置的代理实例自动复用
  • 避免重复创建代理实例
• 资源管理
  • 默认跟随 handler 生命周期，资源管理更可控
  • 可选的自动清理模式满足特殊需求
• 线程安全
  • 使用 ConcurrentDictionary 确保线程安全
  • 原子操作和锁优化

📋 支持的平台

• .NET Standard 2.0+
• .NET Core 3.1+
• .NET 5.0+
• .NET 6.0+
• .NET 7.0+
• .NET 8.0+

📄 许可证

MIT License

📚 更新日志

1.0.5 (2024-11-21)

• 增加生命周期跟随HttpClientHandler选项

1.0.4 (2024-11-21)

• 代码重构
• 简化逻辑，去除依赖注入、扩展方法，统一工厂创建实例
• 自动复用和清理代理实例

1.0.2 (2024-11-20)

• 可选依赖包安装

1.0.1 (2024-11-20)

• 优化资源清理机制
• 添加异步清理支持
• 改进日志输出
• 增强性能监控
• 完善文档

1.0.0 (2024-11-19)

• 初始发布
• 支持 SOCKS4/4a/5 协议
• 自动清理代理资源
• 可配置的缓存机制
• 添加依赖注入支持