Rust 写服务，除了 Rocket，还有更快的选择：Hyperlane

WA自动机
8 阅读10分钟

Rust 写服务，除了 Rocket，还有更快的选择：Hyperlane

在追求极致性能的 Rust 后端开发中，Hyperlane 以其轻量级、纯 Rust 和高吞吐率脱颖而出。Hyperlane 是一个 纯 Rust、无额外依赖 的 HTTP 服务库，基于 Tokio 异步运行时实现，提供统一的跨平台 API 体验。它不仅支持标准的 HTTP 请求/响应，还内置 WebSocket 和 Server-Sent Events (SSE)，以及灵活的 中间件机制，非常适合构建现代化、高并发的 Web API 和实时应用。

Hyperlane 的核心特点

  • 纯 Rust 实现 & 无额外依赖：Hyperlane 基于 Rust 标准库和 Tokio 异步框架，无需绑定任何平台依赖，确保在 Windows、Linux、macOS 等环境下拥有一致的 API 和行为。
  • 跨平台兼容 & 统一 API：无论部署在哪个平台，都能使用相同的代码和配置，无需针对不同操作系统进行特别处理。
  • 高性能设计：Hyperlane 采用极简设计和内存高效的数据结构，最大限度降低请求处理开销。在基准测试中，其吞吐量接近纯 Tokio 实现。
  • 异步多路复用（Tokio）：内置 Tokio 异步运行时，充分利用多核 CPU，轻松处理高并发请求。
  • 中间件机制灵活：支持请求与响应两种中间件，可以在处理链的不同阶段定制逻辑（例如日志记录、认证、统一响应头等）。
  • 多协议支持：除了 HTTP，Hyperlane 原生支持 WebSocket 和 Server-Sent Events（SSE），方便构建实时通信或推送服务。

以上特性使 Hyperlane 在 API 服务、微服务、物联网和游戏后端等场景中具有天然优势：它可以轻松应对高并发场景，同时保持开发体验的简洁高效。

上手难度：极其简单

Hyperlane 致力于让开发者无缝上手。只需一行命令即可将其引入项目：

cargo add hyperlane   # 安装 Hyperlane

如官方文档所述，“Adding Hyperlane to your Rust project is a breeze. Simply run: cargo add hyperlane”。完成依赖添加后，立即即可开始编写服务代码。Hyperlane 提供了详尽的示例项目和文档（见下文链接），开发者可以快速搭建并运行第一个 HTTP 服务器。

下面是一个典型的 Hyperlane 使用示例，它展示了如何配置服务器、添加中间件、定义路由，以及启用 WebSocket：

use hyperlane::*;

async fn request_middleware(ctx: Context) {
    let socket_addr: String = ctx.get_socket_addr_or_default_string().await;
    ctx.set_response_header(SERVER, HYPERLANE)
        .await
        .set_response_header(CONNECTION, CONNECTION_KEEP_ALIVE)
        .await
        .set_response_header(CONTENT_TYPE, content_type_charset(TEXT_PLAIN, UTF8))
        .await
        .set_response_header(DATE, gmt())
        .await
        .set_response_header("SocketAddr", socket_addr)
        .await;
}

async fn response_middleware(ctx: Context) {
    let _ = ctx.send().await;
    let request: String = ctx.get_request_string().await;
    let response: String = ctx.get_response_string().await;
    ctx.log_info(&request, log_handler)
        .await
        .log_info(&response, log_handler)
        .await;
}

async fn root_route(ctx: Context) {
    ctx.set_response_status_code(200)
        .await
        .set_response_body("Hello hyperlane => /")
        .await;
}

async fn websocket_route(ctx: Context) {
    let request_body: Vec<u8> = ctx.get_request_body().await;
    let _ = ctx.send_response_body(request_body).await;
}

