ryancox / tlsrouter

TLS SNI router

TLSRouter is a TLS proxy that routes connections to backends based on the TLS SNI (Server Name Indication) of the TLS handshake. It carries no encryption keys and cannot decode the traffic that it proxies.

This is not an official Google project.

Installation

Install TLSRouter via go get:

go get go.universe.tf/tlsrouter

Usage

TLSRouter requires a configuration file that tells it what backend to use for a given hostname. The config file looks like:

# Basic hostname -> backend mapping
go.universe.tf localhost:1234

# DNS wildcards are understoor as well.
*.go.universe.tf 1.2.3.4:8080

# DNS wildcards can go anywhere in name.
google.* 10.20.30.40:443

# RE2 regexes are also available
/(alpha|beta|gamma)\.mon(itoring)?\.dave\.tf/ 100.200.100.200:443

TLSRouter takes one mandatory commandline argument, the configuration file to use:

tlsrouter -conf tlsrouter.conf

Optional flags are:

• -listen <addr>: set the listen address (default :443)
• -hello-timeout <duration>: how long to wait for the start of the TLS handshake (default 3s)