proxyhunt

A high-performance, asynchronous proxy scraper and checker written in Rust.

proxyhunt is a streamlined command-line utility designed for speed and reliability. It efficiently fetches proxy lists from multiple remote or local sources, validates them concurrently using the Tokio runtime, and provides sorted output based on connection latency.

Features

• Asynchronous Architecture: Leverages Tokio and Reqwest for massive concurrency.
• Robust Parsing: Advanced regex-based parsing supporting various formats:
  • ip:port
  • user:pass@ip:port
  • protocol://ip:port
• Multi-Protocol Support: Full validation for HTTP, SOCKS4, and SOCKS5.
• Deduplication: Automatically handles redundant proxies across multiple sources.
• Flexible Configuration: Seamless integration between CLI arguments and TOML configuration files.
• Sorted Output: Verified proxies are sorted by latency (fastest first).
• Extensible Export: Supports both plain-text (standard list) and detailed JSON reporting.

Installation

Via Cargo (Recommended)

Install proxyhunt directly from crates.io:

cargo install proxyhunt

From Source

cargo install --path .

Quick Start

Quick Scrape & Check

Immediately scrape high-quality built-in sources and check them:

proxyhunt quick --max 1000 --limit 50

Manual Check

Check HTTP proxies from a specific URL:

proxyhunt check --http --sources https://raw.githubusercontent.com/user/repo/main/proxies.txt

Advanced Scrutiny

Run a high-concurrency check with custom timeouts and output to JSON:

proxyhunt check --http --socks5 --concurrency 1024 --timeout 5 --json verified.json

Using Configuration

Generate a config.toml based on the provided example and run:

proxyhunt --config config.toml check

Configuration

proxyhunt looks for config.toml by default. Key parameters include:

• sources: List of URLs or file paths.
• concurrency: Maximum simultaneous connection attempts.
• limit: Number of top-performing proxies to retain.
• check_url: The endpoint used for validation (defaults to icanhazip).

CLI Reference

Global Options

Check Subcommand

Quick Subcommand

License

This project is licensed under the MIT License. See the LICENSE file for details.