Crate axum_server

axum-server is a hyper server implementation designed to be used with axum framework.

Features

• HTTP/1 and HTTP/2
• HTTPS through rustls or openssl.
• High performance through hyper.
• Using tower make service API.
• Very good axum compatibility. Likely to work with future axum releases.

Guide

axum-server can serve items that implement MakeService with some additional trait bounds. Make services that are created using axum complies with those trait bounds out of the box. Therefore it is more convenient to use this crate with axum.

All examples in this crate uses axum. If you want to use this crate without axum it is highly recommended to learn how tower works.

Server::bind or bind function can be called to create a server that will bind to provided SocketAddr when serve is called.

A Handle can be passed to Server for additional utilities like shutdown and graceful shutdown.

bind_rustls can be called by providing RustlsConfig to create a HTTPS Server that will bind on provided SocketAddr. RustlsConfig can be cloned, reload methods can be used on clone to reload tls configuration.

Features

• tls-rustls - activate rustls support.
• tls-rustls-no-provider - activate rustls support without a default provider.
• tls-openssl - activate openssl support.

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);
    axum_server::bind(addr)
        .serve(app.into_make_service())
        .await
        .unwrap();
}

You can find more examples in repository.

Modules

• accept
  Accept trait and utilities.
• service
  Service traits.
• tls_openssltls-openssl
  Tls implementation using openssl
• tls_rustlstls-rustls
  Tls implementation using rustls.

Structs

• Handle
  A handle for Server.
• Server
  HTTP server.

Functions

• bind
  Create a Server that will bind to provided address.
• bind_openssltls-openssl
  Create a TLS server that will be bound to the provided socket with a configuration. See the crate::tls_openssl module for more details.
• bind_rustlstls-rustls
  Create a tls server that will bind to provided address.
• from_tcp
  Create a Server from existing std::net::TcpListener.
• from_tcp_rustlstls-rustls
  Create a tls server from existing std::net::TcpListener.