Proxy Examples

Example code for using proxy servers in different programming languages. Currently we have examples for these languages:

• Python
• Ruby

Python Proxy Examples

Using python-proxy-headers

The python-proxy-headers library enables sending custom headers to proxy servers and receiving proxy response headers. This is essential for services like ProxyMesh that use custom headers for country selection and IP assignment.

Installation:

pip install python-proxy-headers

Running Examples:

All examples read proxy configuration from environment variables:

# Required: Set your proxy URL
export PROXY_URL='http://user:pass@proxy.example.com:8080'

# Optional: Custom test URL (default: https://api.ipify.org?format=json)
export TEST_URL='https://httpbin.org/ip'

# Optional: Send a custom header to the proxy
export PROXY_HEADER='X-ProxyMesh-Country'
export PROXY_VALUE='US'

# Optional: Read a specific header from the response
export RESPONSE_HEADER='X-ProxyMesh-IP'

# Run a single example
python python/requests-proxy-headers.py

# Run all examples as tests
python python/run_tests.py

# Run specific examples
python python/run_tests.py requests-proxy-headers httpx-proxy-headers

Examples:

Library	Example	Description
requests	requests-proxy-headers.py	Simple HTTP requests with proxy headers
requests	requests-proxy-headers-session.py	Session-based requests for connection pooling
urllib3	urllib3-proxy-headers.py	Low-level HTTP client with proxy headers
aiohttp	aiohttp-proxy-headers.py	Async HTTP client with proxy headers
httpx	httpx-proxy-headers.py	Modern HTTP client with proxy headers
httpx	httpx-async-proxy-headers.py	Async httpx with proxy headers
pycurl	pycurl-proxy-headers.py	libcurl bindings with proxy headers
pycurl	pycurl-proxy-headers-lowlevel.py	Low-level pycurl integration
cloudscraper	cloudscraper-proxy-headers.py	Cloudflare bypass with proxy headers
autoscraper	autoscraper-proxy-headers.py	Automatic web scraping with proxy headers

Basic Proxy Examples

• requests-proxy.py - Basic proxy usage with requests
• requests-random-proxy.py - Random proxy rotation

Scrapy

• scrapy-proxy-headers.py - Scrapy spider with proxy headers

Ruby Proxy Examples

• requests_proxy.rb - Ruby HTTP with proxy, from rpolley

Documentation

For more information on using proxy headers with Python:

• python-proxy-headers on PyPI
• python-proxy-headers Documentation
• GitHub Repository

Contributing

If you have example code for another language, please share it with a Pull Request.