default··约 5 分钟读完·377 次观看

用 Rust + Actix-Web 打造“Hello, WebSocket!”——从握手到回声,只需 50 行代码

本文介绍如何使用Rust和Actix-Web框架快速构建WebSocket服务。通过50行核心代码实现握手协议升级和消息回声功能,利用Actix-Web框架的特性实现微秒级延迟和单机10万并发。文章详细解析了代码逻辑,包括协议升级、消息聚合和异步处理等关键步骤,并提供了前端连接示例。还分享了性能优化技巧,如零拷贝、背压保护等。最后给出了扩展方向的建议,如实现聊天室、强类型消息等。该项目已开源,开发者可快速部署体验Rust的高性能WebSocket服务。
前端rustwebsocket

用 Rust + Actix-Web 打造“Hello, WebSocket!”——从握手到回声,只需 50 行代码

一、为什么选择 Rust 写 WebSocket?

  • 零成本抽象:编译期确定生命周期,无 GC 抖动,延迟低至微秒级
  • actix-web:Tokio 生态最成熟的 Web 框架,单机轻松扛 100k 并发
  • 类型安全:消息格式一旦定义,编译器帮你杜绝“字段对不上”的运行时崩溃

二、核心代码逐行拆解

下面这份 echo 处理器就是全部业务逻辑——没有魔法,只有 Rust 标准流程:

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 里加一行即可:

rust
      
        
          1
          
          web::scope("/ws").route("", web::get().to(echo))
        
      
    

前端连接示例:

javascript
      
        
          1
          
          const ws = new WebSocket('ws://localhost:8080/api/ws');
        
          2
          
          ws.onmessage = (ev) => console.log('↓', ev.data);
        
          3
          
          ws.send('Hello Rust!');
        
      
    

四、性能小贴士

  1. 零拷贝:session.text(text) 直接借用 String,无需额外克隆
  2. 背压保护:max_continuation_size 限制单消息大小,防内存炸弹
  3. 任务隔离:rt::spawn 让每条连接独立调度,互不影响

五、下一步?

  • 用 broadcast 频道实现聊天室
  • 用 serde 把 JSON 消息强类型化
  • 用 rustls 升级成 wss 安全连接

完整项目已上传 GitHub,克隆即可跑:

bash
      
        
          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 浏览

这篇文章对你有帮助吗?