mirror of https://github.com/xzeldon/http-proxy-server.git synced 2024-12-25 17:55:47 +00:00

Simple http proxy server implemented in Go

Go to file

xzeldon b460788b42 feat: implement release workflow and add license file		2023-10-31 21:06:29 +03:00
.github/workflows	feat: implement release workflow and add license file	2023-10-31 21:06:29 +03:00
.gitignore	initial commit	2023-10-31 21:05:50 +03:00
build.sh	initial commit	2023-10-31 21:05:50 +03:00
go.mod	chore(go.mod): update module name to match the actual repository URL	2023-10-31 21:06:23 +03:00
LICENSE	feat: implement release workflow and add license file	2023-10-31 21:06:29 +03:00
main.go	fix(main.go) code refactoring and comments	2023-10-31 21:06:26 +03:00
README.md	chore(README.md): add README.md file with instructions on how to run the proxy server and its features	2023-10-31 21:06:20 +03:00

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

Requirements

Go (version 1.x+)

Usage

Running the Proxy 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.