scratch-server 1.0.1

Simple HTTP Server
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39

# Simple Http Server
Simple http server writen from scratch in Rust. Implemented api endpoints allow for navigating file system directories, uploading and downloading files.

## Features
- Multi-threading
- Dynamic routing
- File upload/download
- Static files serving
- TLS/SSL support
- Colorful terminal logs
- CORS configuration
- Basic HTTP Auth
- Serve custom index html file

## Usage
```
Simlpe HTTP Server with TLS/SSL support. Implemented api endpoints allow for navigating file system directories, uploading and downloading files.

Usage: http-server [OPTIONS]

Options:
  -p, --port <port>          Sets the port number [default: 7878]
  -t, --threads <threads>    Sets the number of threads [default: 12]
  -c, --cert <cert>          TLS/SSL certificate
      --certpass <certpass>  TLS/SSL certificate password
  -s, --silent               Disable logging
      --cors                 Enable CORS with Access-Control-Allow-Origin header set to *
      --ip <ip>              Ip address to bind to [default: 0.0.0.0]
  -a, --auth <auth>          Enable HTTP Basic Auth. Pass username:password as argument
      --compression          Enable gzip response compression
      --index <index>        Sets the path to custom index html file to serve
  -h, --help                 Print help
  -V, --version              Print version
```
## Using the cert option
To use the cert option you have to:
1. Generate the certificate with the following command: ```openssl req -x509 -newkey rsa:4096 -keyout myKey.pem -out cert.pem -days 365```.
2. Genenrate the pkcs12 file with the following command: ```openssl pkcs12 -export -out keyStore.p12 -inkey myKey.pem -in cert.pem```
3. Pass the cert and certpass arguments like this ```http-server -c ./keyStore.p12 --certpass yourPassword```. Certpass option can be left blank if no password was set.