krampus

Krampus is a replacement for Python's http.server, but with uploading.

Flags

• --help
• --file-download-path string file download serve location (default "./")
• --file-upload-path string file upload serve destination (default "./uploads")
• -f, --files enable serving files
• -3, --http3 enables QUIC/HTTP3 (UDP) (experimental)
• -a, --ip string ip selection (default "0.0.0.0")
• -p, --port string port selection (default "9001")
• --ssl-cert-path string TLS certificate path (default "./cert.pem")
• --ssl-key-path string TLS key path (default "./key.pem")
• -e, --tls TLS (default @ ./cert.pem ./key.pem)

SSL

NOTE: If not specificed, requires exactly named 'cert.pem' and 'key.pem' in current directory.

Quick Certificate

openssl req -nodes -newkey rsa:4096 -sha512 -new -x509 -days 3650 -keyout key.pem -out cert.pem

$ ls
cert.pem  key.pem
$ krampus --ssl true --port 8443
krampus(v1.1) starting at port: 8443 (TLS: true)

Uploading

Webpage

Navigate to http[:]//<ip>:<port>/upload for a HTML page with a upload button.

Windows

C:\> curl -F "file=@<file>" http[:]//<ip>:<port>/upload

Unix

$ curl -F "file=@<file>" http[:]//<ip>:<port>/upload

Downloading

Windows

curl -o <file> http[:]//<ip>:<port>/<file>

Unix

curl -O http[:]//<ip>:<port>/<file>

Compiling

NOTE: Requires network connection for the first compile.

Windows

C:\Users\username\krampus> dir
go.mod  go.sum  main.go  README.md
C:\Users\username\krampus> go build -o krampus.exe -ldflags="-w -s -buildid=" .
go.mod  go.sum  krampus.exe  main.go  README.md

Unix

$ export CGO_ENABLED=0 // Enables static compiling (optional)
$ pwd
/home/username/krampus
$ ls

go.mod  go.sum  main.go  README.md
$ go build -o krampus -ldflags="-w -s -buildid=" .
go.mod  go.sum  krampus  main.go  README.md

Note: The script 'krampus_cross_compiling.sh' can be referenced or used for multiple compiles.