File: README.md

package info (click to toggle)
slt 0.0.git20140301-3
  • links: PTS, VCS
  • area: main
  • in suites: stretch
  • size: 136 kB
  • ctags: 53
  • sloc: makefile: 13
file content (68 lines) | stat: -rw-r--r-- 1,837 bytes parent folder | download | duplicates (3)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
slt is a dead-simple TLS reverse-proxy with SNI multiplexing (TLS virtual hosts).

That means you can send TLS/SSL connections for multiple different applications to the same port and forward
them all to the appropriate backend hosts depending on the intended destination.

# Features

### SNI Multiplexing
slt multiplexes connections to a single TLS port by inspecting the name in the SNI extension field of each connection.

### Simple YAML Configuration
You configure slt with a simple YAML configuration file:

    bind_addr: ":443"

    frontends:
      v1.example.com:
        backends:
          -
            addr: ":4443"

      v2.example.com:
        backends:
          -
            addr: "192.168.0.2:443"
          -
            addr: "192.168.0.1:443"


### Optional TLS Termination
Sometimes, you don't actually want to terminate the TLS traffic, you just want to forward it elsewhere. slt only
terminates the TLS traffic if you specify a private key and certificate file like so:

    frontends:
      v1.example.com:
        tls_key: /path/to/v1.example.com.key
        tls_crt: /path/to/v1.example.com.crt


### Round robin load balancing among arbitrary backends
slt performs simple round-robin load balancing when more than one backend is available (other strategies will be available in the future):

    frontends:
      v1.example.com:
        backends:
          -
            addr: ":8080"
          -
            addr: ":8081"


# Running it
Running slt is also simple. It takes a single argument, the path to the configuration file:

    ./slt /path/to/config.yml


# Building it
Just cd into the directory and "go build". It requires Go 1.1+.

# Testing it
Just cd into the directory and "go test".

# Stability
I run slt in production handling hundreds of thousands of connections daily.

# License
Apache