https://github.com/romis2012/aiohttp-socks
Proxy (HTTP, SOCKS) connector for aiohttp
https://github.com/romis2012/aiohttp-socks
aiohttp asyncio http proxy python socks4 socks5
Last synced: 18 days ago
JSON representation
Proxy (HTTP, SOCKS) connector for aiohttp
- Host: GitHub
- URL: https://github.com/romis2012/aiohttp-socks
- Owner: romis2012
- License: apache-2.0
- Created: 2018-07-04T12:09:48.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2024-12-26T07:05:11.000Z (5 months ago)
- Last Synced: 2025-04-13T20:39:39.412Z (about 2 months ago)
- Topics: aiohttp, asyncio, http, proxy, python, socks4, socks5
- Language: Python
- Homepage:
- Size: 1.34 MB
- Stars: 235
- Watchers: 7
- Forks: 24
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE.txt
Awesome Lists containing this project
README
## aiohttp-socks
[](https://github.com/romis2012/aiohttp-socks/actions/workflows/ci.yml)
[](https://codecov.io/gh/romis2012/aiohttp-socks)
[](https://pypi.python.org/pypi/aiohttp-socks)
The `aiohttp-socks` package provides a proxy connector for [aiohttp](https://github.com/aio-libs/aiohttp).
Supports SOCKS4(a), SOCKS5(h), HTTP (tunneling) as well as Proxy chains.
It uses [python-socks](https://github.com/romis2012/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
#### aiohttp usage:
```python
import aiohttp
from aiohttp_socks import ProxyType, ProxyConnector, ChainProxyConnector
async def fetch(url):
connector = ProxyConnector.from_url('socks5://user:[email protected]: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:[email protected]:1080',
# 'socks4://127.0.0.1:1081',
# 'http://user:[email protected]: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](https://github.com/romis2012/aiosocksy), aiohttp_socks has only single point of integration with aiohttp.
This makes it easier to maintain compatibility with new aiohttp versions.