aiohttp-socks

Proxy connector for aiohttp

Apache-2.0 47 个版本 Python >=3.8.0
安装
pip install aiohttp-socks
poetry add aiohttp-socks
pipenv install aiohttp-socks
conda install aiohttp-socks
描述

aiohttp-socks

CI Coverage Status PyPI version versions

The aiohttp-socks package provides a proxy connector for aiohttp. Supports SOCKS4(a), SOCKS5(h), HTTP (CONNECT) as well as Proxy chains. It uses python-socks for core proxy functionality.

Requirements

  • Python >= 3.8
  • aiohttp >= 3.10.0
  • python-socks[asyncio] >= 2.4.3

Installation

pip install aiohttp_socks

Usage

Simple usage

import aiohttp
from aiohttp_socks import ProxyType, ProxyConnector, ChainProxyConnector


async def fetch(url):
    connector = ProxyConnector.from_url('socks5://user:password@127.0.0.1:1080')
    
    ### or use ProxyConnector constructor
    # connector = ProxyConnector(
    #     proxy_type=ProxyType.SOCKS5,
    #     host='127.0.0.1',
    #     port=1080,
    #     username='user',
    #     password='password',
    #     rdns=True # default is True for socks5
    # )
    
    ### proxy chaining (since ver 0.3.3)
    # connector = ChainProxyConnector.from_urls([
    #     'socks5://user:password@127.0.0.1:1080',
    #     'socks4://127.0.0.1:1081',
    #     'http://user:password@127.0.0.1:3128',
    # ])
    async with aiohttp.ClientSession(connector=connector) as session:
        async with session.get(url) as response:
            return await response.text()

Why yet another SOCKS connector for aiohttp

Unlike aiosocksy, aiohttp_socks has only single point of integration with aiohttp. This makes it easier to maintain compatibility with new aiohttp versions.

版本列表
0.11.0 2025-12-09
0.10.2 2025-11-10
0.10.1 2024-12-26
0.10.0 2024-12-23
0.9.2 2024-12-20
0.9.1 2024-11-20
0.9.0 2024-07-31
0.8.4 2023-10-03
0.8.3 2023-09-06
0.8.2 2023-09-05
0.8.1 2023-09-04
0.8.0 2023-02-21
0.7.1 2021-11-23
0.7.0 2021-11-23
0.6.1 2021-11-21
0.6.0 2021-03-01
0.5.5 2020-09-22
0.5.4 2020-09-20
0.5.3 2020-07-25
0.5.2 2020-07-17
0.5.1 2020-07-16
0.5.0 2020-07-16
0.4.2 2020-07-11
0.4.1 2020-07-10
0.4.0 2020-07-07
0.3.9 2020-04-25
0.3.8 2020-04-21
0.3.7 2020-04-02
0.3.6 2020-03-23
0.3.5 2020-03-23
0.3.4 2020-01-11
0.3.3 2019-12-23
0.3.2 2019-12-20
0.3.1 2019-12-19
0.2.2 2018-12-30
0.2.1 2018-12-14
0.2 2018-10-20
0.1.9 2018-10-01
0.1.8 2018-09-29
0.1.7 2018-09-29
0.1.6 2018-08-17
0.1.5 2018-08-09
0.1.4 2018-07-25
0.1.3 2018-07-19
0.1.2 2018-07-05
0.1.1 2018-07-05
0.1.0 2018-07-04