OkkProxy Docs

English

简体中文

English

简体中文

Appearance

Proxy FAQ ​

Common questions and solutions about using OkkProxy proxies.

Overview ​

This section collects the most common issues users encounter when using proxies. Click on a question to view detailed answers.

What if proxy connection fails?

Common Causes and Solutions ​

1. Incorrect Authentication Information ​

Problem: Username or password incorrect Solution:

  • Check if username and password are correct
  • Pay attention to case sensitivity
  • Make sure there are no extra spaces
  • Recopy authentication information from dashboard

2. IP Whitelist Issue ​

Problem: Your IP is not added to whitelist Solution:

  • Log in to dashboard and add current IP to whitelist
  • Use https://ipinfo.io to check your public IP
  • Wait a few minutes after adding IP

3. Port Blocked ​

Problem: Proxy port cannot be accessed Solution:

  • Check firewall settings
  • Try using other ports
  • Contact network administrator

4. Insufficient Balance ​

Problem: Plan expired or traffic exhausted Solution:

  • Log in to dashboard to check balance
  • Recharge or renew plan
  • Check plan validity period
Why is the proxy slow?

Factors Affecting Speed ​

1. Geographic Distance ​

  • Proxy server far from target website
  • Suggestion: Choose nodes closer to target website

2. Network Congestion ​

  • Network busy during peak hours
  • Suggestion: Avoid peak hours or upgrade plan

3. Target Website Restrictions ​

  • Some websites throttle proxy IPs
  • Suggestion: Use residential IPs instead of datacenter IPs

4. Too Many Concurrent Requests ​

  • Too many simultaneous requests
  • Suggestion: Control concurrency, set reasonable delays

Optimization Suggestions ​

python
# Example: Add request delay
import time
import requests

proxies = {
    'http': 'http://username:[email protected]:8080',
    'https': 'http://username:[email protected]:8080'
}

for url in url_list:
    response = requests.get(url, proxies=proxies)
    time.sleep(1)  # Add 1 second delay
IP banned by target website?

Identifying IP Ban ​

  • Returns 403 Forbidden
  • Returns 429 Too Many Requests
  • Requires CAPTCHA
  • Connection timeout

Solutions ​

1. Change IP ​

python
# Use session to rotate IPs
import requests

# Use new session for each request
def make_request(url):
    proxies = {
        'http': 'http://username:[email protected]:8080'
    }
    response = requests.get(url, proxies=proxies)
    return response

2. Reduce Request Frequency ​

  • Increase request intervals
  • Use random delays
  • Simulate human behavior

3. Use High-Quality IPs ​

  • Upgrade to residential IP plan
  • Use dedicated IPs
  • Choose fingerprint browser feature

4. Set Correct Request Headers ​

python
headers = {
    'User-Agent': 'Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36',
    'Accept': 'text/html,application/xhtml+xml,application/xml;q=0.9,*/*;q=0.8',
    'Accept-Language': 'en-US,en;q=0.9',
    'Accept-Encoding': 'gzip, deflate, br',
    'Connection': 'keep-alive',
}
How to test if proxy is working?

Method 1: Command Line Test ​

bash
# Test HTTP proxy
curl -x http://username:[email protected]:8080 \
  -I https://www.google.com

# Test SOCKS5 proxy
curl --socks5 username:[email protected]:1080 \
  -I https://www.google.com

Method 2: Python Test ​

python
import requests

proxies = {
    'http': 'http://username:[email protected]:8080',
    'https': 'http://username:[email protected]:8080'
}

try:
    response = requests.get('https://ipinfo.io/json',
                          proxies=proxies,
                          timeout=10)
    print(f"Proxy IP: {response.json()['ip']}")
    print(f"Location: {response.json()['city']}, {response.json()['country']}")
    print("Proxy working properly!")
except Exception as e:
    print(f"Proxy test failed: {e}")

Method 3: Online Tools ​

Visit the following websites for testing:

Proxy error code explanations

HTTP Status Codes ​

407 Proxy Authentication Required ​

  • Reason: Proxy authentication failed
  • Solution: Check username and password

429 Too Many Requests ​

  • Reason: Requests too frequent
  • Solution: Reduce request frequency

502 Bad Gateway ​

  • Reason: Proxy server cannot connect to target
  • Solution: Check if target URL is correct

504 Gateway Timeout ​

  • Reason: Proxy timeout
  • Solution: Increase timeout or change node

Custom Error Codes ​

  • E001: Insufficient balance
  • E002: Plan expired
  • E003: IP not authorized
  • E004: Concurrency exceeded
How to set IP whitelist?

Whitelist Purpose ​

  • Only allow specific IPs to use proxy
  • Improve account security
  • Prevent account theft

Setup Steps ​

  1. Log in to OkkProxy management dashboard
  2. Go to "Security Settings"
  3. Select "IP Whitelist"
  4. Click "Add IP"
  5. Enter your public IP address
  6. Save settings

Check Current IP ​

bash
curl https://ipinfo.io/ip

Notes ​

  • Maximum 10 IPs can be added
  • Need to re-add after IP changes
  • Whitelist takes a few minutes to take effect
How to rotate IPs?

Automatic Rotation ​

Some plans support automatic IP rotation:

  • Use different IP for each request
  • No manual operation required
  • Suitable for large-scale collection

Manual Rotation ​

Method 1: Use Different Ports ​

python
import random

ports = [8080, 8081, 8082, 8083, 8084]
port = random.choice(ports)

proxies = {
    'http': f'http://username:[email protected]:{port}'
}

Method 2: API Request New IP ​

python
import requests

def get_new_proxy():
    # Call API to get new proxy IP
    response = requests.get(
        'https://api.okkproxy.com/v1/proxy/get',
        headers={'Authorization': 'Bearer YOUR_API_KEY'}
    )
    return response.json()['proxy']

Rotation Strategies ​

  • Time-based Rotation: Change after fixed time
  • Request-based Rotation: Change after N requests
  • Error-based Rotation: Change when error rate is high
How to handle CAPTCHAs?

Reasons for Encountering CAPTCHAs ​

  • Request frequency too high
  • Poor IP quality
  • Target website's anti-scraping strategy

Solutions ​

1. Use Higher Quality IPs ​

  • Upgrade to residential IPs
  • Use dedicated IPs
  • Configure fingerprint browser

2. Reduce Request Frequency ​

python
import time
import random

# Add random delay
time.sleep(random.uniform(2, 5))

3. Use CAPTCHA Solving Services ​

  • 2Captcha
  • Anti-Captcha
  • Manual CAPTCHA handling

4. Simulate Real Users ​

  • Complete browser fingerprint
  • Real user behavior
  • Reasonable request sequence
What protocols does proxy support?

HTTP/HTTPS ​

  • Most commonly used proxy protocol
  • Suitable for web requests and API calls
  • Supports all standard HTTP methods

SOCKS5 ​

  • Lower-level proxy protocol
  • Supports TCP and UDP
  • Suitable for various applications

Protocol Selection Recommendations ​

  • Web Scraping: Prefer HTTP/HTTPS
  • Games/Apps: Use SOCKS5
  • Special Needs: Contact customer service

Have Other Proxy Questions? ​

If the above content doesn't solve your problem, please:

We will answer you as soon as possible!

© 2025 OkkProxy. All rights reserved.