# 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 YAML and could look like this:

```toml
# Both the 'http' and 'https' sections are optional
http:
  # the value for 'bind' can either be a string or a list of strings
  bind: [ "127.0.0.1:8080", "[::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)