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
77 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 6ea42b0dd9 Convert HttpProxy and HttpWebServer itself into plugins. 
Load plugins during test execution

Further decouple proxy/webserver logic outside of HttpProtocolHandler.

Per connection plugin instances to avoid locks

Handle BrokenPipeError and teardown if read_from_descriptors return True
 		2019-08-24 09:31:53 -07:00
.dockerignore Add proxy.py banner image 2019-08-11 10:43:59 -07:00
.gitignore Prepare for v0.3 release 2019-02-08 18:57:44 -08:00
.travis.yml Refactor HttpProxy.run 2019-08-24 09:31:50 -07: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 Add proxy.py banner image 2019-08-11 10:43:59 -07:00
Makefile Remove -v flag 2019-08-11 21:43:26 -07:00
ProxyPy.png Add proxy.py banner image 2019-08-11 10:43:59 -07:00
README.md Core changes: 2019-08-24 09:31:50 -07:00
plugin_examples.py Convert HttpProxy and HttpWebServer itself into plugins. 2019-08-24 09:31:53 -07:00
proxy.py Convert HttpProxy and HttpWebServer itself into plugins. 2019-08-24 09:31:53 -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 Convert HttpProxy and HttpWebServer itself into plugins. 2019-08-24 09:31:53 -07:00

README.md

Proxy.Py

alt text

Features

  • Distributed as a single file module
  • No external dependency other than standard Python library
  • Support for http, https, http2 and websockets request proxy
  • Optimize for large file uploads and downloads
  • IPv4 and IPv6 support
  • Basic authentication support
  • Can serve a PAC (Proxy Auto-configuration) 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
  --log-format LOG_FORMAT
                        Log format for Python logger.
  --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