express-http-proxy是一个express代理中间件，其用法如下：

安装

npm install express-http-proxy

用法

proxy(host, options);

例如，将路由为'/proxy'的请求转发至‘www.google.com’：则可用下列语句实现

var proxy = require('express-http-proxy'); 
var app = require('express')(); 
app.use('/proxy', proxy('www.google.com'));

Options

forwardPath

forwardPath选项用于在代理请求之前修改路径

var proxy = require('express-http-proxy'); 
var app = require('express')(); 
app.use('/proxy', proxy('www.google.com', {
  forwardPath: function(req, res) {
    return require('url').parse(req.url).path;
  }
}));

forwardPathAsync

forwardPathAsync选项用于在发送代理请求之前之前，使用Promise异步修改请求路径

app.use(proxy('httpbin.org', {
  forwardPathAsync: function() {
    return new Promise(function(resolve, reject) {
      // ... 
      // eventually 
      resolve( /* your resolved forwardPath as string */ )
    });
  }
}));

filter

filter选项主要用于筛选哪些请求可以被代理转发，例如，你只想转发get请求

app.use('/proxy', proxy('www.google.com', {
  filter: function(req, res) {
     return req.method == 'GET';
  },
  forwardPath: function(req, res) {
    return require('url').parse(req.url).path;
  }
}));

intercept

intercept选项用于在将响应返回给客户端之前，对响应做处理

app.use('/proxy', proxy('www.google.com', {
  intercept: function(rsp, data, req, res, callback) {
    // rsp - original response from the target 
    data = JSON.parse(data.toString('utf8'));
    callback(null, JSON.stringify(data));
  }
}));

decorateRequest

与intercept相反，decorateRequest选项用于在请求通过代理转发至目标主机之前，对请求进行处理

app.use('/proxy', proxy('www.google.com', {
  decorateRequest: function(proxyReq, originalReq) {
    // you can update headers 
    proxyReq.headers['Content-Type'] = 'text/html';
    // you can change the method 
    proxyReq.method = 'GET';
    // you can munge the bodyContent. 
    proxyReq.bodyContent = proxyReq.bodyContent.replace(/losing/, 'winning!');
    return proxyReq;
  }
}));

https

通常代理请求的协议类型与原始请求保持一致，如果代理请求需要用https协议，可以用https选项强制实现

app.use('/proxy', proxy('www.google.com', {
  https: true
}));

preserveHostHdr

可以用preserveHostHdr选项将HTTP头部复制到express代理服务器的HTTP头部

app.use('/proxy', proxy('www.google.com', {
  preserveHostHdr: true
}));

reqAsBuffer

这是一个实验选项，用于在发送代理请求时，保证请求体（req.body）编码为Node Buffer

app.use('/proxy', proxy('www.google.com', {
  reqAsBuffer: true
}));

reqBodyEncoding

request body默认编码格式为 utf-8。
当代理请求体为Buffer时，使用null来保存缓冲(例如，图像上传) ，接受 raw-body支持的任何值。
编码格式也可以通过intercept选项实现

app.use('/post', proxy('httpbin.org', {
  reqBodyEncoding: null
}));

timeout

默认情况下。node在连接过程中，是没有timeout的。使用timeout选项增加超时，Timed-out requests 将会返回504和X-Timeout-Reason header。

app.use('/', proxy('httpbin.org', {
  timeout: 2000  // in milliseconds, two seconds 
}));