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

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.