Comprehensive Diagnostic Error Catalog
HTTP Error 407: Proxy Authentication Required
Root Cause: Your proxy username or password is incorrect, or special characters in your password were not URL-encoded when embedded inside the proxy string. Fix: Check your Dashboard credentials and ensure passwords containing `@`, `#`, or `/` are safely URL-encoded (e.g., `%40`).
Target site stuck in a Cloudflare Turnstile verification loop
Root Cause: Your agent is using a datacenter IP or a rotating IP that switches mid-session while solving the challenge. Fix: Switch from `-rotate` to a sticky session tag like `-session-agent01` and ensure headless browser fingerprinting (User-Agent, WebGL) matches a standard desktop.
SSL Handshake Error / SSLCertVerificationError in Python
Root Cause: Your local Python HTTP client or LangChain loader does not trust proxy certificate chains when intercepting HTTPS connections over SSL. Fix: Ensure you connect to the proxy via standard HTTP gateway port (31112) while allowing the CONNECT tunnel to handle SSL natively.
Error 429: Too Many Requests / Rate Limit Triggered
Root Cause: You are sending too many requests per second through a single sticky session IP. Fix: If your target allows stateless retrieval (like RAG search or markdown scraping), switch to `-rotate` mode so every request uses a new physical IP.