Features
Everything you need to reliably route requests through flaky SOCKS5 proxies at scale.
F01
Multi-path race
Fan out each request across K proxies simultaneously; first successful response wins, losers are cancelled.
F02
Adaptive fan-out
K auto-adjusts based on current success rate and the number of healthy proxies available.
F03
Per-(proxy, host) rate limiting
Configurable minimum intervals with per-host overrides prevent tripping upstream abuse detection.
F04
Health tracking
Sliding-window success/failure counters per (proxy, host) pair with latency stats.
F05
Exponential-backoff cooldown
Consecutively-failing (proxy, host) pairs back off automatically with configurable base and max durations.
F06
Per-host pool isolation
ScatterProxyRouter gives each target host its own independent proxy pool, health tracker, scheduler, and config. A struggling host cannot starve tasks for healthy hosts.F07
Proxy eviction
Proxies with 0% global success rate after sufficient samples are automatically marked dead and removed.
F08
socks5h:// by default
DNS resolution happens on the proxy side, preventing local DNS leaks and improving anonymity.
F09
State persistence
JSON snapshots with atomic writes enable hot restarts with no warm-up penalty.
F10
Automatic source refresh
Proxy lists are periodically re-fetched from configured URLs on a configurable interval.
F11
Pluggable body classifier
Implement the
BodyClassifier trait to decide whether a response is good, blocked, or errored.F12
Observability
Structured logging via
tracing with periodic metrics summaries and real-time PoolMetrics.