Axum Strangler

Axum 包的实用程序包，允许您轻松使用 Strangler 图形模式，而无需使用某种类型的网关。

包的目标

为了支持以下用例：您想用 Rust 重写服务，但不能一次迁移所有服务的成本。使用 Strangler，您可以将 Rust 化的服务放在要迁移的服务前面，并且默认情况下，几乎所有东西都应该仍然工作。在迁移过程中，您将逐步添加更多逻辑/路由到 Rust 服务，并且那些路由将不会由您正在迁移的服务处理。

示例

#[tokio::main]
async fn main() -> Result<(), Box<dyn std::error::Error + Send + Sync>> {
    // We want to forward requests we don't handle ourselves to localhost:3333
    let strangler_svc = axum_strangler::Strangler::new(
        axum::http::uri::Authority::from_static("127.0.0.1:3333"),
    );

    // Add it as a fallback so everything that isn't covered by routes, get forwarded to the strangled service.
    let router = axum::Router::new()
        .route("/hello",  get(|| async { "Hello, World!" }))
        .fallback_service(strangler_svc);

    axum::Server::bind(&"127.0.0.1:0".parse()?)
        .serve(router.into_make_service())
        .await?;
    Ok(())
}

功能标志

嵌套路由器

如果您在另一个路由器内部使用 axum 路由器 nested，则路由转发将不会按预期工作，因为要转发的路径仅是嵌套路由器中定义的路径部分，而不是整个路径（因此，如果您在 /api 上嵌套路由器，则所有请求都会转发，而没有 /api，只转发它后面的内容）。

要修复此问题，您可以启用功能标志 nested-routers，这将允许它检索 OriginalUri 以正确转发。

https

允许转发到仅接受 HTTPS 流量的其他服务器

let strangler_svc = axum_strangler::Strangler::builder(
    axum::http::uri::Authority::from_static("127.0.0.1:3333"),
).with_http_scheme(axum_strangler::HttpScheme::HTTPS).build();

websocket

允许 Strangler 服务也处理 WebSocket，将请求者的每条消息转发到被 Strangler 服务，反之亦然。

TLS

为了通过 TLS 与 WebSocket 一起工作 (wss://)，您需要启用其他功能。您可以选择使用哪个 tokio-tungstenite 依赖项用于 TLS，以下三个功能都映射到该对应的依赖项，但所有三个都启用了 wss:// 协议