在树莓派上用Mongoose C库5分钟搞定一个WebSocket服务器（附完整代码和测试）-深圳市維司達科技有限公司

在树莓派上5分钟构建WebSocket服务器的极简实践

树莓派作为一款性价比极高的微型计算机，已经成为物联网和嵌入式开发者的首选平台。而实时数据传输在智能家居、工业监控等场景中越来越重要，WebSocket协议因其全双工通信特性成为实现实时交互的理想选择。本文将带你用Mongoose C库，在树莓派上快速搭建一个功能完整的WebSocket服务器。

1. 环境准备与Mongoose库简介

Mongoose是一个轻量级的C/C++网络库，特别适合资源受限的嵌入式环境。它采用事件驱动和非阻塞API设计，支持TCP、UDP、HTTP、WebSocket和MQTT等多种协议。最吸引人的是，整个库只有一个头文件和一个源文件，编译后仅增加约50KB的体积，这对树莓派等设备非常友好。

在树莓派上安装Mongoose只需几步：

# 更新软件包列表 sudo apt update # 安装编译工具链 sudo apt install -y build-essential git # 克隆Mongoose仓库 git clone https://github.com/cesanta/mongoose

Mongoose的核心优势在于：

单文件设计：只需mongoose.c和mongoose.h即可集成到项目
零依赖：不依赖其他第三方库
跨平台：支持Linux、Windows、MacOS甚至RTOS
协议丰富：内置HTTP/WebSocket/MQTT服务器和客户端实现

2. WebSocket服务器核心代码解析

下面是一个完整的WebSocket服务器实现，包含静态文件服务和REST接口：

#include "mongoose.h" static const char *s_listen_on = "ws://0.0.0.0:8000"; static const char *s_web_root = "."; static void fn(struct mg_connection *c, int ev, void *ev_data, void *fn_data) { if (ev == MG_EV_OPEN) { // 可在此启用流量日志 // c->is_hexdumping = 1; } else if (ev == MG_EV_HTTP_MSG) { struct mg_http_message *hm = (struct mg_http_message *) ev_data; if (mg_http_match_uri(hm, "/websocket")) { // 升级为WebSocket连接 mg_ws_upgrade(c, hm, NULL); } else if (mg_http_match_uri(hm, "/rest")) { // REST API响应 mg_http_reply(c, 200, "", "{\"result\": %d}\n", 123); } else { // 静态文件服务 struct mg_http_serve_opts opts = {.root_dir = s_web_root}; mg_http_serve_dir(c, ev_data, &opts); } } else if (ev == MG_EV_WS_MSG) { // WebSocket消息处理：实现echo功能 struct mg_ws_message *wm = (struct mg_ws_message *) ev_data; mg_ws_send(c, wm->data.ptr, wm->data.len, WEBSOCKET_OP_TEXT); } (void) fn_data; } int main(void) { struct mg_mgr mgr; // 事件管理器 mg_mgr_init(&mgr); // 初始化 printf("WebSocket服务器已启动: %s\n", s_listen_on); mg_http_listen(&mgr, s_listen_on, fn, NULL); // 创建监听 for (;;) mg_mgr_poll(&mgr, 1000); // 事件循环 mg_mgr_free(&mgr); // 清理资源 return 0; }

关键组件说明：

组件	功能	相关API
mg_mgr	管理所有连接的事件管理器	mg_mgr_init, mg_mgr_poll, mg_mgr_free
mg_connection	表示一个网络连接	mg_http_listen创建监听
事件处理函数	处理各种网络事件	MG_EV_OPEN, MG_EV_HTTP_MSG, MG_EV_WS_MSG

3. 编译与运行

将上述代码保存为server.c，与mongoose.c、mongoose.h放在同一目录，然后编译：

# 编译命令 gcc mongoose.c server.c -o websocket_server -W -Wall # 运行服务器 ./websocket_server

成功运行后会看到输出：

WebSocket服务器已启动: ws://0.0.0.0:8000

提示：如果想查看详细的网络流量，可以取消注释c->is_hexdumping = 1;，这样所有进出数据都会以16进制打印。

4. 功能测试与进阶应用

Mongoose自带了一个测试用的HTML页面，可以快速验证服务器功能：

在浏览器访问http://树莓派IP:8000/test.html
点击"Connect"按钮建立WebSocket连接
在消息框中输入文本并点击"Send"发送

你会看到消息被原样返回，这就是我们实现的echo功能。

对于实际项目，你可以扩展事件处理函数来实现更多功能：

else if (ev == MG_EV_WS_MSG) { struct mg_ws_message *wm = (struct mg_ws_message *) ev_data; // 解析JSON消息 struct mg_str json = wm->data; // 业务逻辑处理... // 发送响应 mg_ws_send(c, "{\"status\":\"OK\"}", 15, WEBSOCKET_OP_TEXT); }

性能优化建议：

调整mg_mgr_poll的超时时间（当前为1000ms）
对于高并发场景，考虑使用连接池
启用TCP_NODELAY减少延迟

5. 实际应用场景示例

下面是一个智能家居控制的实际案例代码框架：

// 智能家居命令处理 void handle_smart_home_command(struct mg_connection *c, struct mg_ws_message *wm) { char response[256]; struct mg_str cmd = wm->data; if (mg_strstr(cmd, mg_str("\"turn_on\""))) { system("gpio write 1 1"); // 打开GPIO1 snprintf(response, sizeof(response), "{\"device\":\"light\",\"status\":\"on\"}"); } else if (mg_strstr(cmd, mg_str("\"turn_off\""))) { system("gpio write 1 0"); // 关闭GPIO1 snprintf(response, sizeof(response), "{\"device\":\"light\",\"status\":\"off\"}"); } else { snprintf(response, sizeof(response), "{\"error\":\"unknown_command\"}"); } mg_ws_send(c, response, strlen(response), WEBSOCKET_OP_TEXT); }

常见问题解决：

连接不稳定：
- 检查树莓派WiFi信号强度
- 适当增加mg_mgr_poll的超时时间

跨域问题：

在HTTP头中添加Access-Control-Allow-Origin

mg_http_reply(c, 200, "Access-Control-Allow-Origin: *\r\n", "...");

性能瓶颈：
- 使用-O2或-O3优化级别编译
- 避免在事件循环中进行阻塞操作

对于需要更高性能的场景，可以考虑以下优化方案：

优化方向	具体措施	预期效果
内存使用	预分配缓冲区	减少动态内存分配开销
网络吞吐	启用TCP快速打开	降低连接建立延迟
CPU利用率	使用多线程事件循环	充分利用多核性能

通过这个极简实现，你已经在树莓派上成功部署了一个功能完备的WebSocket服务器。根据项目需求，你可以轻松扩展其功能，比如添加认证、支持二进制协议或集成MQTT桥接等。Mongoose的简洁设计让这些扩展变得异常简单，这正是它在嵌入式领域广受欢迎的原因。