2020-10-29 21:35:48 +01:00
|
|
|
# twins
|
|
|
|
|
[](https://gitlab.com/tslocum/twins/commits/master)
|
|
|
|
|
[](https://liberapay.com/rocketnine.space)
|
|
|
|
|
|
|
|
|
|
[Gemini](https://gemini.circumlunar.space) server
|
|
|
|
|
|
2020-10-31 01:29:25 +01:00
|
|
|
**Warning:** The twins configuration format is still under development.
|
|
|
|
|
Breaking changes may be made.
|
|
|
|
|
|
2020-11-01 00:49:37 +01:00
|
|
|
This page is also available at [gemini://twins.rocketnine.space](gemini://twins.rocketnine.space)
|
|
|
|
|
|
2020-10-29 21:35:48 +01:00
|
|
|
## Features
|
|
|
|
|
|
|
|
|
|
- Serve static files
|
2020-10-31 17:59:12 +01:00
|
|
|
- Directory listing (when enabled)
|
2020-10-30 19:19:16 +01:00
|
|
|
- Reverse proxy requests
|
2020-11-04 21:48:55 +01:00
|
|
|
- TCP
|
|
|
|
|
- [FastCGI](https://en.wikipedia.org/wiki/FastCGI)
|
|
|
|
|
- Serve system command output
|
2020-10-31 22:59:44 +01:00
|
|
|
- Reload configuration on `SIGHUP`
|
2020-10-29 21:35:48 +01:00
|
|
|
|
|
|
|
|
## Download
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
go get gitlab.com/tslocum/twins
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
## Configure
|
|
|
|
|
|
|
|
|
|
See [CONFIGURATION.md](https://gitlab.com/tslocum/twins/blob/master/CONFIGURATION.md)
|
|
|
|
|
|
|
|
|
|
## Run
|
|
|
|
|
|
|
|
|
|
```bash
|
|
|
|
|
twins
|
|
|
|
|
```
|
|
|
|
|
|
|
|
|
|
## Support
|
|
|
|
|
|
|
|
|
|
Please share issues and suggestions [here](https://gitlab.com/tslocum/twins/issues).
|
|
|
|
|
|
|
|
|
|
## Dependencies
|
|
|
|
|
|
2020-11-04 21:48:55 +01:00
|
|
|
- [filetype](https://github.com/h2non/filetype) - MIME type detection
|
|
|
|
|
- [gofast](https://github.com/yookoala/gofast) - FastCGI client
|
|
|
|
|
- [go-shellquote](https://github.com/kballard/go-shellquote) - Shell string quoting
|
|
|
|
|
- [yaml](https://github.com/go-yaml/yaml/tree/v3) - Configuration parsing
|
