koa-http-proxy-server

koa2 http-proxy-middleware fixed bodyParser preposition

Installatiion

1$ npm install koa-http-proxy-server --save

Example

example with koa server

1// include dependencies
2const Koa=require('koa')
3const {createProxyMiddleware} = require('koa-http-proxy-server');
4
5// proxy middleware options
6const options = {
7  target: 'http://www.example.org', // target host
8  changeOrigin: true, // needed for virtual hosted sites
9  ws: true, // proxy websockets
10  pathRewrite: {
11    '^/api/old-path': '/api/new-path', // rewrite path
12    '^/api/remove/path': '/path', // remove base path
13  },
14  router: {
15    // when request.headers.host == 'dev.localhost:3000',
16    // override target 'http://www.example.org' to 'http://localhost:8000'
17    'dev.localhost:3000': 'http://localhost:8000',
18  },
19};
20
21// create the proxy (without context)
22const exampleProxy = createProxyMiddleware('/api',options);
23
24// mount `exampleProxy` in web server
25const app = new Koa();
26app.use(exampleProxy);
27app.listen(3000);

Fix hung up with bodyParser

Currently the only pre-provided request interceptor is fixRequestBody, which is used to fix proxied POST requests when bodyParser is applied before this middleware.

Example:

1const bodyParser = require('koa-bodyparser');
2const {createProxyMiddleware,fixRequestBody} = require('koa-http-proxy-server');
3
4const exampleProxy = createProxyMiddleware('/api',{
5  /**
6   * Fix bodyParser
7   **/
8  onProxyReq: fixRequestBody,
9});
10
11app.use(bodyParser())
12   .use(exampleProxy)
13   .listen(3000);

Options

All options are passed to http-proxy-middleware. See http-proxy-middleware for full list of accepted options.