mirror of
https://github.com/xzeldon/http-proxy-server.git
synced 2024-12-26 05:05:49 +00:00
chore(README.md): add README.md file with instructions on how to run the proxy server and its features
This commit is contained in:
parent
8e0a899bf2
commit
548ea691b4
48
README.md
Normal file
48
README.md
Normal 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.
|
Loading…
Reference in New Issue
Block a user