Skip to content

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
JavaScript

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
bench
bin
example
lib
test
.travis.yml
index.js
package.json
readme.markdown

readme.markdown

bouncy

route http requests to incoming http servers

bouncy uses http-raw to extend the core node http apis with fully transparent streaming without resulting to re-normalizing the requests.

build status

trampoline

example

route.js

Route requests based on the host field

var bouncy = require('bouncy');

var server = bouncy(function (req, res, bounce) {
    if (req.headers.host === 'beep.example.com') {
        bounce(8001);
    }
    else if (req.headers.host === 'boop.example.com') {
        bounce(8002);
    }
    else {
        res.statusCode = 404;
        res.end('no such host');
    }
});
server.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 "" for the host as a default route.

var server = bouncy(opts={}, cb)

bouncy(cb) returns a new net.Server object that you can .listen() on.

If you specify opts.key and opts.cert, the connection will be set to secure mode using tls. Do this if you want to make an https router.

If the arity of cb is 3, you'll get the response object res in cb(req, res, bounce). Otherwise you just get cb(req, bounce).

bounce(stream, opts={})

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.

To send data to a different url path on the destination stream, you can specify opts.path.

You can specify header fields to insert into the request with opts.headers.

By default, "x-forwarded-for", "x-forwarded-port", and "x-forwarded-proto" are all automatically inserted into the outgoing header.

bounce() returns the stream object that it uses to connect to the remote host.

bounce(port, ...), bounce(host, port, ...), bounce(url)

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

Optionally you can pass port and host keys to opts and it does the same thing.

Passing bounce() a string that looks like a url (with or without "http://") will set the opts.host, opts.port, and opts.path accordingly.

install

With npm, to get the library do:

npm install bouncy

or to install the command-line tool do:

npm install -g bouncy

license

MIT

Something went wrong with that request. Please try again.