kutovoys/xray-checker v0.5.0 on GitHub

🚀 New Features

Download-Based Proxy Checking

Added a new download check method for more comprehensive proxy testing that validates actual data transfer capabilities, specifically addressing new censorship techniques.

Background:
This feature was developed in response to a new blocking method introduced in Russia where connections are "frozen" after downloading approximately 15-20KB of data over a single TCP connection. Traditional proxy checks (IP and status) may pass while actual file downloads fail due to this limitation.

What's New:

New check method: download - Tests proxies by downloading files through them to detect data transfer limitations
Configurable parameters: Set custom download URLs, timeouts, and minimum size requirements
Real-world testing: Validates proxy performance with actual file transfers instead of simple connectivity checks
Detection of TCP freezing: Identifies proxies that work for small requests but fail for larger data transfers

Configuration Options:

PROXY_CHECK_METHOD=download - Enable the new download-based checking
PROXY_DOWNLOAD_URL - URL of file to download (default: https://proof.ovh.net/files/1Mb.dat)
PROXY_DOWNLOAD_TIMEOUT - Download timeout in seconds (default: 60)
PROXY_DOWNLOAD_MIN_SIZE - Minimum bytes required for success (default: 51200 / 50KB)

Benefits:

✅ Detects new censorship methods that freeze connections after data size limits
✅ Tests actual data transfer through proxies beyond simple connectivity
✅ Validates proxy performance with sustained connections
✅ Configurable success criteria based on download size
✅ Better detection of proxies that fail under load or censorship

📖 Usage Examples

Docker

docker run -d \
  -e PROXY_CHECK_METHOD=download \
  -e PROXY_DOWNLOAD_URL=https://proof.ovh.net/files/1Mb.dat \
  -e PROXY_DOWNLOAD_TIMEOUT=60 \
  -e PROXY_DOWNLOAD_MIN_SIZE=51200 \
  kutovoys/xray-checker

CLI

--proxy-check-method=download \
--proxy-download-url=https://proof.ovh.net/files/1Mb.dat \
--proxy-download-timeout=60 \
--proxy-download-min-size=51200

This release enhances proxy validation capabilities to detect modern censorship techniques while maintaining full backward compatibility with existing configurations.

Related Issue: [Russia] Censor has a new method of blocking - net4people/bbs#490