websocketproxy.go 10 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325
  1. // Package websocketproxy is a reverse proxy for WebSocket connections.
  2. package websocketproxy
  3. import (
  4. "crypto/tls"
  5. "errors"
  6. "fmt"
  7. "io"
  8. "log"
  9. "net"
  10. "net/http"
  11. "net/url"
  12. "strings"
  13. "github.com/gorilla/websocket"
  14. "imuslab.com/zoraxy/mod/dynamicproxy/rewrite"
  15. "imuslab.com/zoraxy/mod/info/logger"
  16. )
  17. var (
  18. // DefaultUpgrader specifies the parameters for upgrading an HTTP
  19. // connection to a WebSocket connection.
  20. DefaultUpgrader = &websocket.Upgrader{
  21. ReadBufferSize: 1024,
  22. WriteBufferSize: 1024,
  23. }
  24. // DefaultDialer is a dialer with all fields set to the default zero values.
  25. DefaultDialer = websocket.DefaultDialer
  26. )
  27. // WebsocketProxy is an HTTP Handler that takes an incoming WebSocket
  28. // connection and proxies it to another server.
  29. type WebsocketProxy struct {
  30. // Director, if non-nil, is a function that may copy additional request
  31. // headers from the incoming WebSocket connection into the output headers
  32. // which will be forwarded to another server.
  33. Director func(incoming *http.Request, out http.Header)
  34. // Backend returns the backend URL which the proxy uses to reverse proxy
  35. // the incoming WebSocket connection. Request is the initial incoming and
  36. // unmodified request.
  37. Backend func(*http.Request) *url.URL
  38. // Upgrader specifies the parameters for upgrading a incoming HTTP
  39. // connection to a WebSocket connection. If nil, DefaultUpgrader is used.
  40. Upgrader *websocket.Upgrader
  41. // Dialer contains options for connecting to the backend WebSocket server.
  42. // If nil, DefaultDialer is used.
  43. Dialer *websocket.Dialer
  44. Verbal bool
  45. Options Options
  46. }
  47. // Additional options for websocket proxy runtime
  48. type Options struct {
  49. SkipTLSValidation bool //Skip backend TLS validation
  50. SkipOriginCheck bool //Skip origin check
  51. CopyAllHeaders bool //Copy all headers from incoming request to backend request
  52. UserDefinedHeaders []*rewrite.UserDefinedHeader //User defined headers
  53. Logger *logger.Logger //Logger, can be nil
  54. }
  55. // ProxyHandler returns a new http.Handler interface that reverse proxies the
  56. // request to the given target.
  57. func ProxyHandler(target *url.URL, options Options) http.Handler {
  58. return NewProxy(target, options)
  59. }
  60. // NewProxy returns a new Websocket reverse proxy that rewrites the
  61. // URL's to the scheme, host and base path provider in target.
  62. func NewProxy(target *url.URL, options Options) *WebsocketProxy {
  63. backend := func(r *http.Request) *url.URL {
  64. // Shallow copy
  65. u := *target
  66. u.Fragment = r.URL.Fragment
  67. u.Path = r.URL.Path
  68. u.RawQuery = r.URL.RawQuery
  69. return &u
  70. }
  71. // Create a new websocket proxy
  72. wsprox := &WebsocketProxy{Backend: backend, Verbal: false, Options: options}
  73. if options.CopyAllHeaders {
  74. wsprox.Director = DefaultDirector
  75. }
  76. return wsprox
  77. }
  78. // Utilities function for log printing
  79. func (w *WebsocketProxy) Println(messsage string, err error) {
  80. if w.Options.Logger != nil {
  81. w.Options.Logger.PrintAndLog("websocket", messsage, err)
  82. return
  83. }
  84. log.Println("[websocketproxy] [system:info]"+messsage, err)
  85. }
  86. // DefaultDirector is the default implementation of Director, which copies
  87. // all headers from the incoming request to the outgoing request.
  88. func DefaultDirector(r *http.Request, h http.Header) {
  89. //Copy all header values from request to target header
  90. for k, vv := range r.Header {
  91. for _, v := range vv {
  92. h.Set(k, v)
  93. }
  94. }
  95. // Remove hop-by-hop headers
  96. for _, removePendingHeader := range []string{
  97. "Connection",
  98. "Keep-Alive",
  99. "Proxy-Authenticate",
  100. "Proxy-Authorization",
  101. "Te",
  102. "Trailers",
  103. "Transfer-Encoding",
  104. "Sec-WebSocket-Extensions",
  105. "Sec-WebSocket-Key",
  106. "Sec-WebSocket-Protocol",
  107. "Sec-WebSocket-Version",
  108. "Upgrade",
  109. } {
  110. h.Del(removePendingHeader)
  111. }
  112. }
  113. // ServeHTTP implements the http.Handler that proxies WebSocket connections.
  114. func (w *WebsocketProxy) ServeHTTP(rw http.ResponseWriter, req *http.Request) {
  115. if w.Backend == nil {
  116. w.Println("Invalid websocket backend configuration", errors.New("backend function not found"))
  117. http.Error(rw, "internal server error (code: 1)", http.StatusInternalServerError)
  118. return
  119. }
  120. backendURL := w.Backend(req)
  121. if backendURL == nil {
  122. w.Println("Invalid websocket backend configuration", errors.New("backend URL is nil"))
  123. http.Error(rw, "internal server error (code: 2)", http.StatusInternalServerError)
  124. return
  125. }
  126. dialer := w.Dialer
  127. if w.Dialer == nil {
  128. if w.Options.SkipTLSValidation {
  129. //Disable TLS secure check if target allow skip verification
  130. bypassDialer := websocket.DefaultDialer
  131. bypassDialer.TLSClientConfig = &tls.Config{InsecureSkipVerify: true}
  132. dialer = bypassDialer
  133. } else {
  134. //Just use the default dialer come with gorilla websocket
  135. dialer = DefaultDialer
  136. }
  137. }
  138. // Pass headers from the incoming request to the dialer to forward them to
  139. // the final destinations.
  140. requestHeader := http.Header{}
  141. if origin := req.Header.Get("Origin"); origin != "" {
  142. requestHeader.Add("Origin", origin)
  143. }
  144. for _, prot := range req.Header[http.CanonicalHeaderKey("Sec-WebSocket-Protocol")] {
  145. requestHeader.Add("Sec-WebSocket-Protocol", prot)
  146. }
  147. for _, cookie := range req.Header[http.CanonicalHeaderKey("Cookie")] {
  148. requestHeader.Add("Cookie", cookie)
  149. }
  150. if req.Host != "" {
  151. requestHeader.Set("Host", req.Host)
  152. }
  153. // Pass X-Forwarded-For headers too, code below is a part of
  154. // httputil.ReverseProxy. See http://en.wikipedia.org/wiki/X-Forwarded-For
  155. // for more information
  156. // TODO: use RFC7239 http://tools.ietf.org/html/rfc7239
  157. if clientIP, _, err := net.SplitHostPort(req.RemoteAddr); err == nil {
  158. // If we aren't the first proxy retain prior
  159. // X-Forwarded-For information as a comma+space
  160. // separated list and fold multiple headers into one.
  161. if prior, ok := req.Header["X-Forwarded-For"]; ok {
  162. clientIP = strings.Join(prior, ", ") + ", " + clientIP
  163. }
  164. requestHeader.Set("X-Forwarded-For", clientIP)
  165. }
  166. // Set the originating protocol of the incoming HTTP request. The SSL might
  167. // be terminated on our site and because we doing proxy adding this would
  168. // be helpful for applications on the backend.
  169. requestHeader.Set("X-Forwarded-Proto", "http")
  170. if req.TLS != nil {
  171. requestHeader.Set("X-Forwarded-Proto", "https")
  172. }
  173. // Enable the director to copy any additional headers it desires for
  174. // forwarding to the remote server.
  175. if w.Director != nil {
  176. w.Director(req, requestHeader)
  177. }
  178. // Replace header variables and copy user-defined headers
  179. rewrittenUserDefinedHeaders := rewrite.PopulateRequestHeaderVariables(req, w.Options.UserDefinedHeaders)
  180. upstreamHeaders, _ := rewrite.SplitUpDownStreamHeaders(&rewrite.HeaderRewriteOptions{
  181. UserDefinedHeaders: rewrittenUserDefinedHeaders,
  182. })
  183. for _, headerValuePair := range upstreamHeaders {
  184. requestHeader.Set(headerValuePair[0], headerValuePair[1])
  185. }
  186. // Connect to the backend URL, also pass the headers we get from the requst
  187. // together with the Forwarded headers we prepared above.
  188. // TODO: support multiplexing on the same backend connection instead of
  189. // opening a new TCP connection time for each request. This should be
  190. // optional:
  191. // http://tools.ietf.org/html/draft-ietf-hybi-websocket-multiplexing-01
  192. connBackend, resp, err := dialer.Dial(backendURL.String(), requestHeader)
  193. if err != nil {
  194. w.Println("Couldn't dial to remote backend url "+backendURL.String(), err)
  195. if resp != nil {
  196. // If the WebSocket handshake fails, ErrBadHandshake is returned
  197. // along with a non-nil *http.Response so that callers can handle
  198. // redirects, authentication, etcetera.
  199. if err := copyResponse(rw, resp); err != nil {
  200. w.Println("Couldn't write response after failed remote backend handshake to "+backendURL.String(), err)
  201. }
  202. } else {
  203. http.Error(rw, http.StatusText(http.StatusServiceUnavailable), http.StatusServiceUnavailable)
  204. }
  205. return
  206. }
  207. defer connBackend.Close()
  208. upgrader := w.Upgrader
  209. if w.Upgrader == nil {
  210. upgrader = DefaultUpgrader
  211. }
  212. //Fixing issue #107 by bypassing request origin check
  213. if w.Options.SkipOriginCheck {
  214. upgrader.CheckOrigin = func(r *http.Request) bool {
  215. return true
  216. }
  217. }
  218. // Only pass those headers to the upgrader.
  219. upgradeHeader := http.Header{}
  220. if hdr := resp.Header.Get("Sec-Websocket-Protocol"); hdr != "" {
  221. upgradeHeader.Set("Sec-Websocket-Protocol", hdr)
  222. }
  223. if hdr := resp.Header.Get("Set-Cookie"); hdr != "" {
  224. upgradeHeader.Set("Set-Cookie", hdr)
  225. }
  226. // Now upgrade the existing incoming request to a WebSocket connection.
  227. // Also pass the header that we gathered from the Dial handshake.
  228. connPub, err := upgrader.Upgrade(rw, req, upgradeHeader)
  229. if err != nil {
  230. w.Println("Couldn't upgrade incoming request", err)
  231. return
  232. }
  233. defer connPub.Close()
  234. errClient := make(chan error, 1)
  235. errBackend := make(chan error, 1)
  236. replicateWebsocketConn := func(dst, src *websocket.Conn, errc chan error) {
  237. for {
  238. msgType, msg, err := src.ReadMessage()
  239. if err != nil {
  240. m := websocket.FormatCloseMessage(websocket.CloseNormalClosure, fmt.Sprintf("%v", err))
  241. if e, ok := err.(*websocket.CloseError); ok {
  242. if e.Code != websocket.CloseNoStatusReceived {
  243. m = websocket.FormatCloseMessage(e.Code, e.Text)
  244. }
  245. }
  246. errc <- err
  247. dst.WriteMessage(websocket.CloseMessage, m)
  248. break
  249. }
  250. err = dst.WriteMessage(msgType, msg)
  251. if err != nil {
  252. errc <- err
  253. break
  254. }
  255. }
  256. }
  257. go replicateWebsocketConn(connPub, connBackend, errClient)
  258. go replicateWebsocketConn(connBackend, connPub, errBackend)
  259. var message string
  260. select {
  261. case err = <-errClient:
  262. message = "websocketproxy: Error when copying from backend to client: %v"
  263. case err = <-errBackend:
  264. message = "websocketproxy: Error when copying from client to backend: %v"
  265. }
  266. if e, ok := err.(*websocket.CloseError); !ok || e.Code == websocket.CloseAbnormalClosure {
  267. if w.Verbal {
  268. //Only print message on verbal mode
  269. log.Printf(message, err)
  270. }
  271. }
  272. }
  273. func copyHeader(dst, src http.Header) {
  274. for k, vv := range src {
  275. for _, v := range vv {
  276. dst.Add(k, v)
  277. }
  278. }
  279. }
  280. func copyResponse(rw http.ResponseWriter, resp *http.Response) error {
  281. copyHeader(rw.Header(), resp.Header)
  282. rw.WriteHeader(resp.StatusCode)
  283. defer resp.Body.Close()
  284. _, err := io.Copy(rw, resp.Body)
  285. return err
  286. }