simple-go-reverse-proxy

README

simple-go-reverse-proxy

A simple HTTP reverse proxy written in Go which has basic support for websockets.

Installation

1. Install golang here.
2. Run the following command to install dependencies:

   go get github.com/gorilla/websocket
   

3. Run the following commands to clone the repo and build the proxy:

   git clone https://github.com/dli357/simple-go-reverse-proxy
   cd simple-go-reverse-proxy
   go build
   

Running the Proxy

Run the following command to run the proxy after building the proxy:

./simple-go-reverse-proxy
  --port=<port> 
  --backend=<address:port>
  [--insert-header=<header> --insert-header-val=<header-value> ...]
  [--websocket-scheme=<scheme>]

• port: The port to serve from.
• backend: The backend URL to proxy requests to. Should use the http scheme.
• insert-header: An optional header to inject into all requests. This can be specified multiple times to inject multiple headers.
• insert-header-val: An optional header value for the insert-header header. Must be specified the same number of times as insert-header.
• websocket-scheme: Used to specify the scheme for the proxy to use when proxying a websocket connection to the backend. Default is ws.

Example usage:

The following command proxies all HTTP and websocket requests to localhost:8002 to localhost:8000. Additionally, it injects an Authorization and Test headers into every request as well.

./simple-go-reverse-proxy --backend=http://localhost:8000 --port=8002 --insert-header=Authorization --insert-header-val="Bearer test-value" --insert-header="Test" --insert-header-val="test-value"

Documentation

Overview

Simple go proxy which supports websockets and inserts a specified header and value. Usage:

./simple-go-proxy --backend=<address:port> --port=<port> [--insert-header=<header> --insert-header-val=<header-value> ...] [--websocket-scheme=<scheme>]