在当今数字化时代，构建高性能、可靠的 Web 服务是每个开发者追求的目标。今天，我们诚挚地向您推荐 Hyperlane，这是一个轻量级且高性能的 Rust HTTP 服务器库，旨在简化您的网络服务开发

⚡ Hyperlane —— 比 Rocket 更快的 Rust Web 框架！

在现代 Web 服务开发中，开发者需要一个既轻量级又高性能的 HTTP 服务器库来简化开发流程，同时确保服务的高效运行。Hyperlane 正是为此而生——一个专为 Rust 开发者设计的 HTTP 服务器库，旨在提供简单易用且功能强大的网络服务开发体验。

核心特性

Hyperlane 不仅支持基本的 HTTP 请求解析、响应构建和 TCP 通信，还提供了丰富的功能来满足现代 Web 服务的开发需求：

• 中间件支持：Hyperlane 允许开发者轻松地为请求和响应添加中间件，从而实现灵活的请求处理和响应生成逻辑。
• 实时通信：通过对 WebSocket 和 Server-Sent Events (SSE) 的支持，Hyperlane 使开发者能够构建高效的实时通信应用，无论是聊天应用、实时数据推送还是在线游戏。
• 纯 Rust 构建：Hyperlane 完全使用 Rust 标准库构建，确保了库的轻量级和跨平台兼容性，支持 Windows、Linux 和 macOS，且在所有平台上提供一致的 API 体验。
• 异步运行时：Hyperlane 依托 Tokio 异步运行时，实现了无缝的网络通信，无需开发者处理特定于平台的依赖问题。

安装和使用

安装 Hyperlane 非常简单。只需在您的 Rust 项目中运行以下命令：

cargo add hyperlane

为了帮助您快速上手，Hyperlane 提供了一个快速开始项目。您可以通过以下命令克隆并运行示例：

git clone https://github.com/eastspire/hyperlane-quick-start.git

以下是一个使用 Hyperlane 构建基本 HTTP 服务器的示例代码，展示了中间件、路由和 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, TEXT_PLAIN)
.await
.set_response_header("SocketAddr", socket_addr)
.await;
}

async fn response_middleware(ctx: Context) {
let _ = ctx.send().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;
}

fn error_handle(error: String) {
eprintln!("{}", error);
let _ = std::io::Write::flush(&mut std::io::stderr());
}

#[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.disable_linger().await;
server.http_line_buffer_size(4096).await;
server.websocket_buffer_size(4096).await;
server.error_handle(error_handle).await;
server.request_middleware(request_middleware).await;
server.response_middleware(response_middleware).await;
server.route("/", root_route).await;
server.route("/websocket", websocket_route).await;
server
.route("/test/:text", move |ctx: Context| async move {
let param: RouteParams = ctx.get_route_params().await;
panic!("Test panic {:?}", param);
})
.await;
server.run().await.unwrap();
}

性能优势

Hyperlane 在性能上表现出色，特别是在高并发和大量请求的场景下。以下是基于 wrk 和 ab 压测工具的性能数据：

wrk 压测（360 并发，持续 60 秒）

压测命令：

wrk -c360 -d60s http://127.0.0.1:60000/

结果：

• Tokio：340,130.92 QPS
• Hyperlane 框架：324,323.71 QPS
• Rocket 框架：298,945.31 QPS
• Rust 标准库：291,218.96 QPS
• Gin 框架：242,570.16 QPS
• Go 标准库：234,178.93 QPS
• Node 标准库：139,412.13 QPS

ab 压测（1000 并发，100 万请求）

压测命令：

ab -n 1000000 -c 1000 -r -k http://127.0.0.1:60000/

结果：

• Tokio：308,596.26 QPS
• Hyperlane 框架：307,568.90 QPS
• Rocket 框架：267,931.52 QPS
• Rust 标准库：260,514.56 QPS
• Go 标准库：226,550.34 QPS
• Gin 框架：224,296.16 QPS
• Node 标准库：85,357.18 QPS

wrk 压测（关闭连接，360 并发，持续 60 秒）

压测命令：

wrk -c360 -d60s -H "Connection: close" http://127.0.0.1:60000/

结果：

• Hyperlane 框架：51,031.27 QPS
• Tokio：49,555.87 QPS
• Rocket 框架：49,345.76 QPS
• Gin 框架：40,149.75 QPS
• Go 标准库：38,364.06 QPS
• Rust 标准库：30,142.55 QPS
• Node 标准库：28,286.96 QPS

ab 压测（无 keep-alive，1000 并发，100 万请求）

压测命令：

ab -n 1000000 -c 1000 -r http://127.0.0.1:60000/

结果：

• Tokio：51,825.13 QPS
• Hyperlane 框架：51,554.47 QPS
• Rocket 框架：49,621.02 QPS
• Go 标准库：47,915.20 QPS
• Gin 框架：47,081.05 QPS
• Node 标准库：44,763.11 QPS
• Rust 标准库：31,511.00 QPS

这些数据表明，Hyperlane 在高并发环境下能够提供与 Tokio 相近的性能，远超其他流行的 Web 框架和标准库实现，无论是启用 keep-alive 的持久连接还是关闭连接的短连接场景。

跨平台兼容性

Hyperlane 的设计初衷之一就是提供真正的跨平台支持。无论您是在 Windows、Linux 还是 macOS 上开发，Hyperlane 都能提供一致的 API 体验和稳定的性能表现。得益于 Rust 的跨平台特性和 Tokio 异步运行时的强大支持，Hyperlane 能够在不牺牲性能的前提下，实现无缝的网络通信。

社区和支持

Hyperlane 是一个开源项目，托管于 GitHub，API 文档可见 docs.rs。我们欢迎并鼓励开发者参与贡献。您可以通过提交 issue 或创建 pull request 来帮助我们改进 Hyperlane。如果您在使用过程中遇到任何问题或有任何疑问，请随时联系我们：root@ltpp.vip。

许可证

Hyperlane 基于 MIT 许可证授权，详细信息请查看 license 文件。

结语

Hyperlane 是一个专为 Rust 开发者打造的轻量级、高性能 HTTP 服务器库，旨在简化 Web 服务开发并提供出色的性能表现。无论您是构建简单的 API 服务器还是复杂的实时通信应用，Hyperlane 都能为您提供强大的支持。立即访问 GitHub 或 快速开始文档，尝试 Hyperlane，体验 Rust 在 Web 服务开发中的无限可能！