axum-cloudflare-adapter

一个用于在 Cloudflare Worker 中轻松运行 Axum 服务器的适配器。

Cloudflare Worker 从 0.0.21+ 开始对 Axum 提供原生支持

通过 worker-rs 中的 http 功能启用 workers-rs 中的 Axum 支持。

这是因为 Axum 和 worker-rs http 都使用了相同的 http crate。

此适配器可以用作将非 http workers-rs 版本迁移到 http 版本的简单方法

1. 不要更改当前 workers-rs 项目对非 http 版本 workers-rs 的依赖（保持 http 标志禁用）。
2. 将此适配器的依赖项添加到项目中。
3. 将通配符路由添加到现有路由器

    .or_else_any_method_async("/*catchall", |_, ctx| async move {

3. 在通配符路由中，添加一个像下面示例中的 axum 路由器。
4. 开始逐步迁移路径，一个接一个地从旧路由器迁移到 axum 路由器。
5. 完成后，删除对此适配器的依赖项，并在 workers-rs 上启用 "http" 标志。
6. 如果您有任何问题，可以在 Discord 的 #rust-on-workers 上寻求帮助或在工作器-rs GitHub 上创建一个问题。

用法

use worker::*;
use axum::{
    response::{Html},
    routing::get,
    Router as AxumRouter,
    extract::State,
};
use axum_cloudflare_adapter::{to_axum_request, to_worker_response, wasm_compat, EnvWrapper};
use tower_service::Service;
use std::ops::Deref;

#[derive(Clone)]
pub struct AxumState {
    pub env_wrapper: EnvWrapper,
}

#[wasm_compat]
async fn index(State(state): State<AxumState>) -> Html<&'static str> {
    let env: &Env = state.env_wrapper.env.deref();
    let worker_rs_version: Var = env.var("WORKERS_RS_VERSION").unwrap();
    console_log!("WORKERS_RS_VERSION: {}", worker_rs_version.to_string());
    Html("<p>Hello from Axum!</p>")
}

#[event(fetch)]
pub async fn main(req: Request, env: Env, _ctx: worker::Context) -> Result<Response> {
    let mut _router: AxumRouter = AxumRouter::new()
        .route("/", get(index))
        .with_state(AxumState {
            env_wrapper: EnvWrapper::new(env),
        });
    let axum_request = to_axum_request(req).await.unwrap();
    let axum_response = _router.call(axum_request).await.unwrap();
    let response = to_worker_response(axum_response).await.unwrap();
    Ok(response)
}

运行测试

cdadapter && wasm-packtest --firefox --无头

构建

cdadapter && cargobuild --targetwasm32-unknown-unknown

示例

“/example” 目录包含运行 Axum 服务器的 Cloudflare Worker