proxima/README.md

30 lines
928 B
Markdown
Raw Normal View History

2022-07-21 00:26:06 +02:00
# Proxima
2022-07-21 13:56:11 +02:00
Proxima is a simple gateway server. It supports reverse proxying to a different
port on `0.0.0.0` and responding to requests with a `308 Permanent Redirect`
response code.
2022-07-21 13:50:52 +02:00
## Configuring
Proxima reads the first config file it sees in the following order of preference:
- `./config`
- `/etc/proxima`
In these files, each line is a rule consisting of a pattern (consisting of a
hostname and a portspec) and an effect: either a number indicating a port on
`0.0.0.0` to proxy the request to or a string that is used as the `location`
header's value. If the latter effect is specified, Proxima redirects clients
to that location.
2022-07-21 13:56:11 +02:00
### Examples
The following config defines two rules: the first one redirects all requests
to `git.riley.lgbt` to `https://im.badat.dev`. The second rule passes each
request to `riley.lgbt` to port `3000`.
```
git.riley.lgbt : * ==> https://im.badat.dev
riley.lgbt : * --> 3000
```