Repository files navigation

A robust and efficient proxy validator tool that collects, validates, and manages proxy lists from multiple sources. It features automated validation, Discord integration for reporting, detailed terminal feedback, and support for local proxy files.

• Multi-source proxy collection from various sources:
  • Online endpoints and APIs
  • Local TXT files (one proxy per line)
  • Configurable backup sources
• Intelligent proxy validation with multiple check endpoints
• Automated backup sources if primary sources fail
• Beautiful terminal interface with real-time progress tracking
• Discord webhook integration for validation reports
• Automatic proxy list saving with timestamps
• Configurable validation parameters
• Support for HTTP, HTTPS, SOCKS4, and SOCKS5 proxies

# Clone the repositorygit clone https://github.com/imneli/proxy-validator# Navigate to the project directorycd proxy-validator# Install dependenciesnpm install

• Node.js 16.x or higher
• npm or yarn
• Discord webhook URL (optional, for reporting)

1. Create a.env file in the project root:

DISCORD_WEBHOOK=your_webhook_url_here

2. (Optional) Modify proxy sources inconfig.ts:

exportconstPROXY_SOURCES=[// Add your preferred proxy sources here];

3. Set up local proxy files:
   • Create aproxy-lists folder in the project root
   • Add your .txt files with proxies (one proxy per line in IP:PORT format)
   • Files will be automatically read during validation

proxy-validator/├── .env├── proxy-lists/          # Your local proxy TXT files│   ├── proxies1.txt│   ├── proxies2.txt│   └── ...├── proxies/             # Output directory for valid proxies└── ...

# Run the scriptnpm run start

The validator will:

1. Read all .txt files from theproxy-lists directory
2. Collect proxies from configured online sources
3. Validate all unique proxies
4. Save valid proxies and generate reports

Local proxy files should follow these guidelines:

• Text files with .txt extension
• One proxy per line
• Format: IP:PORT (e.g., 192.168.1.1:8080)
• Files can contain comments (lines without valid proxy format will be ignored)

Example proxy-lists/proxies.txt:

# HTTP Proxies192.168.1.1:808010.0.0.1:3128# SOCKS Proxies172.16.0.1:1080

The validator generates two types of output:

1. A text file containing valid proxies in theproxies directory
2. A detailed Discord report (if webhook is configured) including:
   • Total proxies collected (from both files and URLs)
   • Number of valid proxies
   • Validation timestamp
   • Source statistics

MIT License - feel free to use and modify for your needs.

Contributions are welcome! Please feel free to submit a Pull Request.