#http-header #tower-http #tower

tunnelbana-headers

Parse cloudflare-style _headers files and add them to your HTTP servers

5 unstable releases

Uses new Rust 2024

0.3.0 Nov 3, 2025
0.2.0 Jun 5, 2025
0.1.2 Jan 24, 2025
0.1.1 Nov 11, 2024
0.1.0 Nov 11, 2024

#2032 in HTTP server


Used in tunnelbana

MIT/Apache

11KB
203 lines

tunnelbana-headers

A tower middleware to add headers to specific routes, or route groups.

Part of the tunnelbana project.

Example

use tower_http::services::ServeDir;
use tower::{ServiceBuilder, ServiceExt};
use http::Response;
use tunnelbana_headers::HeadersLayer;

let config = r#"
/example
 X-Example-Header: example.org
/subpath/{other}
 X-Header-One: h1
 X-Header-Two: h2
/wildcard/{*wildcard}
 X-Header-A: ha
 X-Header-B: hb
"#;
let headers = tunnelbana_headers::parse(config).expect("Failed to parse headers");
let headers_mw = HeadersLayer::new(headers).expect("Failed to route headers");
let serve_dir = ServeDir::new("/var/www/html").append_index_html_on_directories(true);
let service = ServiceBuilder::new()
   .layer(headers_mw)
   .service(serve_dir);

tunnelbana-headers

Generate headers from _headers text files and serve them with tower.

https://docs.rs/tunnelbana-headers

Dependencies

~6–8.5MB
~79K SLoC