Categorygithub.com/koding/websocketproxy
modulepackage
0.0.0-20181220232114-7ed82d81a28c
Repository: https://github.com/koding/websocketproxy.git
Documentation: pkg.go.dev

# README

WebsocketProxy GoDoc Build Status

WebsocketProxy is an http.Handler interface build on top of gorilla/websocket that you can plug into your existing Go webserver to provide WebSocket reverse proxy.

Install

go get github.com/koding/websocketproxy

Example

Below is a simple server that proxies to the given backend URL

package main

import (
	"flag"
	"net/http"
	"net/url"

	"github.com/koding/websocketproxy"
)

var (
	flagBackend = flag.String("backend", "", "Backend URL for proxying")
)

func main() {
	u, err := url.Parse(*flagBackend)
	if err != nil {
		log.Fatalln(err)
	}

	err = http.ListenAndServe(":80", websocketproxy.NewProxy(u))
	if err != nil {
		log.Fatalln(err)
	}
}

Save it as proxy.go and run as:

go run proxy.go -backend ws://example.com:3000

Now all incoming WebSocket requests coming to this server will be proxied to ws://example.com:3000

# Functions

NewProxy returns a new Websocket reverse proxy that rewrites the URL's to the scheme, host and base path provider in target.
ProxyHandler returns a new http.Handler interface that reverse proxies the request to the given target.

# Variables

DefaultDialer is a dialer with all fields set to the default zero values.
DefaultUpgrader specifies the parameters for upgrading an HTTP connection to a WebSocket connection.

# Structs

WebsocketProxy is an HTTP Handler that takes an incoming WebSocket connection and proxies it to another server.