chore(README.md): add README.md file with instructions on how to run the proxy server and its features

This commit is contained in:
Timofey Gelazoniya 2023-10-31 05:57:25 +03:00
parent 8e0a899bf2
commit 548ea691b4
Signed by: zeldon
GPG Key ID: 047886915281DD2A

48
README.md Normal file
View File

@ -0,0 +1,48 @@
# Simple HTTP Tunneling Proxy Server in Go
This is a lightweight proxy server written in Go that supports HTTP requests and HTTPS tunneling.
## Features
- Proxying HTTP requests
- Tunneling HTTPS requests
- Optional Basic Proxy Authentication
- Customizable port, username, and password using command-line arguments
- Logging
## Requirements
- Go (version 1.x+)
## Usage
### Running the Proxy from source
1. Clone the repository:
```bash
git clone https://github.com/xzeldon/http-proxy-server.git
cd http-proxy-server
```
2. Run the proxy:
```bash
go run main.go --port <PORT> [--username <USERNAME> --password <PASSWORD>]
```
By default, the proxy will run on port `3000`. If both `--username` and `--password` are omitted, authentication will be bypassed.
For example:
- To run the proxy on port `1489` without authentication:
```bash
go run main.go --port 1489
```
- To run the proxy on port `1489` with authentication:
```bash
go run main.go --port 1489 --username admin --password admin123
```
### Authentication
If you specify both `--username` and `--password` when starting the proxy, it will enforce Basic Proxy Authentication with the given credentials. If these parameters are omitted, the proxy will not require authentication.