shll.dev/miniws
2
2
Fork 0
mirror of https://github.com/shlldev/miniws.git synced 2025-09-02 19:00:59 +02:00
Code Issues Packages Projects Releases Wiki Activity
Files
efc680a2b1deb7085be52c6338ff9ff05115216b
miniws/README.md
uan efc680a2b1 fix README
2025-08-06 21:07:41 +02:00

1.1 KiB
Raw Blame History

miniws

miniws (minimalist web server) is a very simple web server written in golang. its purpose is to be lightweight, easy to configure and easily expandable for personal use.

command line arguments

  -h  --help           Print help information 
  -p  --port           what port miniws will run on. Default: 8040
  -l  --logs-folder    the logs folder. Default: logs
  -c  --config-folder  the configurations folder. Default: config
  -w  --www-folder     the www folder where miniws will look for files to
                       serve. Default: .

how to configure

in your config folder you will find ipfilter.conf and useragentfilter.conf

both files use the same format: specify allow|deny in the first line to tell miniws to treat the file as a whitelist or a blacklist, then specify one ip/user-agent per line.

logging

in your logging folder you will find access.log and errors.log

access.log utilizes the NCSA Combined Log Format

errors.log is for golang errors