blu

Balance the Load for UDP

Blu balances a UDP traffic load coming from a set of origins destined for a set of termini. In short, it is a UDP Load Balancing Router.

Install

Install blu as you would any other Go program:

go get github.com/vsayer/blu

Usage

origins do not require ack

blu -host=<host> -port=<port> -termini=<comma-separated host:port list>

origins do not require ack AND forwarder requires fixed outgoing port

blu -host=<host> -port=<port> -termini=<comma-separated host:port list> \
-udp-forward-port=<port>

origins require ack

blu -host=<host> -port=<port> -termini=<comma-separated host:port list> \
-ack-forward -ack-port=<port>

origins require ack AND forwarder requires fixed outgoing port

blu -host=<host> -port=<port> -termini=<comma-separated host:port list> \
-ack-forward -ack-port=<port> -udp-forward-port=<port>

reset routing table

blu -reset

Features

• supports IPv4 and IPv6
• supports origin expecting ack for reliability
• ability to balance by finding least-loaded terminus
• ability to fix outgoing port on forwarder
• routes are preserved on exit
• routes can be reset

Build

If you want to develop blu, a Makefile is included and building is straightforward.

make

Roadmap for v1.0

• origins require ack (send back on forwarder)

blu -host=<host> -port=<port> -termini=<comma-separated host:port list> \
-ack-forward

• origins require ack (send back on forwarder) AND forwarder outgoing port is fixed

blu -host=<host> -port=<port> -termini=<comma-separated host:port list> \
-ack-forward -udp-forward-port=<port>

• unit tests courtesy of GoConvey
• readthedocs integration for use cases
• peformance profiling
• lint for more idiomatic code
• refactor for more idiomatic code
• logo
• adhoc mode: add or delete termini on-the-fly
• IPv4 <-> IPv6 translation: origins and termini do not have to follow same protocol
• auto-rebalancing: for when termini go offline
• yml configuration
• init service
• dockerization

Ideation for beyond v1.0

• companion REPL client
• balancing algorithms other than least-loaded
• deep learning
• clustering to handle restricted routes
• alerting
• DHT?

License

BSD 3-Clause