2020-05-19 21:59:46 +02:00
dumbproxy
=========
Dumbiest HTTP proxy ever.
## Features
* Cross-platform (Windows/Mac OS/Linux/Android (via shell)/\*BSD)
* Zero-configuration
* Supports CONNECT method and forwarding of HTTPS connections
2020-05-20 00:00:59 +02:00
* Supports `Basic` proxy authentication
2020-05-19 21:59:46 +02:00
## Installation
#### Binary download
Pre-built binaries available on [releases ](https://github.com/Snawoot/dumbproxy/releases/latest ) page.
#### From source
Alternatively, you may install dumbproxy from source. Run within source directory
```
go install
```
## Usage
2020-05-20 00:00:59 +02:00
Just run program and it'll start accepting connections on port 8080 (default).
Example: run proxy on port 1234 with `Basic` authentication with username `admin` and password `123456` :
```sh
dumbproxy -bind-address :1234 -auth 'static://?username=admin& password=123456'
```
## Authentication
Authentication parameters are passed as URI via `-auth` parameter. Scheme of URI defines authentication metnod and query parameters define parameter values for authentication provider.
* `none` - no authentication. Example: `none://` . This is default.
* `static` - basic authentication for single login and password pair. Example: `static://?username=admin&password=123456` . Parameters:
* `username` - login
* `password` - password
2020-05-19 21:59:46 +02:00
## Synopsis
```
$ ~/go/bin/dumbproxy -h
-bind-address string
HTTP proxy listen address (default ":8080")
-timeout duration
timeout for network operations (default 10s)
-verbosity int
logging verbosity (10 - debug, 20 - info, 30 - warning, 40 - error, 50 - critical) (default 20)
```
