Timofey Gelazoniya e2b6029102 | ||
---|---|---|
.github/workflows | ||
.gitignore | ||
LICENSE | ||
README.md | ||
build.sh | ||
go.mod | ||
main.go |
README.md
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
Prerequisites
- Golang (if building from source)
Usage
Running the Proxy
For Darwin/Linux:
-
Download the latest release for your platform from GitHub releases
-
Extract the downloaded archive:
tar -xvzf http-proxy-server-v{version}-{platform}-{arch}.tar.gz
-
Navigate to the extracted folder:
cd http-proxy-server-v{version}-{platform}-{arch}
-
Run the proxy:
./http-proxy-server --port <PORT> [--username <USERNAME> --password <PASSWORD>]
For Windows:
-
Download the latest release for Windows from GitHub releases
-
Extract the downloaded ZIP archive
-
Navigate to the extracted folder.
-
Open a command prompt in this directory.
-
Run the proxy:
proxy_name.exe --port <PORT> [--username <USERNAME> --password <PASSWORD>]
From Source
- Clone the repository:
git clone https://github.com/xzeldon/http-proxy-server.git
cd http-proxy-server
- Run the proxy:
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:
go run main.go --port 1489
- To run the proxy on port
1489
with authentication:
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.
License
This project is licensed under the MIT License.