Skip to main content

Full-featured proxy connector for aiohttp

Project description


Build Status Coverage Status PyPI version

SOCKS proxy connector for aiohttp. HTTP, HTTPS, SOCKS4(a) and SOCKS5(h) proxies are supported.


  • Python >= 3.5.3
  • aiohttp >= 2.3.2 # including v3.x


pip install aiohttp_proxy


aiohttp usage:

import aiohttp
from aiohttp_proxy import ProxyConnector, ProxyType

async def fetch(url):
    connector = ProxyConnector.from_url('http://user:password@')
    ### or use ProxyConnector constructor
    # connector = ProxyConnector(
    #     proxy_type=ProxyType.SOCKS5,
    #     host='',
    #     port=1080,
    #     username='user',
    #     password='password',
    #     rdns=True
    # )
    async with aiohttp.ClientSession(connector=connector) as session:
        async with session.get(url) as response:
            return await response.text()

aiohttp-socks also provides open_connection and create_connection functions:

from aiohttp_proxy import open_connection

async def fetch():
    reader, writer = await open_connection(
    request = (b"GET /ip HTTP/1.1\r\n"
               b"Connection: close\r\n\r\n")

    return await

Why give aiohttp a new proxy support

First must declare, our code is based on aiohttp-socks, thank you very much for the hard work.

But in order to more flexible support for multiple proxy methods (not just SOCKS proxy), we decided to fork [aiohttp-socks] (, which is currently based on it.

Combine with native aiohttp to provide HTTP/HTTPS proxy instead of writing troublesome discriminating code based on the type of proxy.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for aiohttp-proxy, version 0.1.2
Filename, size File type Python version Upload date Hashes
Filename, size aiohttp_proxy-0.1.2-py3-none-any.whl (12.3 kB) File type Wheel Python version py3 Upload date Hashes View
Filename, size aiohttp_proxy-0.1.2.tar.gz (10.9 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page