Skip to content
This repository

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP

bounce HTTP requests around for load balancing or as an HTTP host router

Fetching latest commit…

Octocat-spinner-32-eaf2f5

Cannot retrieve the latest commit at this time

Octocat-spinner-32 bin
Octocat-spinner-32 example
Octocat-spinner-32 test
Octocat-spinner-32 README.markdown
Octocat-spinner-32 index.js
Octocat-spinner-32 package.json
README.markdown

bouncy

Bouncy uses node's http parser innards to bounce http requests around to where they need to go in an entirely transparent way.

Use bouncy as a load balancer or http host router, either programmatically or with the simple command-line tool.

Bouncy is websocket-capable.

example

route.js

Route requests based on the host field

var bouncy = require('bouncy');

bouncy(function (req, bounce) {
    if (req.headers.host === 'beep.example.com') {
        bounce(8001);
    }
    else if (req.headers.host === 'boop.example.com') {
        bounce(8002)
    }
}).listen(8000);

command-line

Just create a routes.json file like this:

{
    "beep.example.com" : 8000,
    "boop.example.com" : 8001
}

Then point the bouncy command at this routes.json file and give it a port to listen on:

bouncy routes.json 80

The routes.json file should just map host names to host/port combos. Use a colon-separated string to specify a host and port in a route. Use '' as a default route.

bouncy(cb)

There is only one method, bouncy(cb). Your callback cb will get these arguments:

req

The node http module request object.

bounce(stream)

Call this function when you're ready to bounce the request to a stream.

The exact request that was received will be written to stream and future incoming data will be piped to and from it.

bounce(port), bounce(host, port)

These variants of bounce() are sugar for bounce(net.createConnection(port)) and bounce(net.createConnection(port, host)).

install

With npm, do:

npm install bouncy

to install as a library or

npm install -g bouncy

to get the command-line tool.

license

MIT/X11

Something went wrong with that request. Please try again.