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
64d4b9b0ee150fe1d815ffa3e8635050133fbf68
miniws/README.md
Francesco 64d4b9b0ee Create README.md
2025-08-03 17:20:55 +02:00

1.0 KiB
Raw Blame History

miniws

miniws (minimalist web sever) 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 row to tell miniws to treat the file as a whitelist or a blacklist, then specify one ip/user-agent per row.

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