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.

Source Distribution

aiohttp_proxy-0.1.2.tar.gz (10.9 kB view hashes)

Uploaded Source

Built Distribution

aiohttp_proxy-0.1.2-py3-none-any.whl (12.3 kB view hashes)

Uploaded Python 3

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page