用 Rust + Actix-Web 打造“Hello, WebSocket!”——从握手到回声,只需 50 行代码
用 Rust + Actix-Web 打造“Hello, WebSocket!”——从握手到回声,只需 50 行代码
一、为什么选择 Rust 写 WebSocket?
- 零成本抽象:编译期确定生命周期,无 GC 抖动,延迟低至微秒级
- actix-web:Tokio 生态最成熟的 Web 框架,单机轻松扛 100k 并发
- 类型安全:消息格式一旦定义,编译器帮你杜绝“字段对不上”的运行时崩溃
二、核心代码逐行拆解
下面这份 echo 处理器就是全部业务逻辑——没有魔法,只有 Rust 标准流程:
1
pub async fn echo(
2
req: HttpRequest, // HTTP 升级握手请求
3
stream: web::Payload, // 原始 TCP 字节流
4
) -> Result<HttpResponse, Error> {
5
// 1. 协议升级:返回 101 Switching Protocols
6
let (res, mut session, stream) = actix_ws::handle(&req, stream)?;
7
8
// 2. 消息聚合:把可能分片的 WebSocket 帧拼成完整消息
9
let mut stream = stream
10
.aggregate_continuations()
11
.max_continuation_size(2_usize.pow(20)); // 1 MiB 上限
12
13
// 3. 异步任务:在后台持续读写,不阻塞主线程
14
rt::spawn(async move {
15
while let Some(msg) = stream.next().await {
16
match msg {
17
Ok(AggregatedMessage::Text(text)) => {
18
println!("↑ {}", text);
三、把 WebSocket 挂到路由表
在 config_routes 里加一行即可:
1
web::scope("/ws").route("", web::get().to(echo))
前端连接示例:
1
const ws = new WebSocket('ws://localhost:8080/api/ws');
2
ws.onmessage = (ev) => console.log('↓', ev.data);
3
ws.send('Hello Rust!');
四、性能小贴士
- 零拷贝:
session.text(text)直接借用String,无需额外克隆 - 背压保护:
max_continuation_size限制单消息大小,防内存炸弹 - 任务隔离:
rt::spawn让每条连接独立调度,互不影响
五、下一步?
- 用
broadcast频道实现聊天室 - 用
serde把 JSON 消息强类型化 - 用
rustls升级成wss安全连接
完整项目已上传 GitHub,克隆即可跑:
1
git clone https://github.com/your-name/actix-ws-echo
2
cd actix-ws-echo && cargo run
打开浏览器,WebSocket 握手→回声,只需一次 cargo run,你就拥有了毫秒级延迟的实时通信后端。Enjoy Rust!
相关文章
查看同分类文章MAVLink 消息处理指南
MAVLink消息处理系统摘要 本系统实现了一套完整的MAVLink消息处理机制,用于无人机通信与控制。核心功能包括: 消息接收:通过UDP连接持续接收飞控消息,支持心跳维持机制 消息处理:分类处理多种MAVLink消息类型,包括心跳、位置、姿态和航点相关消息 航点管理:实现航点下载状态机,支持分片请求和接收航点数据 消息转发:将处理后的消息通过MQTT发布到指定主题 系统采用多线程架构,包含独立的消息接收线程和主处理循环,通过通道进行线程间通信。关键特性包括航点下载状态机、错误处理和日志记录机制,确保通信
304 浏览
M3U8 下载助手油猴脚本 - 技术实现解析
M3U8下载助手技术解析 该油猴脚本通过注入拦截脚本实现对M3U8链接的全面捕获。核心架构包括: 请求拦截层:劫持XHR、fetch和WebSocket请求 DOM监听层:通过MutationObserver监控动态元素变化 跨域通信:iframe间使用postMessage传递数据 UI展示层:提供浮动按钮等交互界面 关键技术点: 使用document-start确保早期注入 通过保存原始方法实现API劫持 在send时而非open时检测URL 全面覆盖各种属性(src/href/data-src等) 脚
362 浏览
我做了一个局域网传文件的小工具,记录一下
本文记录了作者开发局域网文件传输工具的过程。起因是工作中遇到大文件传输不便的问题,作者选择用Rust语言开发,解决了WebSocket状态管理、大文件上传限制等技术难点。最终成品通过浏览器即可使用,支持文字聊天和文件传输,内存占用低。同事们试用后反馈良好,建议增加拖拽上传等功能。作者认为Rust虽开发较繁琐但运行高效稳定,并将项目开源供社区参与改进。
291 浏览
局域网聊天工具
这是一个基于Rust和Axum框架开发的局域网实时聊天工具,支持文本聊天、图片和文件分享功能。项目采用WebSocket实现实时通信,前端使用Tailwind CSS构建界面。主要功能包括实时消息传递、文件上传下载(限制100MB)、在线用户显示和消息历史记录。部署简单,只需Rust环境,通过Cargo编译运行即可启动服务。系统架构清晰,包含后端处理、前端界面和文件存储模块,适合局域网内团队协作使用。
350 浏览