waitress-raw

Raw HTTP Echo Server For Security Researchers and HTTP Debug

Installation

Prerequisites

• Python 3.7+.
• waitress (https://docs.pylonsproject.org/projects/waitress/en/latest/).

From pip

pip3 install waitress-raw

From Docker

docker pull realgam3/waitress-raw

From Source

git clone https://github.com/realgam3/waitress-raw.git
cd waitress-raw

# Install python dependencies.
pip3 install -r requirements.txt

# Confirm that everything works
python3 waitress-raw.py --help

Bug reports on installation issues are welcome!

Usage

Basic Usage

waitress-raw -lh 0.0.0.0 -lp 8000 -c ./examples/loggers/streamhandler.yml

Docker Usage

docker run -v "${PWD}/examples/loggers/streamhandler.yml:/usr/src/app/config.yml:ro" -p 8000:8000 --rm realgam3/waitress-raw

Command Line Arguments

waitress-raw --help

usage: waitress-raw [-h] [-v] [-lh HOST] [-lp PORT] [-s SCHEME] [-t CHANNEL_TIMEOUT] [-r] [-V] [-c CONFIG_PATH]

options:
  -h, --help            show this help message and exit
  -v, --version         show program's version number and exit
  -lh HOST, --host HOST
                        listen host. (default: 0.0.0.0)
  -lp PORT, --port PORT
                        listen port (default: 8000)
  -s SCHEME, --scheme SCHEME
                        url scheme (default: http)
  -t CHANNEL_TIMEOUT, --timeout CHANNEL_TIMEOUT
                        timeout in seconds (default: 5)
  -r, --reset-on-timeout
                        reset on timeout (default: False)
  -V, --verbose         verbose (default: False)
  -c CONFIG_PATH, --config CONFIG_PATH
                        config path (default: config.yml)