#[tokio::main]
async fn main() {
    let server: Server = Server::new();
    server.host("0.0.0.0").await;
    server.port(60000).await;
    server.enable_nodelay().await;
    server.log_dir("./logs").await;
    server.enable_inner_log().await;
    server.enable_inner_print().await;
    server.log_size(100_024_000).await;
    server.http_line_buffer_size(4096).await;
    server.websocket_buffer_size(4096).await;
    server.request_middleware(request_middleware).await;
    server.response_middleware(response_middleware).await;
    server.route("/", root_route).await;
    server.route("/websocket", websocket_route).await;
    let test_string: String = "Hello hyperlane".to_owned();
    server
        .route(
            "/test/:text",
            async_func!(test_string, |ctx| {
                let param: RouteParams = ctx.get_route_params().await;
                println_success!(format!("{:?}", param));
                println_success!(test_string);
                panic!("Test panic");
            }),
        )
        .await;
    server.listen().await.unwrap();
}

该示例中：

  • 中间件：request_middleware 为所有响应添加自定义头部（如 Server、Date、客户端地址等），response_middleware 则在响应发送后记录请求和响应内容。
  • 路由：定义了根路由 /（返回简单问候）和 /websocket（将客户端数据原样回传）的处理函数。
  • 动态路由：演示了参数路由 /test/:text，可通过 ctx.get_route_params().await 获取路径参数。
  • 服务器配置：示例配置了监听地址、端口、日志目录、缓冲区大小等，展示了 Hyperlane 配置 API 的简洁性。

这个示例清晰展示了 Hyperlane 简洁直观的 API 和强大功能。开发者可以轻松实现常见功能，而无需关心底层细节。

性能测试对比

Hyperlane 以高性能著称。在官方基准测试中，Hyperlane 的性能仅次于纯 Tokio 实现，远超许多常见框架。例如，在 wrk 压力测试（60秒，360 并发）下，各框架的 QPS（每秒请求数）结果如下：

  • wrk 测试：Tokio: 340,130.92; Hyperlane: 324,323.71; Rocket: 298,945.31; Rust Std: 291,218.96; Gin: 242,570.16; Go Std: 234,178.93; Node.js: 139,412.13。
  • ab 测试：Tokio: 308,596.26; Hyperlane: 307,568.90; Rocket: 267,931.52; Rust Std: 260,514.56; Go Std: 226,550.34; Gin: 224,296.16; Node.js: 85,357.18。

从上可见，Hyperlane 在高并发场景下的吞吐能力非常出色，超过了 Rocket、Gin、Node.js 等流行框架。其每秒数十万级的请求量，可满足绝大多数业务的性能需求，同时兼顾了 Rust 的内存安全和类型安全优势。

总结与资源链接

Hyperlane 综合了 纯 Rust 实现、Tokio 高并发、丰富协议支持、简单易用 与 高性能 等优点，是构建高性能 Web 服务的优质选项。对于需要极致性能和可靠性的场景，Hyperlane 是 Rocket、Actix 等框架之外的更快之选。欢迎大家试用 Hyperlane，并为项目点 ⭐！

以上信息及数据均来自官方资料和性能测试报告。Hyperlane 已经发布在 crates.io，可通过 cargo add hyperlane 直接引入。感兴趣的同学不妨亲自试用，体验 Hyperlane 带来的极速与便利！

推荐几款学习编程的免费平台

免费在线开发平台（docs.ltpp.vip/LTPP/）

       探索编程世界的新天地，为学生和开发者精心打造的编程平台，现已盛大开启！这个平台汇集了近4000道精心设计的编程题目，覆盖了C、C++、JavaScript、TypeScript、Go、Rust、PHP、Java、Ruby、Python3以及C#等众多编程语言，为您的编程学习之旅提供了一个全面而丰富的实践环境。       
在这里，您不仅可以查看自己的代码记录，还能轻松地在云端保存和运行代码，让编程变得更加便捷。平台还提供了私聊和群聊功能，让您可以与同行们无障碍交流，分享文件，共同进步。不仅如此，您还可以通过阅读文章、参与问答板块和在线商店，进一步拓展您的知识边界。
为了提升您的编程技能，平台还设有每日一题、精选题单以及激动人心的编程竞赛，这些都是备考编程考试的绝佳资源。更令人兴奋的是，您还可以自定义系统UI，选择视频或图片作为背景，打造一个完全个性化的编码环境，让您的编程之旅既有趣又充满挑战。

