Skip to main content

Troubleshooting

This guide covers common issues and their solutions when using WeProxies.

Connection Issues​

407 Proxy Authentication Required​

Problem: The proxy server is rejecting your credentials.

Solutions:

  1. Verify credentials

    # Check your credentials are correct
    echo "Username: wp_abc123xyz"
    echo "Password: your-password"

  2. Check for special characters - URL-encode special characters in your password:

    CharacterEncoded
    @%40
    :%3A
    /%2F

  3. Verify subscription is active

    • Log in to dashboard
    • Check Proxies → subscription status

  4. Test with cURL

    curl -v -x "http://username:password@proxy.weproxies.com:1080" https://api.ipify.org

Connection Refused​

Problem: Cannot establish connection to the proxy server.

Solutions:

  1. Check firewall - Ensure port 1080 is allowed for outbound connections

  2. Test connectivity

    nc -zv proxy.weproxies.com 1080
    # or
    telnet proxy.weproxies.com 1080

  3. Try alternate port - Contact support if 1080 is blocked by your network

  4. Check VPN - Some VPNs may block proxy connections

Connection Timeout​

Problem: Requests are timing out.

Solutions:

  1. Increase timeout

    # Python
    response = requests.get(url, proxies=proxies, timeout=60)
    // Node.js
    axios.get(url, { httpsAgent: agent, timeout: 60000 })

  2. Check your internet connection

  3. Try a different target - The target website may be slow

  4. Reduce concurrency - Too many simultaneous requests can cause delays

Authentication Issues​

Wrong IP Country​

Problem: Getting an IP from a different country than requested.

Solutions:

  1. Verify country code format

    # Correct: 2-letter ISO code
    username-country-US:password

    # Wrong
    username-country-USA:password
    username-country-united-states:password

  2. Check available countries - Some countries may have limited availability

  3. Use with session - Combine with sticky session for consistency

    username-country-US-session-abc123:password

Session IP Changing​

Problem: Sticky session not maintaining the same IP.

Solutions:

  1. Keep session active - Sessions expire after 10 minutes of inactivity

    # Make periodic requests to keep session alive
    import time

    while True:
        response = requests.get(url, proxies=proxies)
        time.sleep(300)  # Every 5 minutes

  2. Use consistent session ID

    # Good: Same session ID
    username-session-mysession123:password

    # Bad: Random session IDs
    username-session-{random}:password

  3. IP may become unavailable - Residential IPs can go offline. Use retry logic.

Request Issues​

SSL Certificate Errors​

Problem: SSL verification failing through proxy.

Solutions:

  1. Don't disable SSL verification in production

  2. For testing only:

    response = requests.get(url, proxies=proxies, verify=False)

  3. Check target certificate - The target site may have an expired certificate

Website Blocking Proxy​

Problem: Target website detecting and blocking the proxy.

Solutions:

  1. Rotate User-Agents

    import random

    user_agents = [
        "Mozilla/5.0 (Windows NT 10.0; Win64; x64)...",
        "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7)...",
    ]

    headers = {"User-Agent": random.choice(user_agents)}

  2. Use sticky sessions - Consistent IP for multi-step operations

  3. Add delays between requests

    import time
    time.sleep(random.uniform(1, 3))

  4. Rotate IPs - Don't use the same IP for too many requests

  5. Mimic browser behavior

    • Send realistic headers
    • Handle cookies
    • Follow redirects naturally

Empty or Truncated Responses​

Problem: Receiving incomplete data.

Solutions:

  1. Increase timeout

    response = requests.get(url, proxies=proxies, timeout=(10, 60))
    # (connect_timeout, read_timeout)

  2. Check Content-Length - Verify full response received

  3. Retry on failure

    from requests.adapters import HTTPAdapter
    from urllib3.util.retry import Retry

    session = requests.Session()
    retry = Retry(total=3, backoff_factor=0.5)
    adapter = HTTPAdapter(max_retries=retry)
    session.mount('http://', adapter)
    session.mount('https://', adapter)

Usage Issues​

Running Out of Traffic​

Problem: Traffic exhausted before expected.

Solutions:

  1. Check what's using bandwidth

    • Go to Dashboard → Usage
    • Review daily/hourly breakdown

  2. Block unnecessary resources

    // Puppeteer/Playwright
    page.route('**/*', route => {
      if (['image', 'font', 'stylesheet'].includes(route.request().resourceType())) {
        route.abort();
      } else {
        route.continue();
      }
    });

  3. Use compression

    headers = {"Accept-Encoding": "gzip, deflate, br"}

  4. Set up usage alerts - Dashboard → Settings → Notifications

High Error Rate​

Problem: Many requests failing.

Solutions:

  1. Check error types

    • Connection errors → Check network/firewall
    • 4xx errors → Check target URL and headers
    • 5xx errors → Target server issues or rate limiting

  2. Implement proper error handling

    try:
        response = requests.get(url, proxies=proxies, timeout=30)
        response.raise_for_status()
    except requests.exceptions.ProxyError as e:
        print(f"Proxy error: {e}")
    except requests.exceptions.Timeout as e:
        print(f"Timeout: {e}")
    except requests.exceptions.HTTPError as e:
        print(f"HTTP error: {e}")

  3. Add retry logic with backoff

  4. Reduce concurrency if getting rate limited

Debugging​

Enable Verbose Logging​

cURL:

curl -v -x "http://user:pass@proxy.weproxies.com:1080" https://example.com

Python:

import logging
import http.client

http.client.HTTPConnection.debuglevel = 1
logging.basicConfig()
logging.getLogger().setLevel(logging.DEBUG)
requests_log = logging.getLogger("requests.packages.urllib3")
requests_log.setLevel(logging.DEBUG)
requests_log.propagate = True

Node.js:

process.env.DEBUG = '*';  // Before imports

const axios = require('axios');
// ... rest of code

Test Proxy Connection​

# Test basic connectivity
curl -x "http://user:pass@proxy.weproxies.com:1080" https://api.ipify.org

# Test with verbose output
curl -v -x "http://user:pass@proxy.weproxies.com:1080" https://httpbin.org/ip

# Test country targeting
curl -x "http://user-country-US:pass@proxy.weproxies.com:1080" https://ipapi.co/json/

Getting Help​

If you've tried these solutions and still have issues:

  1. Check status page: status.weproxies.com

  2. Contact support with:

    • Your username (not password)
    • Error messages
    • Code samples
    • Timestamp of issues

📧 support@weproxies.com