BeeRust

Rust 生产级 Web 框架，设计哲学源自 Go 的 Beego，用 Rust 惯用的 trait / macro / 类型系统重新表达。

MVC 控制器 · 命名空间路由 · 过滤器链 · ORM · 多存储引擎统一 trait 抽象

安装

cargo add bee_rust

或写入 Cargo.toml：

[dependencies]
bee_rust = "1.1.2"
tokio = { version = "1", features = ["full"] }
axum = "0.8"

默认启用 full feature（router + orm + kv + config + logs + cache + session + security + template）。

快速开始

async fn health() -> &'static str {
    "OK"
}

#[tokio::main]
async fn main() -> bee_rust::Result<()> {
    let _log_handle = bee_rust::init()?;

    let router = bee_rust::bee_router::Router::new()
        .ns("/api/v1", |ns| ns.get("/health", health));

    let listener = tokio::net::TcpListener::bind("0.0.0.0:8080").await?;
    axum::serve(listener, router.build()).await?;
    Ok(())
}

cargo run
curl http://localhost:8080/api/v1/health    # OK

完整可运行项目见 examples/hello（含端到端测试）。

Feature 开关

search、graph、tsdb 不在默认的 full 里，需要单独开启。

只想要最小核心（不拖 ORM、数据库驱动）：

bee_rust = { version = "1.1.2", default-features = false, features = ["router", "logs", "config"] }

子 Crate

本框架由多个可独立使用的 crate 组成，bee_rust 是统一入口，按需 re-export。

这些 crate 也可以单独依赖，例如只用一个 ES 客户端：

bee_search = { version = "1.1.2", features = ["elasticsearch"] }

支持的数据库

环境要求

• Rust 1.80+（MSRV）
• edition 2024

链接

• API 文档：docs.rs/bee_rust
• 仓库：github.com/erikwang2013/bee-rust
• 完整 API 参考（12 语言）：docs/

许可证

Apache-2.0