Skip to content


Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Simple proxy middleware for connect/express
branch: master
Failed to load latest commit information.
test Fix trailing slash bug
.gitignore Initial commit
.travis.yml Remove 0.6.0 from travis tests fix travis badge
index.js add onrequest and onresponse options
package.json release 0.5.11

simple-http-proxy Build Status

Simple proxy middleware for connect/express


Create an http app

 * Module dependencies
var express = require('express');
var proxy = require('simple-http-proxy');

 * Expose the app
var app = module.exports = express();

 * Mount the proxy middleware
app.use('/api', proxy(''));

Make the request

$ curl http://localhost:5000/api

<h1>Welcome to</h1>

You can also specify some options as a second parameter

app.use('/api', proxy('', opts));



Disable sending cookies by passing false; on by deafult.


Setting this to true will set x-forwarded-proto, x-forwarded-host, x-forwarded-port and x-forwarded-path headers.

Passing an object will override the header names:

  proto: 'x-orig-proto',
  host: 'x-orig-host',
  port: 'x-orig-port',
  path: 'x-orig-path'


A positive millisecond value for the timeout of the request. Defaults to 10000 (10s).

Setting it to false will disable the timeout.


A function to be called on each request. The first parameter will be the options object for the http request. The second will be the request object.

This can be used to change any of the http options for a given request.


A function to be called on each response. The first parameter will be the incoming message for a given request. The second will be the server response object.

If this function returns true the default pipe will not be used and will be up to the onresponse function to implement that behavior. This is useful for rewriting responses that are sent to the client.


$ npm test
Something went wrong with that request. Please try again.