44b8fc116d | ||
---|---|---|
LICENSE | ||
README.md | ||
config.go | ||
dirlist.go | ||
dynamic.go | ||
go.mod | ||
go.sum | ||
spsrv.go |
README.md
spsrv
A static spartan server with many features:
- folder redirects
- /~user directories
- directory listing
- CONF or TOML config file
- directory listing options
- user directory feature and userdir path
- CGI
- per user CGI (unsafe, like molly-brown)
- input data as stdin pipe
install
with go get
first, you need to have go installed and have a folder ~/go
with $GOPATH
pointing to it.
then you can call go get git.sr.ht/~hedy/spsrv
and there will be a binary at ~/go/bin/
with the source code at ~/go/src/
feel free to move the binary somewhere else like /usr/sbin/
build it yourself
run git clone https://git.sr.ht/~hedy/spsrv
from any directory and cd spsrv
make sure you have go installed and working.
go build
when it finishes, the binary will be in the current directory.
If you don't have/want go installed, you can contact me, and if you're lucky, I have the same OS as you and you can use my compiled binary (lol). I'll eventually have automated uploads of binaries for various architectures for each release in the future.
configuration
The default config file location is /etc/spsrv.conf
you can specify your own path by running spsrv like
spsrv -c /path/to/file.conf
You don't need a config file to have spsrv running, it will just use the default values.
config options
Note that the options are case insensitive.
Here are the config options and their default values
general
port=300
: port to listen tohostname="localhost"
: if this is set, any request that for hostnames other than this value would be rejectedrootdir="/var/spartan"
: folder for fetching files
directory listing
dirlistEnable=true
: enable directory listing for folders that does not haveindex.gmi
dirlistReverse=false
: reverse the order of which files are listeddirlistSort="name"
: how files are sorted, only "name", "size", and "time" are accepted. Defaults to "name" if an unknown option is encountereddirlistTitles=true
: if true, directory listing will use first top level header in*.gmi
files instead of the filename
~user/ directories
userdirEnable=true
: enable serving/~user/*
requestsuserdir="public_spartan"
: root directory for users. This should not have trailing slashes, and it is relative to/home/user/
CGI
CGIPaths=["cgi/"]
: list of paths where world-executable files will be run as CGI processes. These paths would be checked if it prefix the requested path. For the default value, a request of/cgi/hi.sh
(requesting to./public/cgi/hi.sh
, for example) will runhi.sh
script if it's world executable.usercgiEnable=false
: enable running user's CGI scripts too. This is dangerous as spsrv does not (yet) change the Uid of the CGI process, hence the process would be ran by the same user that is running the server, which could mean write access to configuration files, etc. Note that this option will be assumedfalse
ifuserdirEnable
is set tofalse
. Which means if user directories are not enabled, there will be no per-user CGI.
CLI
You can override values in config file if you supply then from the command line:
Usage: spsrv [ [ -c <path> -h <hostname> -p <port> -d <path> ] | --help ]
-c, --config string Path to config file
-d, --dir string Root content directory
-h, --hostname string Hostname
-p, --port int Port to listen to`)
Note that you cannot set the hostname or the dir path to ,
because spsrv uses that to check whether
you provided an option. You can't set port to 0
either, sorry, this limitation comes with the advantage
of being able to override config values from the command line.
There are no arguments wanted when running spsrv, only options as listed above :)
todo
- /folder to /folder/ redirects
- directory listing
- logging to files
- ~user directories
- refactor working dir part
- config
- status meta
- user homedir
- hostname, port
- public dir
- dirlist title
- userdir slug
- redirects
- CGI
- pipe data block
- user cgi config and change uid to user
- regex in cgi paths