🚩 Sponsors

If you like this project, consider purchasing licenses of OctoPwn, our full pentesting suite that runs in your browser!
For notifications on new builds/releases and other info, hop on to our Discord

asysocks

Asynchronous Socks5 / Socks4 / HTTP proxy client and server library in pure python.

🚩 Runs in the browser

This project, alongside with many other pentester tools runs in the browser with the power of OctoPwn!
Check out the community version at OctoPwn - Live

what is?

The primary goal of this project to act as a universal proxy clinet/server library which you can use in your projects.
Secondary goal is to have simple command-line tools to interact with socks proxyies or to start one yourself. See tools

how can I use this in my code?

This library has three main components, client , server, security

client

The proxy client code is implemented in the SOCKSClient class which can be used to set up a connection to a target host:port via HTTP / SCOSK4 / SOCKS5 proxy protocols. It has two modes of operation: LISTENER and QUEUE

listener

This mode helps proxy-unaware applications to use proxies when you can set the destination host:port and can't use proxychains and alike. It will create a TCP socket server on your localhost and each incoming client will be dispatched to the destination server via the specified proxy server.

queue

This mode can be used in your scripts to support proxies. The way it works is that you will not get a direct socket rather you can delegate two asyncio.Queue classes (one for data in, one for data out)

server

The proxy server is implemented in the SOCKSServer class. It supports HTTP / SCOSK4 / SOCKS5 protocols all on the same port. The server has basic paramteres most importantly the listen_ip and listen_port . It also comes with a clever way to deal with intercepting traffic, see the ProxyMonitor class and the server's monitor_dispatch_q variable.

security

TBD

tools

These are built-in examples showing the capabilities of the library and to be used as code snipplets on setting up classes.

asysockstunnel

Creates a listening server on localhost and tunnels all incoming connections to a pre-specified destination via a pre-defined proxy server.

asysockssec

SOCKS4/SOCKS5 server security tester

asysocksbrute

SOCKS5 authentication bruteforcer.

asysocksportscan

Quick port scaning via SOCKS4/SOCKS5/HTTP proxies

asysocksproxy

SOCKS4/SOCKS5/HTTP proxy server. Supports basic monitoring of traffic flow.

For more issues see Issues