免费公益服务器（docs.ltpp.vip/LTPP-SHARE/…）

       作为开发者或学生，您是否经常因为搭建和维护编程环境而感到头疼？现在，您不必再为此烦恼，因为一款全新的免费公共服务器已经为您解决了所有问题。这款服务器内置了多种编程语言的编程环境，并且配备了功能强大的在线版VS Code，让您可以随时随地在线编写代码，无需进行任何复杂的配置。
随时随地，云端编码
无论您身在何处，只要有网络连接，就可以通过浏览器访问这款公共服务器，开始您的编程之旅。这种云端编码的便利性，让您的学习或开发工作不再受限于特定的设备或环境。
丰富的编程语言支持
服务器支持包括C、C++、JavaScript、TypeScript、Go、Rust、PHP、Java、Ruby、Python3以及C#等在内的多种主流编程语言，满足不同开发者和学生的需求。无论您是初学者还是资深开发者，都能找到适合自己的编程环境。
在线版VS Code，高效开发
内置的在线版VS Code提供了与本地VS Code相似的编辑体验，包括代码高亮、智能提示、代码调试等功能，让您即使在云端也能享受到高效的开发体验。
数据隐私和安全提醒
虽然服务器是免费的，但为了保护您的数据隐私和安全，我们建议您不要上传任何敏感或重要的数据。这款服务器更适合用于学习和实验，而非存储重要信息。

免费公益MYSQL（docs.ltpp.vip/LTPP-SHARE/…）

       作为一名开发者或学生，数据库环境的搭建和维护往往是一个复杂且耗时的过程。但不用担心，现在有一款免费的MySQL服务器，专为解决您的烦恼而设计，让数据库的使用变得简单而高效。
性能卓越，满足需求
虽然它是免费的，但性能绝不打折。服务器提供了稳定且高效的数据库服务，能够满足大多数开发和学习场景的需求。
在线phpMyAdmin，管理更便捷
内置的在线phpMyAdmin管理面板，提供了一个直观且功能强大的用户界面，让您可以轻松地查看、编辑和管理数据库。
数据隐私提醒，安全第一
正如您所知，这是一项公共资源，因此我们强烈建议不要上传任何敏感或重要的数据。请将此服务器仅用于学习和实验目的，以确保您的数据安全。

免费在线WEB代码编辑器（docs.ltpp.vip/LTPP-WEB-ID…）

       无论你是开发者还是学生，编程环境的搭建和管理可能会占用你宝贵的时间和精力。现在，有一款强大的免费在线代码编辑器，支持多种编程语言，让您可以随时随地编写和运行代码，提升编程效率，专注于创意和开发。
多语言支持，无缝切换
这款在线代码编辑器支持包括C、C++、JavaScript、TypeScript、Go、Rust、PHP、Java、Ruby、Python3以及C#在内的多种编程语言，无论您的项目需要哪种语言，都能在这里找到支持。
在线运行，快速定位问题
您可以在编写代码的同时，即时运行并查看结果，快速定位并解决问题，提高开发效率。
代码高亮与智能提示
编辑器提供代码高亮和智能提示功能，帮助您更快地编写代码，减少错误，提升编码质量。

免费二维码生成器（docs.ltpp.vip/LTPP-QRCODE…）

       二维码（QR Code）是一种二维条码，能够存储更多信息，并且可以通过智能手机等设备快速扫描识别。它广泛应用于各种场景，如：
企业宣传
企业可以通过二维码分享公司网站、产品信息、服务介绍等。
活动推广
活动组织者可以创建二维码，参与者扫描后可以直接访问活动详情、报名链接或获取电子门票。
个人信息分享
个人可以生成包含联系方式、社交媒体链接、个人简历等信息的二维码。
电子商务
商家使用二维码进行商品追踪、促销活动、在线支付等。
教育
教师可以创建二维码，学生扫描后可以直接访问学习资料或在线课程。
交通出行
二维码用于公共交通的票务系统，乘客扫描二维码即可进出站或支付车费。        功能强大的二维码生成器通常具备用户界面友好，操作简单，即使是初学者也能快速上手和生成的二维码可以在各种设备和操作系统上扫描识别的特点。

avatar
文章
阅读
粉丝