mirror of
https://github.com/shlldev/miniws.git
synced 2025-09-03 11:20:59 +02:00
Create README.md
This commit is contained in:
25
README.md
Normal file
25
README.md
Normal file
@@ -0,0 +1,25 @@
|
|||||||
|
# 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](http://fileformats.archiveteam.org/wiki/Combined_Log_Format)**
|
||||||
|
|
||||||
|
`errors.log` is for golang errors
|
Reference in New Issue
Block a user