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.
Because bouncy doesn't touch the underlying data unless you explicitly tell it to, upgraded connections like websockets just work without doing anything special.
Route requests based on the host field to servers on ports 8001 and 8002:
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);
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.
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)
.
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.
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.
small message 4M message
(#/sec) (#/sec)
.----------------------------------
direct | 2558.10 135.47
http-proxy | 537.30 36.72
bouncy | 522.69 38.03
See bench/ for the complete results.
With npm, to get the library do:
npm install bouncy
or to install the command-line tool do:
npm install -g bouncy
MIT