blob: 3d4eb28d6f5b4770041177614da39405559a34c8 (
plain)
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
|
# gnix
a simple stupid reverse proxy
## Features
- Simple to configure (see below)
- Handles connection upgrades correctly by default (websocket, etc.)
- TLS support
- _TODO: h2; match on uris; connection pools_
## Usage
Run the binary with the a path to the configuration as the first argument. The
configuration file is written in TOML and could look like this:
```toml
# Both the [http] and [https] sections are optional
[http]
bind = "127.0.0.1:8080"
[https]
bind = "127.0.0.1:8443"
tls_cert = "ssl/cert.pem"
tls_key = "ssl/key.pem" # only accepts pkcs8 for now
# this is a lookup table from hostnames to backend address
# in this case, requests for `testdomain.local` are forwarded to 127.0.0.1:3000
[hosts]
"testdomain.local" = { backend = "127.0.0.1:3000" }
"secondomain.local" = { backend = "1.2.3.4:5678" }
"static.testdomain.local" = { files = { root = "/srv/http", index = true } }
```
The configuration can either be specify a backend to forward to or the `files`
key. In that case, static files are served from `root` and directory listings
will be generated if `index` is true (default). If a directory contains
`index.html` the listing is replace with that file. If `index.banner.html`, it's
content is inserted before the listing.
# License
AGPL-3.0-only; see [COPYING](./COPYING)
|
