Created: 2012-08-21 12:49
Updated: 2017-05-16 16:22


RelayProxy.js implements a forward proxy server in node.js with support for:

  • HTTP and HTTPS requests (SOCKS5 support coming in a future version)
  • Basic HTTP authorization
  • Forwarding to a remote proxy (with support for remote authorization), selectable at run-time based on incoming header and credentials

I wrote this server as I had a need for a private authenticated proxy server that would forward the request through a remote private proxy. The idea was to manage the amount of access a connecting client had to any given address and to manage which remote proxies (taken from a pool of rented third-party private proxies, each requiring authorization) were allocated to a given client, rotating those proxies depending on usage.

The server is very simple to use:


Basic usage

At its simplest, the following will instantiate a non-authenticating transparent proxy that forwards requests to the target url without relaying the request through a third-party proxy:

var RelayProxy = require('./path/to/relay-proxy');
var server = new RelayProxy();

Local authorization

To authorize access to your proxy, provide a handler function:

var RelayProxy = require('./path/to/relay-proxy');
var server = new RelayProxy();

server.authorize(function(req, username, password, callback) {
    // replace with code to verify username and password
    var isLoginCorrect = true;
    // call the supplied callback function to continue the request
    callback(null, isLoginCorrect);


Using a remote proxy

To forward requests via a third-party proxy, provide a handler function:

var RelayProxy = require('./path/to/relay-proxy');
var server = new RelayProxy();

server.selectForwardProxy(function(req, username, callback) {
    var proxy = {
        host: '',
        port: 31337,
        username: 'jimbob', // only supply a username and password if
        password: 'mcgee'   // the remote proxy requires authorization
    // the callback's second argument can be one of three values:
    // null:  no remote proxy - forward directly to the requested url
    // false: decline to forward the request (http 407 sent back to client)
    // proxy: proxy options as specified in the above sample

    callback(null, proxy);



RelayProxy has a dependency on node-http-proxy, by the good folks at Nodejitsu. Thankfully, it's available in the npm registry.

npm install http-proxy
Cookies help us deliver our services. By using our services, you agree to our use of cookies Learn more