rws

Static file web server written in Rust. Serves HTTP/1.1 on a synchronous thread pool. Build with --features http2 to enable TLS and HTTP/2.

Install

cargo install rust-web-server

This installs the rws binary with HTTP/2 and TLS support included.

Run

Plain HTTP/1.1

rws

Starts on http://127.0.0.1:7878 by default. Place your files in the working directory and open the URL in a browser.

HTTPS + HTTP/2

Generate a self-signed certificate for local development:

openssl req -x509 -newkey rsa:4096 -keyout key.pem -out cert.pem -days 365 -nodes \
  -subj "/CN=localhost" -addext "subjectAltName=DNS:localhost,IP:127.0.0.1"

Start the server with the certificate:

rws --tls-cert-file=cert.pem --tls-key-file=key.pem

Open https://127.0.0.1:7878 in a browser. The server negotiates HTTP/2 or HTTP/1.1 automatically via ALPN on the same port.

For a public domain, obtain a certificate from Let's Encrypt.

Custom address and port

rws --ip=0.0.0.0 --port=443 --tls-cert-file=cert.pem --tls-key-file=key.pem

See CONFIGURE for all configuration options (env vars, config file, command-line flags).

Build from source

git clone https://github.com/bohdaq/rust-web-server.git
cd rust-web-server
cargo build --release

The binary is at target/release/rws.

To build without HTTP/2 and TLS (smaller binary, no system dependencies):

cargo build --release --no-default-features --features http1

Features

HTTP/2 with ALPN negotiation alongside HTTP/1.1 on the same port
TLS via rustls (aws-lc-rs backend, no OpenSSL)
CORS — allowed for all origins by default, fully configurable
HTTP Range Requests — partial file serving and multi-range responses
HTTP Client Hints
X-Content-Type-Options: nosniff and X-Frame-Options headers
Symlink resolution
.html extension inference — /page serves page.html; /dir serves dir/index.html
No caching headers — files are always served fresh
Request/response logging to stdout

rust-web-server 17.0.0

rws