mirror of
https://github.com/shlldev/miniws.git
synced 2025-09-02 19:00: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