nano-web

Static file server. Pre-loads and pre-compresses all files at startup for near-zero latency serving.

Performance

• Raw hyper (no framework overhead)
• SO_REUSEPORT for multi-core scaling
• Files pre-compressed at startup (brotli/gzip/zstd)
• Lock-free concurrent routing (DashMap + FxHash)
• Zero-copy responses (Bytes)

Benchmark (M3 Max):

wrk -c 50 -d 10 -t 50 http://localhost:3000
Requests/sec: 149838.48
Latency: 328.63us avg

Install

# mise
mise install ubi:radiosilence/nano-web

# cargo
cargo install nano-web

Pre-built binaries on GitHub Releases.

Docker

FROM ghcr.io/radiosilence/nano-web:latest
COPY ./dist /public/

Usage

nano-web serve                          # ./public on :3000
nano-web serve ./dist --port 8080       # custom dir/port
nano-web serve --spa --dev              # SPA mode + hot reload

Options

Runtime Config Injection

Inject env vars into HTML at startup:

<script>
  window.ENV = JSON.parse("{{EscapedJson}}");
</script>

Variables: {{env.VAR_NAME}}, {{Json}}, {{EscapedJson}}

Health Check

/_health returns {"status":"ok","timestamp":"..."}

License

MIT