v1.10.82-f67ee7d
Skip to main content
← Back to Hex Proxies

Proxy Troubleshooting FAQ

Diagnose and fix common proxy issues including connection errors, authentication problems, and performance degradation.

Support

Even with well-configured proxies, issues occasionally arise. This FAQ covers the most common problems with diagnostic steps and solutions for each.

Frequently Asked Questions

Proxy connection timing out?

Check network connectivity, firewall rules, proxy host/port, ISP port blocking, and target availability. Set 10-15 second timeouts for residential, 5-10 for ISP.

407 authentication errors?

Wrong credentials, expired password, URL encoding issues with special characters, wrong port, or suspended account. Copy credentials directly from dashboard and verify account status.

Requests blocked by target?

Anti-bot detection, flagged IP, unrealistic headers, high request rate, or blocked IP range. Use rotating residential proxies, add realistic headers, slow down, use headless browser for protected sites.

Proxy speed slow?

Geographic distance, residential proxy variability, network congestion, local bandwidth limits, concurrent overload. Try closer locations, upgrade to ISP for speed-sensitive tasks, enable connection pooling.

Different content through proxy?

Expected behavior — websites serve localized content based on IP location. Also caused by A/B testing, caching differences, or anti-bot serving modified content. Target proxies in your home region if you need consistent content.

Empty responses?

Silent blocks (200 status, empty body), SSL failures, firewall termination, timeouts, or encoding issues. Check status codes, test with cURL -v, verify gzip handling.

SSL certificate errors?

Usually client-side issues, not proxy-related. The CONNECT tunnel preserves direct SSL between client and target. Verify by accessing the URL directly without proxy.

Works for some sites but not others?

Different sites have different security. Switch to residential proxies with realistic headers for anti-bot sites. Use correct geo-targeting for restricted sites. Use headless browser for JavaScript-heavy sites.

How to debug proxy configuration?

Step 1: test with cURL. Step 2: check network connectivity. Step 3: check proxy URL format in your app. Step 4: check environment variable conflicts. Step 5: enable verbose logging. Step 6: contact support.

Success rate dropped suddenly?

Target updated defenses, IP pool flagged, configuration change, or network issues. Reduce rate, switch locations/sessions, verify headers, test manually.

More bandwidth than expected?

Loading unnecessary resources, headless browser defaults, redirect chains, retry loops. Block images in headless browsers, use HTTP requests when possible, limit retries.

Connection refused errors?

Wrong port, service temporarily down, IP blocked at network level, firewall rules, ISP port blocking. Verify host/port, try HTTP and SOCKS5 ports, try different network.

What error codes to watch?

407 (auth failed), 403 (blocked), 429 (rate limited), 502 (bad gateway), 503 (unavailable), 504 (timeout), 520-530 (Cloudflare). 4xx = request issue, 5xx = server/proxy issue.

How to contact support?

Through dashboard support center. Include account email, proxy type, target website, exact error, proxy config (without password), reproduction steps, and timing.

Support Center
Proxy using wrong location?

Check targeting syntax, verify with IP geolocation service. Ensure country codes are correct ISO format. Try country-level targeting if city-level has limited availability.

Still Have Questions?

Our support team is ready to help you get started.