Struct H2ReverseProxy 

pub struct H2ReverseProxy { /* private fields */ }

Reverse proxy that forwards requests to HTTP/2 backends.

Wraps ReverseProxy and forces HTTP/2 (h2) for all upstream connections. Requires the http2 Cargo feature.

This proxy also transparently handles gRPC traffic (Content-Type: application/grpc*) — gRPC DATA frames are forwarded as-is because gRPC is layered directly on HTTP/2.

Implementations

impl H2ReverseProxy

pub fn new<I, S>(backends: I) -> Self

where I: IntoIterator<Item = S>, S: AsRef<str>,

Create a proxy distributing requests across backends in round-robin order.

Each backend entry can be:

• "host:port" — plain TCP (HTTP/2 cleartext)
• "h2://host:port" — plain TCP (explicit scheme)
• "h2s://host:port" — TLS (HTTP/2 over HTTPS; port defaults to 443)
• "https://host:port" — TLS (same as h2s://)

TLS backends require the http2 Cargo feature (includes rustls + webpki-roots). Certificate verification uses the WebPKI trust store.

pub fn path_prefix(self, prefix: impl Into<String>) -> Self

Only proxy requests whose URI starts with prefix; pass others through.

pub fn connect_timeout_ms(self, ms: u64) -> Self

Override the TCP connect timeout (default: 5 s).

pub fn read_timeout_ms(self, ms: u64) -> Self

Override the response read timeout (default: 30 s).

Trait Implementations

impl Middleware for H2ReverseProxy

Available on crate feature http2 only.

fn handle( &self, request: &Request, connection: &ConnectionInfo, next: &dyn Application, ) -> Result<Response, String>