http2-proxy

node-http2-proxy

A simple http/2 & http/1.1 to http/1.1 spec compliant proxy helper for Node.

Features

• Proxies HTTP 2, HTTP 1.1 and WebSocket
• Simple and easy to follow implementation
• Hop by hop header handling
• Connection header handling
• Via header handling
• Forwarded header handling

Installation

$ npm install http2-proxy

Notes

http2-proxy requires node v8.5.0 or newer with http2 enabled. See nightly node builds or building node from source. Pass the --expose-http2 option when starting node v8.x.x.

Usage

You must pass allowHTTP1: true to the http2.createServer or http2.createSecureServer factory methods.

import http2 from 'http2'
import proxy from 'http2-proxy'

const server = http2.createServer({ allowHTTP1: true })
server.listen(8000)

Proxy HTTP 1.1/2 and WebSocket

server.on('request', (req, res) => {
  proxy.web(req, res, {
    hostname: 'localhost'
    port: 9000
  }, err => console.error(err, 'proxy error'))
})
server.on('upgrade', (req, socket, head) => {
  proxy.ws(req, socket, head, {
    hostname: 'localhost'
    port: 9000
  }, err => console.error(err, 'proxy error'))
})

Use Helmet to secure response headers

server.on('request', (req, res) => {
  proxy.web(req, res, {
    hostname: 'localhost'
    port: 9000,
    onRes: (req, resHeaders) => helmet({
      setHeader (key, val) {
        resHeaders[key.trim().toLowerCase()] = val
      },
      getHeader (key) {
        return resHeaders[key.trim().toLowerCase()]
      },
      removeHeader (key) {
        delete resHeaders[key.trim().toLowerCase()]
      }
    }, () => {})
  }, err => console.error(err, 'proxy error'))
})

Add x-forwarded headers

server.on('request', (req, res) => {
  proxy.web(req, res, {
    hostname: 'localhost'
    port: 9000,
    onReq: (req, reqHeaders) => {
      reqHeaders['x-forwarded-for'] = req.socket.remoteAddress
      reqHeaders['x-forwarded-proto'] = req.socket.encrypted ? 'https' : 'http'
      reqHeaders['x-forwarded-host'] = req.headers['host']
    }
  }, err => console.error(err, 'proxy error'))
})

API

web (req, res, options, onProxyError)

• req: http.IncomingMessage or http2.Http2ServerRequest
• res: http.ServerResponse or http2.Http2ServerResponse
• options: see Options
• onProxyError(err): called on error

ws (req, socket, head, options, onProxyError)

• req: http.IncomingMessage
• socket: net.Socket
• head: Buffer
• options: see Options
• onProxyError(err): called on error

Options

• hostname: target hostname
• port: target port
• timeout: incoming request timeout
• proxyTimeout: proxy request timeout
• proxyName: proxy name used for Via header
• onReq(req, reqHeaders): called before proxy request
• onRes(req, resHeaders): called before proxy response

License

MIT