Implement host-based routing with global routing table

Add routing table (HashMap<String, SiteConfig>) to DynamicConfig for
O(1) host lookup. Implement normalize_host (lowercase + strip port)
per RFC 7230 §2.7.3. Add proxy_handler that routes /health to 200,
missing Host to 400, unknown host to 404, and known host to 200.
Routing table updates atomically via ArcSwap.
This commit is contained in:
2026-06-11 12:57:31 +00:00
parent 994ce0fb66
commit d5f5713deb
6 changed files with 413 additions and 23 deletions

View File

@@ -1,3 +1,4 @@
use std::collections::HashMap;
use std::sync::Arc;
use arc_swap::ArcSwap;
@@ -7,15 +8,65 @@ use tokio::sync::Mutex;
use super::static_config::StaticConfig;
use super::validation::validate;
#[allow(dead_code)]
#[derive(Debug, Deserialize, Clone, PartialEq)]
#[derive(Debug, Clone)]
pub struct DynamicConfig {
pub sites: Vec<SiteConfig>,
pub routing_table: HashMap<String, SiteConfig>,
pub rate_limit: RateLimitConfig,
pub body: BodyConfig,
}
impl DynamicConfig {
pub fn from_sites(
sites: Vec<SiteConfig>,
rate_limit: RateLimitConfig,
body: BodyConfig,
) -> Self {
let routing_table = build_routing_table(&sites);
Self {
sites,
routing_table,
rate_limit,
body,
}
}
pub fn lookup(&self, host: &str) -> Option<&SiteConfig> {
self.routing_table.get(&normalize_host(host))
}
}
impl PartialEq for DynamicConfig {
fn eq(&self, other: &Self) -> bool {
self.sites == other.sites && self.rate_limit == other.rate_limit && self.body == other.body
}
}
pub fn build_routing_table(sites: &[SiteConfig]) -> HashMap<String, SiteConfig> {
sites
.iter()
.map(|s| (s.host.to_lowercase(), s.clone()))
.collect()
}
pub fn normalize_host(host: &str) -> String {
let lower = host.to_lowercase();
lower.split(':').next().unwrap_or(&lower).to_string()
}
#[derive(Debug, Deserialize, Clone, PartialEq)]
pub struct SerializableDynamicConfig {
pub sites: Vec<SiteConfig>,
pub rate_limit: RateLimitConfig,
pub body: BodyConfig,
}
#[allow(dead_code)]
impl From<SerializableDynamicConfig> for DynamicConfig {
fn from(value: SerializableDynamicConfig) -> Self {
DynamicConfig::from_sites(value.sites, value.rate_limit, value.body)
}
}
#[derive(Debug, Deserialize, Clone, PartialEq)]
pub struct SiteConfig {
pub host: String,
@@ -28,42 +79,35 @@ pub struct SiteConfig {
pub upstream_request_timeout_secs: u64,
}
#[allow(dead_code)]
fn default_upstream_scheme() -> String {
"http".to_string()
}
#[allow(dead_code)]
fn default_connect_timeout() -> u64 {
5
}
#[allow(dead_code)]
fn default_request_timeout() -> u64 {
60
}
#[allow(dead_code)]
#[derive(Debug, Deserialize, Clone, PartialEq)]
pub struct RateLimitConfig {
pub requests_per_second: u32,
pub burst: u32,
}
#[allow(dead_code)]
#[derive(Debug, Deserialize, Clone, PartialEq)]
pub struct BodyConfig {
pub limit_bytes: u64,
}
#[allow(dead_code)]
pub struct ConfigReloadHandle {
config: Arc<ArcSwap<DynamicConfig>>,
static_config: StaticConfig,
reload_mutex: Mutex<()>,
}
#[allow(dead_code)]
impl ConfigReloadHandle {
pub fn new(config: Arc<ArcSwap<DynamicConfig>>, static_config: StaticConfig) -> Self {
Self {
@@ -153,6 +197,14 @@ mod tests {
upstream_connect_timeout_secs: 5,
upstream_request_timeout_secs: 60,
});
let new_dynamic = DynamicConfig::from_sites(
new_dynamic.sites,
RateLimitConfig {
requests_per_second: 50,
burst: new_dynamic.rate_limit.burst,
},
new_dynamic.body,
);
let rt = tokio::runtime::Runtime::new().unwrap();
rt.block_on(handle.reload(test_fixtures::test_static_config(), new_dynamic))
@@ -196,6 +248,14 @@ mod tests {
handles.push(tokio::spawn(async move {
let mut dynamic = initial.clone();
dynamic.rate_limit.requests_per_second = i * 10;
let dynamic = DynamicConfig::from_sites(
dynamic.sites,
RateLimitConfig {
requests_per_second: i * 10,
burst: dynamic.rate_limit.burst,
},
dynamic.body,
);
h.reload(test_fixtures::test_static_config(), dynamic).await
}));
}
@@ -222,4 +282,103 @@ mod tests {
assert!(changes.contains(&"logging".to_string()));
assert_eq!(changes.len(), 2);
}
#[test]
fn normalize_host_converts_to_lowercase() {
assert_eq!(normalize_host("Git.Alk.DEV"), "git.alk.dev");
}
#[test]
fn normalize_host_strips_port() {
assert_eq!(normalize_host("git.alk.dev:443"), "git.alk.dev");
assert_eq!(normalize_host("GIT.ALK.DEV:8443"), "git.alk.dev");
}
#[test]
fn normalize_host_no_port() {
assert_eq!(normalize_host("git.alk.dev"), "git.alk.dev");
}
#[test]
fn normalize_host_empty_string() {
assert_eq!(normalize_host(""), "");
}
#[test]
fn routing_table_lookup_finds_site() {
let config = test_fixtures::test_dynamic_config();
let site = config.lookup("test.local");
assert!(site.is_some());
assert_eq!(site.unwrap().host, "test.local");
}
#[test]
fn routing_table_lookup_case_insensitive() {
let config = test_fixtures::test_dynamic_config();
let site = config.lookup("TEST.LOCAL");
assert!(site.is_some());
assert_eq!(site.unwrap().host, "test.local");
}
#[test]
fn routing_table_lookup_strips_port() {
let config = test_fixtures::test_dynamic_config();
let site = config.lookup("test.local:443");
assert!(site.is_some());
assert_eq!(site.unwrap().host, "test.local");
}
#[test]
fn routing_table_lookup_unknown_host() {
let config = test_fixtures::test_dynamic_config();
let site = config.lookup("unknown.example");
assert!(site.is_none());
}
#[test]
fn build_routing_table_multiple_sites() {
let sites = vec![
SiteConfig {
host: "git.example.com".to_string(),
upstream: "127.0.0.1:3000".to_string(),
upstream_scheme: "http".to_string(),
upstream_connect_timeout_secs: 5,
upstream_request_timeout_secs: 60,
},
SiteConfig {
host: "www.example.com".to_string(),
upstream: "127.0.0.1:8080".to_string(),
upstream_scheme: "http".to_string(),
upstream_connect_timeout_secs: 5,
upstream_request_timeout_secs: 60,
},
];
let table = build_routing_table(&sites);
assert_eq!(table.len(), 2);
assert!(table.contains_key("git.example.com"));
assert!(table.contains_key("www.example.com"));
}
#[test]
fn dynamic_config_from_sites_builds_routing_table() {
let sites = vec![SiteConfig {
host: "My.Site".to_string(),
upstream: "127.0.0.1:8080".to_string(),
upstream_scheme: "http".to_string(),
upstream_connect_timeout_secs: 5,
upstream_request_timeout_secs: 60,
}];
let config = DynamicConfig::from_sites(
sites,
RateLimitConfig {
requests_per_second: 10,
burst: 20,
},
BodyConfig {
limit_bytes: 104857600,
},
);
assert!(config.routing_table.contains_key("my.site"));
assert_eq!(config.routing_table.len(), 1);
}
}

View File

@@ -4,7 +4,8 @@ pub mod test_fixtures;
pub mod validation;
pub use dynamic_config::{
BodyConfig, ConfigReloadHandle, DynamicConfig, RateLimitConfig, SiteConfig,
build_routing_table, normalize_host, BodyConfig, ConfigReloadHandle, DynamicConfig,
RateLimitConfig, SerializableDynamicConfig, SiteConfig,
};
pub use static_config::{ListenerConfig, LoggingConfig, StaticConfig, TlsConfig};
pub use validation::{validate, ValidationError};

View File

@@ -26,22 +26,22 @@ pub fn test_static_config() -> StaticConfig {
}
pub fn test_dynamic_config() -> DynamicConfig {
DynamicConfig {
sites: vec![SiteConfig {
DynamicConfig::from_sites(
vec![SiteConfig {
host: "test.local".to_string(),
upstream: "127.0.0.1:8080".to_string(),
upstream_scheme: "http".to_string(),
upstream_connect_timeout_secs: 5,
upstream_request_timeout_secs: 60,
}],
rate_limit: RateLimitConfig {
RateLimitConfig {
requests_per_second: 10,
burst: 20,
},
body: BodyConfig {
BodyConfig {
limit_bytes: 104857600,
},
}
)
}
#[cfg(test)]

View File

@@ -335,22 +335,22 @@ mod tests {
}
fn valid_dynamic_config() -> DynamicConfig {
DynamicConfig {
sites: vec![SiteConfig {
DynamicConfig::from_sites(
vec![SiteConfig {
host: "test.local".to_string(),
upstream: "127.0.0.1:8080".to_string(),
upstream_scheme: "http".to_string(),
upstream_connect_timeout_secs: 5,
upstream_request_timeout_secs: 60,
}],
rate_limit: RateLimitConfig {
RateLimitConfig {
requests_per_second: 10,
burst: 20,
},
body: BodyConfig {
BodyConfig {
limit_bytes: 104857600,
},
}
)
}
fn make_static_with_sites(sites: Vec<SiteConfig>, tls: TlsConfig) -> StaticConfig {

View File

@@ -1,12 +1,240 @@
use std::sync::Arc;
use axum::extract::State;
use axum::http::StatusCode;
use axum::response::IntoResponse;
use axum::routing::get;
use axum::Router;
use arc_swap::ArcSwap;
use crate::config::dynamic_config::DynamicConfig;
async fn health_handler() -> impl IntoResponse {
StatusCode::OK
}
pub fn health_route() -> Router {
Router::new().route("/health", get(health_handler))
async fn proxy_handler(
State(state): State<Arc<ArcSwap<DynamicConfig>>>,
req: axum::http::Request<axum::body::Body>,
) -> impl IntoResponse {
if req.uri().path() == "/health" {
return StatusCode::OK.into_response();
}
let host = req
.headers()
.get(axum::http::header::HOST)
.and_then(|v| v.to_str().ok());
let host = match host {
Some(h) => h,
None => return StatusCode::BAD_REQUEST.into_response(),
};
let config = state.load();
match config.lookup(host) {
Some(_site) => StatusCode::OK.into_response(),
None => StatusCode::NOT_FOUND.into_response(),
}
}
pub fn proxy_router(state: Arc<ArcSwap<DynamicConfig>>) -> Router {
Router::new()
.route("/health", get(health_handler))
.fallback(proxy_handler)
.with_state(state)
}
#[cfg(test)]
mod tests {
use super::*;
use crate::config::dynamic_config::{BodyConfig, RateLimitConfig};
use crate::config::SiteConfig;
use axum::body::Body;
use axum::http::{Request, Response};
use tower::ServiceExt;
fn make_config_with_sites(sites: Vec<SiteConfig>) -> Arc<ArcSwap<DynamicConfig>> {
Arc::new(ArcSwap::from_pointee(DynamicConfig::from_sites(
sites,
RateLimitConfig {
requests_per_second: 10,
burst: 20,
},
BodyConfig {
limit_bytes: 104857600,
},
)))
}
async fn send_request(
router: &mut Router,
method: &str,
uri: &str,
host: Option<&str>,
) -> Response<axum::body::Body> {
let mut builder = Request::builder().method(method).uri(uri);
if let Some(h) = host {
builder = builder.header("Host", h);
}
let req = builder.body(Body::empty()).unwrap();
router.oneshot(req).await.unwrap()
}
#[tokio::test]
async fn health_path_returns_200_regardless_of_host() {
let state = make_config_with_sites(vec![SiteConfig {
host: "example.com".to_string(),
upstream: "127.0.0.1:8080".to_string(),
upstream_scheme: "http".to_string(),
upstream_connect_timeout_secs: 5,
upstream_request_timeout_secs: 60,
}]);
let mut router = proxy_router(state);
let resp = send_request(&mut router, "GET", "/health", None).await;
assert_eq!(resp.status(), StatusCode::OK);
}
#[tokio::test]
async fn health_with_unknown_host_returns_200() {
let state = make_config_with_sites(vec![SiteConfig {
host: "example.com".to_string(),
upstream: "127.0.0.1:8080".to_string(),
upstream_scheme: "http".to_string(),
upstream_connect_timeout_secs: 5,
upstream_request_timeout_secs: 60,
}]);
let mut router = proxy_router(state);
let resp = send_request(&mut router, "GET", "/health", Some("unknown.host")).await;
assert_eq!(resp.status(), StatusCode::OK);
}
#[tokio::test]
async fn missing_host_returns_400() {
let state = make_config_with_sites(vec![SiteConfig {
host: "example.com".to_string(),
upstream: "127.0.0.1:8080".to_string(),
upstream_scheme: "http".to_string(),
upstream_connect_timeout_secs: 5,
upstream_request_timeout_secs: 60,
}]);
let mut router = proxy_router(state);
let resp = send_request(&mut router, "GET", "/some/path", None).await;
assert_eq!(resp.status(), StatusCode::BAD_REQUEST);
}
#[tokio::test]
async fn unknown_host_returns_404() {
let state = make_config_with_sites(vec![SiteConfig {
host: "example.com".to_string(),
upstream: "127.0.0.1:8080".to_string(),
upstream_scheme: "http".to_string(),
upstream_connect_timeout_secs: 5,
upstream_request_timeout_secs: 60,
}]);
let mut router = proxy_router(state);
let resp = send_request(&mut router, "GET", "/some/path", Some("unknown.host")).await;
assert_eq!(resp.status(), StatusCode::NOT_FOUND);
}
#[tokio::test]
async fn known_host_returns_200() {
let state = make_config_with_sites(vec![SiteConfig {
host: "example.com".to_string(),
upstream: "127.0.0.1:8080".to_string(),
upstream_scheme: "http".to_string(),
upstream_connect_timeout_secs: 5,
upstream_request_timeout_secs: 60,
}]);
let mut router = proxy_router(state);
let resp = send_request(&mut router, "GET", "/some/path", Some("example.com")).await;
assert_eq!(resp.status(), StatusCode::OK);
}
#[tokio::test]
async fn host_matching_is_case_insensitive() {
let state = make_config_with_sites(vec![SiteConfig {
host: "example.com".to_string(),
upstream: "127.0.0.1:8080".to_string(),
upstream_scheme: "http".to_string(),
upstream_connect_timeout_secs: 5,
upstream_request_timeout_secs: 60,
}]);
let mut router = proxy_router(state);
let resp = send_request(&mut router, "GET", "/path", Some("EXAMPLE.COM")).await;
assert_eq!(resp.status(), StatusCode::OK);
let resp = send_request(&mut router, "GET", "/path", Some("Example.Com")).await;
assert_eq!(resp.status(), StatusCode::OK);
}
#[tokio::test]
async fn host_with_port_stripped() {
let state = make_config_with_sites(vec![SiteConfig {
host: "example.com".to_string(),
upstream: "127.0.0.1:8080".to_string(),
upstream_scheme: "http".to_string(),
upstream_connect_timeout_secs: 5,
upstream_request_timeout_secs: 60,
}]);
let mut router = proxy_router(state);
let resp = send_request(&mut router, "GET", "/path", Some("example.com:443")).await;
assert_eq!(resp.status(), StatusCode::OK);
let resp = send_request(&mut router, "GET", "/path", Some("EXAMPLE.COM:8443")).await;
assert_eq!(resp.status(), StatusCode::OK);
}
#[tokio::test]
async fn routing_table_update_visible_immediately() {
let state = make_config_with_sites(vec![SiteConfig {
host: "example.com".to_string(),
upstream: "127.0.0.1:8080".to_string(),
upstream_scheme: "http".to_string(),
upstream_connect_timeout_secs: 5,
upstream_request_timeout_secs: 60,
}]);
let mut router = proxy_router(state.clone());
let resp = send_request(&mut router, "GET", "/path", Some("new.example.com")).await;
assert_eq!(resp.status(), StatusCode::NOT_FOUND);
let new_config = DynamicConfig::from_sites(
vec![
SiteConfig {
host: "example.com".to_string(),
upstream: "127.0.0.1:8080".to_string(),
upstream_scheme: "http".to_string(),
upstream_connect_timeout_secs: 5,
upstream_request_timeout_secs: 60,
},
SiteConfig {
host: "new.example.com".to_string(),
upstream: "127.0.0.1:9090".to_string(),
upstream_scheme: "http".to_string(),
upstream_connect_timeout_secs: 5,
upstream_request_timeout_secs: 60,
},
],
RateLimitConfig {
requests_per_second: 10,
burst: 20,
},
BodyConfig {
limit_bytes: 104857600,
},
);
state.store(Arc::new(new_config));
let resp = send_request(&mut router, "GET", "/path", Some("new.example.com")).await;
assert_eq!(resp.status(), StatusCode::OK);
}
}

View File

@@ -1,3 +1,5 @@
pub mod error;
pub mod handler;
pub mod headers;
pub use crate::config::dynamic_config::normalize_host;