robertohuertasm / microserver

🔬 Simple ad-hoc server with SPA support based on Warp.

microserver

Simple ad-hoc server with SPA support based on Warp! Excellent for testing React, Angular, Vue apps and the like.

Installation

You can compile it yourself:

cargo install microserver

or you can download the executable from Github releases and add it to your path.

Usage

No argument is mandatory so the current folder will be used as default if no path is specified

microserver

you can, of course, set the path of the folder you want to be served, by default in port 9090.

microserver ./path/to/folder

Need help?

microserver -h

Changing the address

# by default microserver will use 0.0.0.0
microserver -a 127.0.0.1

Changing the port

# by default microserver will use 9090 port
microserver -p 3000

SPA support

SPA support is enabled by default, meaning that if a resource is not found traffic will always be redirected to index.html.

If you want to opt-out of this behavior just use the --no-spa flag.

In the case you ever need to change the default spa index you can provide the --spa-index flag.

Docker

There are several ways to use microserver with a Docker image:

With a Dockerfile like the following:

# please omit the version if you just want the latest
FROM robertohuertasm/microserver:v0.1.6
# public being the location of your app files
COPY public/ /app/

You can then run your SPA / static site using:

$ docker build -t my-service:local .
$ docker run -p 9090:9090 my-service:local
MicroServer running on port 9090!
Serving /app
Spa support: true. Root: index.html

Alternatively, you could mount a volume with your content:

docker run -p 9090:9090 -v $(pwd)/public:/app robertohuertasm/microserver:v0.1.6

More complex Dockerfile usage example with a multi-stage build of a React SPA:

FROM node:10.18-stretch-slim as builder
WORKDIR /app
COPY ./ /app
RUN yarn
RUN yarn build

FROM robertohuertasm/microserver:v0.1.6
COPY --from=builder /app/public /app/

If you don't want the default arguments

In this case whenever you run the microserver image, you'll have to be explicit about the arguments:

# don't forget to add "/app" as your final argument
docker run -p 9090:9090 -v $(pwd)/public:/app robertohuertasm/microserver:v0.1.6 "/microserver" "--no-spa" "/app"

microserver's Issues

Unable to serve WOFF2 files?

While this works fine in Chromium, on Firefox I get:

downloadable font: rejected by sanitizer

when attempting to serve .woff2 files. Any ideas why this might be happening?

Wrong mimetype for javascript files

Files with extension '.js' are served with mimetype 'text/html'. In Firefox and Chromium, this prevents the JS from being executed.

This was found by running microserver on https://github.com/MartinKavik/seed-rs-realworld.git.

feature request: bind to specific address

Currently, only binding to all IPv4 interfaces (0.0.0.0) is supported. I would like to have the option to bind to only a specific address, perhaps via a --bind command line argument.

This would allow for:

• Only binding to the loopback interface (--bind 127.0.0.1)
• IPv6 support (--bind [::])