node package manager
Share your code. npm Orgs help your team discover, share, and reuse code. Create a free org ยป



Build Status npm version

RedRouter is a universal reverse-proxy developed in Node.JS. It is designed to be modular as possible, allowing you to use whatever Backend, Resolver and Proxy Agent you wish. What are these things, you ask?



Backends are used to store the proxy records themselves. By default, RedRouter stores proxy records in a memory cache, but you can additionally choose to search the following:

  • etcd
  • memcached
  • mongodb
  • mysql
  • redis
  • consul

once a record has been found, it is added to the local memory cache, to reduce the time for subsequent requests.


Resolvers are used to find the proxy record matching a particular request. This is usually protocol-specific as different request headers require different methods of matching. Some that have been implemented:

  • SSH (Username)


Your application can optionally implement a middleware stack, used to transform the content of proxy records. This could be anything- logging, load balancing, even Docker discovery. As with other middleware stacks, order does matter- so be sure to document this in developing your middleware.

  • docker resolution
  • round robin
  • dynamic load balancing

Proxy Agent

Proxy agents forward the content to a destination given the route provided by the resolver. Some that have been implemented:

  • HTTP
  • TCP
  • SSH (Requires SSH Resolver)
  • SSH over WebSockets (Basic wrapper used by Wetty)

Getting Started



If you wish to use encryption (for HTTPS, etc), you can pass options into the SSL object:

ssl: {
  key : fs.readFileSync('/root/local/host.key'),
  cert : fs.readFileSync('/root/local/host.cert')


RedRouter uses Winston logging throughout.



RedRouter began by merging code from the RedBird and RedWire projects. Thanks to them for their incredible contribuitions!

Because of its modularity, contributing to the RedRouter project is easy. Simply make a feature request in the issues, so that we can discuss any details, and you can ask any questions that arise. Right now, packages in the /agent, /backend, /middleware and /resolver folders will all be included in the core module- but to reduce the number of dependencies in the future, these will be moved to separate repositories.