Rooba
/
proxy.py
mirror of https://github.com/abhinavsingh/proxy.py.git
1
1
Fork 0
Code Issues Packages Projects Releases Wiki Activity
⚡ Fast • 🪶 Lightweight • 0️⃣ Dependency • 🔌 Pluggable • 😈 TLS interception • 🔒 DNS-over-HTTPS • 🔥 Poor Man's VPN • ⏪ Reverse & ⏩ Forward • 👮🏿 "Proxy Server" framework • 🌐 "Web Server" framework • ➵ ➶ ➷ ➠ "PubSub" framework • 👷 "Work" acceptor & executor f
67 Commits 16 Branches 33 Tags 17 MiB
Python 89.1%
Jupyter Notebook 3.6%
TypeScript 2.8%
Shell 2.4%
Makefile 0.8%
Other 1.2%
Go to file
Abhinav Singh 91be448045 Only run if Python 3+. 
Some users are already being effected by this, however master branch is
still stable.  Python 2.7 users can continue using the master branch or
simply install via pip.  This change also targets issue#58
 		2019-08-11 01:36:24 -07:00
.dockerignore Add Dockerfile and build rule 2018-12-22 07:08:04 -08:00
.gitignore Prepare for v0.3 release 2019-02-08 18:57:44 -08:00
.travis.yml Add python 3.7 support using workaround 2019-02-08 20:18:16 -08:00
Dockerfile Add Dockerfile and build rule 2018-12-22 07:08:04 -08:00
LICENSE PEP8 formatting 2018-10-17 14:01:19 +05:30
MANIFEST.in setup.py and argparse 2013-08-20 14:56:32 +05:30
Makefile Release docker container and prep for v0.4 2019-02-08 21:13:34 -08:00
README.md Refactor 2019-07-23 17:57:47 -07:00
proxy.py Only run if Python 3+. 2019-08-11 01:36:24 -07:00
requirements-dev.txt Refactor 2019-07-23 17:57:47 -07:00
setup.py Add placeholder test for issue#5, prepare for v0.3 2018-12-10 21:40:12 +05:30
tests.py Refactor 2019-07-23 17:57:47 -07:00

README.md

proxy.py

Lightweight HTTP, HTTPS, HTTP2 and WebSockets Proxy Server in Python.

alt text

Features

  • Distributed as a single file module
  • No external dependency other than standard Python library
  • Support for http, https and websockets request proxy
  • Optimize for large file uploads and downloads
  • IPv4 and IPv6 support
  • Basic authentication support
  • Can serve a PAC (Proxy Autoconfiguration) file

Install

To install proxy.py, simply:

$ pip install --upgrade proxy.py

Using docker:

$ docker run -it -p 8899:8899 --rm abhinavsingh/proxy.py

Usage

$ proxy.py -h
usage: proxy.py [-h] [--backlog BACKLOG] [--basic-auth BASIC_AUTH]
                [--client-recvbuf-size CLIENT_RECVBUF_SIZE]
                [--hostname HOSTNAME] [--ipv4 IPV4] [--log-level LOG_LEVEL]
                [--open-file-limit OPEN_FILE_LIMIT] [--port PORT]
                [--pac-file PAC_FILE]
                [--server-recvbuf-size SERVER_RECVBUF_SIZE]
                [--num-workers NUM_WORKERS]

proxy.py v0.4

optional arguments ordered alphabetically:
  -h, --help            show this help message and exit
  --backlog BACKLOG     Default: 100. Maximum number of pending connections to
                        proxy server
  --basic-auth BASIC_AUTH
                        Default: No authentication. Specify colon separated
                        user:password to enable basic authentication.
  --client-recvbuf-size CLIENT_RECVBUF_SIZE
                        Default: 8 KB. Maximum amount of data received from
                        the client in a single recv() operation. Bump this
                        value for faster uploads at the expense of increased
                        RAM.
  --hostname HOSTNAME   Default: 127.0.0.1. Server IP address.
  --ipv4 IPV4           Whether to listen on IPv4 address. By default server
                        only listens on IPv6.
  --log-level LOG_LEVEL
                        Valid options: DEBUG, INFO (default), WARNING, ERROR,
                        CRITICAL. Both upper and lowercase values are
                        allowed.You may also simply use the leading character
                        e.g. --log-level d
  --open-file-limit OPEN_FILE_LIMIT
                        Default: 1024. Maximum number of files (TCP
                        connections) that proxy.py can open concurrently.
  --port PORT           Default: 8899. Server port.
  --pac-file PAC_FILE   A file (Proxy Auto Configuration) or string to serve
                        when the server receives a direct file request.
  --server-recvbuf-size SERVER_RECVBUF_SIZE
                        Default: 8 KB. Maximum amount of data received from
                        the server in a single recv() operation. Bump this
                        value for faster downloads at the expense of increased
                        RAM.
  --num-workers NUM_WORKERS
                        Defaults to number of CPU cores.

Proxy.py not working? Report at:
https://github.com/abhinavsingh/proxy.py/issues/new