basic-server

README

Basic Server

A basic file server automatically generates self certificates and serves the given folder.

Options

Usage of /basic-server:
  -client-cert string
        Allow only given client certificate
  -listen string
        Listen addr (default ":443")
  -path string
        Share Path (default "/web/") # Note if you not run in container, default path will be current path
  -server-cert string
        Server cert
  -server-key string
        Server key
  -server-name string
        Server name check from TLS

Examples

Run on local

C:\Users\Ahmet\Desktop\basic-server.exe -h
2021/05/04 02:46:55 github.com/ahmetozer/basic-server
2021/05/04 02:46:55 Current name WORKSTATION\Ahmet
2021/05/04 02:46:55 ./key.pem exist
2021/05/04 02:46:55 ./cert.pem exist
2021/05/04 02:29:51 Starting HTTPS server on :443 at C:\Users\Ahmet\Desktop\

Run in container

This configuration accepts all https clients with all domains.

docker run -it --rm -p 443:443 --mount type=bind,source="/my/path/",target=/web/,readonly  ghcr.io/ahmetozer/basic-server

Run in container with client cert control

To allow incoming request from only cloudflare enable 'Authenticated Origin Pulls' in cloudflare.

docker run -it --rm -p 443:443 --mount type=bind,source="/my/path/",target=/web/,readonly ghcr.io/ahmetozer/basic-server \
--server-name mydomain.test  --client-cert /config/client-cloudflare.pem

Run in different user

You can also run in different user id for access shared path.

docker run -it --rm -p 443:443 -u 1249:1249 --mount type=bind,source="/secret/my/path/",target=/web/,readonly ghcr.io/ahmetozer/basic-server \
--server-name mydomain.test  --client-cert config/client-cloudflare.pem

Dump

You can also inspect your HTTP request with visiting /dump page.