Proxies
Provider config, sticky sessions, country pinning.
Supported providers
Out of the box we support Decodo, IPRoyal, Bright Data, and any provider whose username convention is user-USERNAME-country-XX-session-ID. Custom providers slot in via the ProxyProvider Protocol.
Configuration
PROXY_PROVIDER=decodo
PROXY_ENDPOINT=gw.dc.decodo.com:7000
PROXY_USERNAME=your_username
PROXY_PASSWORD=your_password
PROXY_COUNTRY=us
PROXY_STICKY_SESSION_MINUTES=10Sticky sessions
The same logical user keeps the same exit IP for the configured sticky window (default 10 minutes). The session ID is derived from (host, fingerprint) so two requests against the same host from the same fingerprint reuse the IP — and so cookies don't get cross-IP-leaked.
Health scoring & cooldown
Every proxy session has a rolling 20-request success/failure history. Three consecutive failures put it in a 10-minute cooldown — the next request gets a fresh sticky id automatically.
Country pinning
Set PROXY_COUNTRY to an ISO-2 code to lock all egress to that country. Useful for SERP scraping (results vary by locale) and for compliance with data-localization rules.