From beff40ae8ca33718c638a08b28d194189e813609 Mon Sep 17 00:00:00 2001 From: Altair-sh Date: Wed, 4 Nov 2026 04:40:01 +0100 Subject: [PATCH] README.md --- README.md | 43 +++++++++++++++++++++++++++++++++++++++---- 1 file changed, 39 insertions(+), 4 deletions(-) diff --git a/README.md b/README.md index a48ba1c..c3b7a00 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,41 @@ # serveg -Small HTTP/1.1 file server. Meant to run behind a reverse proxy that handles TLS. -- download, upload -- per-directory passwords -- own http implementation, not "net/http". +Small HTTP/1.1 file server. Meant to run behind a reverse proxy that handles TLS (see [Caddy](#caddy)). + +## Features: +- upload and download files +- per-directory passwords (read more in example config) - generates html pages for directories +- own http implementation, not "net/http" + +## Dependencies +- [BurntSushi/toml](https://github.com/BurntSushi/toml) - toml 1.1.0 parser +- [daviddengcn/go-colortext](https://github.com/daviddengcn/go-colortext) - print colored text (linux/windows) + +## Build +```sh +make build +``` + +## Run + +```sh +cp serveg.example.toml serveg.toml # edit shares and passwords +bin/servegp # reads ./serveg.toml +# or +bin/servegp -config /etc/serveg/serveg.toml +``` + +## Caddy + +``` +files.example.com { + request_body { + max_size 4GB + } + reverse_proxy 127.0.0.1:8080 { + transport http { + versions 1.1 + } + } +} +```