twins-upstream/README.md

48 lines
1.3 KiB
Markdown
Raw Normal View History

2020-10-29 21:35:48 +01:00
# twins
[![CI status](https://gitlab.com/tslocum/twins/badges/master/pipeline.svg)](https://gitlab.com/tslocum/twins/commits/master)
[![Donate](https://img.shields.io/liberapay/receives/rocketnine.space.svg?logo=liberapay)](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)
- Reverse proxy requests
2020-11-04 21:48:55 +01:00
- TCP
- [FastCGI](https://en.wikipedia.org/wiki/FastCGI)
- Serve system command output
- 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