4 releases

0.6.0 Oct 14, 2023
0.5.3 Oct 13, 2023
0.5.2 Oct 11, 2023
0.5.1 Oct 11, 2023

#47 in #tower

MIT license

135KB
2.5K SLoC

License Crates.io Docs CI codecov

hyper-server

hyper-server is a high performance hyper server implementation designed to work with axum, tonic and tower.

Features

  • HTTP/1 and HTTP/2
  • HTTPS through rustls and openssl.
  • High performance through hyper.
  • Using tower make service API.
  • Exceptional axum compatibility. Likely to work with future axum releases.
  • Superb tonic compatibility. Likely to work with future tonic releases.
  • Proxy protocol support for use behind network load balancers

Usage Example

A simple hello world application can be served like:

use axum::{routing::get, Router};
use std::net::SocketAddr;

#[tokio::main]
async fn main() {
    let app = Router::new().route("/", get(|| async { "Hello, world!" }));

    let addr = SocketAddr::from(([127, 0, 0, 1], 3000));
    println!("listening on {}", addr);
    hyper_server::bind(addr)
        .serve(app.into_make_service())
        .await
        .unwrap();
}

You can find more examples here.

Minimum Supported Rust Version

hyper-server's MSRV is 1.65.

Safety

This crate uses #![forbid(unsafe_code)] to ensure everything is implemented in 100% safe Rust.

License

This project is licensed under the MIT license.

Why fork

This project is based on the great work in axum-server, which is no longer actively maintained. The rationale for forking is that we use this for critical infrastructure and want to be able to extend the crate and fix bugs as needed.

Dependencies

~6–17MB
~235K SLoC