https://github.com/right-git/proxy-checker
https://github.com/right-git/proxy-checker
Last synced: 6 months ago
JSON representation
- Host: GitHub
- URL: https://github.com/right-git/proxy-checker
- Owner: right-git
- Created: 2025-05-29T13:07:53.000Z (11 months ago)
- Default Branch: master
- Last Pushed: 2025-06-07T09:08:55.000Z (11 months ago)
- Last Synced: 2025-06-07T10:19:28.812Z (11 months ago)
- Language: Python
- Size: 3.91 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Proxy Checker 🔍⚡
**A high-performance proxy validation tool with async support and detailed analytics**
[](https://python.org)
## Features ✨
- **Blazing Fast** ⚡ - Async I/O with configurable concurrency (200+ proxies/sec)
- **Smart Detection** 🔍 - Auto-detects protocol (HTTP/SOCKS5) from format
- **Comprehensive Checks** ✅
- Connectivity verification
- Response time measurement
- Geolocation lookup
- Protocol validation
- **Rich Output** 🎨 - Beautiful console display with color-coded results
- **Multiple Output Formats** 💾 - TXT, JSON, and CSV support
- **Retry Mechanism** 🔄 - Configurable retries for flaky proxies
- **Progress Tracking** 📊 - Real-time progress bar with Rich
## Installation 📦
```bash
git clone https://github.com/yourusername/proxy-checker.git
cd proxy-checker
pip install -r requirements.txt
```
## Usage 🚀
1. Add proxies to `proxies.txt`:
```text
socks5://user:pass@ip:port
http://user:pass@ip:port
user:pass@ip:port # Auto-detected
```
2. Run the checker:
```bash
python proxy_checker.py
```
3. Results saved to:
- `working_proxies.txt` - Verified working proxies
- `failed_proxies.txt` - Failed proxy list
- `results.json`/`results.csv` - Detailed check data
## Configuration ⚙️
Customize in code:
```python
checker = ProxyChecker(
proxy_file="proxies.txt",
timeout=5, # Seconds per check
max_concurrent=200, # Simultaneous connections
retries=2, # Retry attempts
test_url="http://ip-api.com/json" # Verification endpoint
)
```
## Advanced Tips 🧠
- **Boost Speed**:
```python
# Increase concurrency (adjust based on your system)
checker = ProxyChecker("proxies.txt", max_concurrent=300)
# Use faster test endpoint
checker = ProxyChecker("proxies.txt", test_url="http://httpbin.org/ip")
```
- **Export Formats**:
```python
checker.save_results(format="json") # json/csv/txt
```
## Output Example 📄
