Statico

A blazing-fast HTTP server in Rust for serving static responses. Designed strictly for benchmarking with minimal overhead.

Features

• Multi-threaded with configurable worker threads
• Per-thread Tokio runtime (single-threaded) for reduced context switching
• SO_REUSEPORT for kernel-level load balancing across threads
• Configurable responses: custom status codes, headers, and body
• File-based responses via @filename syntax
• Optional io_uring support on Linux (compile-time feature)
• Cross-platform: Linux, macOS, Windows

Performance

The following benchmark compares Statico against other popular HTTP servers and frameworks in a synthetic scenario where each server returns a minimal static response from memory. All servers were configured for maximum performance (no logging, CPU pinning where applicable, in-memory responses).

Benchmark Results (requests/second)

Key observations:

• Statico with io_uring achieves 1M+ req/s at 4 threads with near-linear scaling
• Standard Statico and nginx perform similarly single-threaded, but Statico scales better
• Outperforms Axum, actix-web, and Go's fasthttp significantly at higher thread counts

Note: "statico + io_uring" uses tokio-uring. Other io_uring runtimes (monoio, glommio) may show even better performance.

Why is Statico fast?

• Zero-allocation response serving (pre-built cached responses)
• Single-threaded Tokio runtimes per worker reduce contention across cores
• SO_REUSEPORT for efficient kernel load balancing
• File content loaded once at startup
• io_uring support on Linux (up to 40% faster)

Building

# Standard build
cargo build --release

# With specific runtimes (each requires its own feature)
cargo build --release --features tokio_uring  # tokio-uring runtime
cargo build --release --features monoio       # monoio runtime
cargo build --release --features glommio      # glommio runtime
cargo build --release --features smol         # smol runtime
cargo build --release --all-features          # enable all runtimes 

Usage

./target/release/statico [OPTIONS]

Options

Examples

# Basic server on port 8080
./target/release/statico

# Custom port and threads
./target/release/statico --ports 3000 --threads 4

# Multiple ports and ranges
./target/release/statico --ports 8080,8443,9000-9010

# Bind all threads to all ports (SO_REUSEPORT load balancing)
./target/release/statico --ports 8080,8081 --threads 4 --bind-all

# Custom response with headers
./target/release/statico --status 201 --body "Hello" -H "Content-Type: text/plain"

# Multiple headers
./target/release/statico -H "Content-Type: application/json" -H "X-API-Key: secret"

# JSON response
./target/release/statico -b '{"msg": "hi"}' -H "Content-Type: application/json"

# Serve from file
./target/release/statico --body @response.json -H "Content-Type: application/json"

# io_uring runtimes (Linux only, requires feature flags)
./target/release/statico --runtime tokio-uring --threads 8
./target/release/statico --runtime monoio --threads 8
./target/release/statico --runtime glommio --threads 8

# Add delay (latency simulation)
./target/release/statico --delay 100ms

# Delay body only (headers sent immediately)
./target/release/statico --body-delay 500ms

# Verbose logging (levels: -v, -vv, -vvv, -vvvv)
./target/release/statico -vv

# Real-time metrics
./target/release/statico --meter

Architecture

Threading Model

• Main thread parses arguments and spawns workers
• Each worker creates its own socket with SO_REUSEPORT
• Each worker runs a single-threaded Tokio runtime
• Kernel load-balances connections across threads via reuse port

Runtimes

Note: io_uring and smol runtimes support HTTP/1.1 only.

Use Cases

• Load testing and benchmarking HTTP clients
• Mocking services and API endpoints
• Static file serving without full web server overhead
• Health check endpoints
• Development and testing scenarios

License

Provided as-is for educational and practical use.