gohttpsserver

README

Go HTTPS Server and Proxy

Serves local files over HTTPS using a self-signed certificate. The certificate is generated when the server starts.

Usage

1. go run cmd/https_server.go
2. open https://localhost:8000/

Proxy

Proxies HTTPS requests to an HTTP server. Quick and dirty hack I use to test an HTTPS app locally. In production, we use nginx to decode HTTPS. This is a single binary to simulate that environment. It sends X-Forwarded-For and X-Forwarded-Proto headers, and passes through the Host header.

1. go run cmd/https_proxy.go http://localhost:5000/
2. open https://localhost:8001/

Documentation

Index

• func NewSelfSignedCertificate(hosts []string) (tls.Certificate, error)
• func Serve(addr string, certificate tls.Certificate, handler http.Handler) error
• func ServeWithNewSelfSigned(addr string, handler http.Handler) error
• type Mapping
  • func ParseMappings(mapping string) []*Mapping
• type ReverseProxy
  • func NewSingleHostReverseProxy(target *url.URL) *ReverseProxy
  • func (proxy *ReverseProxy) MapPrefix(prefix string, target *url.URL)

Functions

func NewSelfSignedCertificate

func NewSelfSignedCertificate(hosts []string) (tls.Certificate, error)

Based on generate_cert: https://code.google.com/p/go/source/browse/src/pkg/crypto/tls/generate_cert.go

func Serve

func Serve(addr string, certificate tls.Certificate, handler http.Handler) error

func ServeWithNewSelfSigned

func ServeWithNewSelfSigned(addr string, handler http.Handler) error

Types

type Mapping

type Mapping struct {
	Prefix string
	Target *url.URL
}

TODO: Make private?

func ParseMappings

func ParseMappings(mapping string) []*Mapping

TODO: Move elsewhere?

type ReverseProxy

type ReverseProxy struct {
	*httputil.ReverseProxy

	OverrideHost string
	// contains filtered or unexported fields
}

Wraps httputil.ReverseProxy to add additional configurable hacks

func NewSingleHostReverseProxy

func NewSingleHostReverseProxy(target *url.URL) *ReverseProxy

func (*ReverseProxy) MapPrefix

func (proxy *ReverseProxy) MapPrefix(prefix string, target *url.URL)