LobsterBoard实时数据流揭秘:Server-Sent Events让仪表盘数据自动刷新
LobsterBoard实时数据流揭秘:Server-Sent Events让仪表盘数据自动刷新
LobsterBoard 是一款自托管的拖拽式仪表盘构建器(Dashboard Builder),内置 60+ 组件。它的实时数据流基于 Server-Sent Events(SSE)实现:CPU、内存、磁盘、网络等系统监控组件无需手动刷新,数据由服务端每 2 秒自动推送,仪表盘即时更新。本文将带你揭秘这条实时数据链路的完整工作原理。
为什么选择 SSE 而不是轮询?
让仪表盘"活"起来,常见方案有三种:
| 方案 | 特点 | 适合场景 |
|---|---|---|
| 定时轮询 | 客户端每隔 N 秒发一次请求,存在延迟和空请求浪费 | 数据变化慢 |
| WebSocket | 全双工通信,实现复杂 | 需要双向交互 |
| SSE | 服务端单向推送,浏览器原生支持自动重连 | 监控类实时数据流 |
监控场景只需要"服务器 → 浏览器"的单向数据流,SSE 恰好是性价比最高的选择:一行 new EventSource(...) 就能建立连接,断线后浏览器会自动重连,几乎零维护成本。
服务端:实时数据流的采集与广播
LobsterBoard 的 SSE 核心逻辑位于 server/stats.cjs,分为两步:
第一步:按不同频率采集系统指标。 服务端使用 systeminformation 库读取本机状态,各项指标采集频率不同——server/stats.cjs#L27-L44 中可以看到 CPU 和网络每 2 秒刷新一次,内存每 5 秒、磁盘每 30 秒、Docker 容器每 5 秒:
| 指标 | 采集频率 | 对应组件 |
|---|---|---|
| CPU 负载 / 网络速率 | 每 2 秒 | CPU / Memory、Network Speed |
| 内存占用 | 每 5 秒 | CPU / Memory、Uptime Monitor |
| Docker 容器 | 每 5 秒 | Docker Containers |
| 磁盘用量 | 30 秒 | Disk Usage |
| 运行时长 | 60 秒 | Uptime Monitor |
第二步:广播给所有在线客户端。 每次数据更新后,broadcastStats 会把最新的 JSON 状态以 SSE 标准格式 data: {...}\n\n 写入所有已连接的响应流,见 server/stats.cjs#L15-L20。
连接入口是 GET /api/stats/stream 端点(server.cjs#L185-L200),关键设计有三点:
- 首帧即时送达:客户端一建立连接,服务端立即把当前缓存数据发出去,组件不会出现"空白等待";
- 连接数保护:最多允许 10 个 SSE 连接,超出返回 429,防止资源耗尽;
- 断连自动清理:客户端断开时服务端立即将其从
sseClients集合中移除,不泄露连接。
客户端:一条共享连接,驱动整个仪表盘
前端这边更优雅:所有系统监控组件共用一条 SSE 连接,而不是每个组件各开一条。
在 js/widgets/shared/stats.js#L11-L28 中,onSystemStats(callback) 函数采用"单例"模式——第一个订阅的组件创建 EventSource 实例,后续组件只是把回调函数加入列表。每当服务端推送数据,所有订阅组件同时收到更新:
_statsSource = new EventSource('/api/stats/stream');
_statsSource.onmessage = (e) => {
const data = JSON.parse(e.data);
_statsCallbacks.forEach(cb => cb(data));
};
断线时 EventSource 会自动重连,组件无需任何额外处理(js/widgets/shared/stats.js#L23-L27)。
哪些组件享受实时推送?
js/widgets/system.js 中的 5 个监控组件全部走这条 SSE 通道:
- 🖥️ CPU / Memory — 负载、内存条形图,2 秒一跳
- 💾 Disk Usage — 磁盘占用率
- 🌐 Network Speed — 上下行速率
- 🐳 Docker Containers — 容器运行状态
- ⏱️ Uptime Monitor — 系统运行时长
💡 远程服务器怎么办? 对于局域网外的远程主机,SSE 跨网络不太现实,LobsterBoard 改用降级方案:每 10 秒轮询远程代理(lobsterboard-agent)的 /api/servers/{id}/stats 接口,连续失败 3 次后自动标记为离线状态,组件仍会显示最后已知数据和离线提示,见 js/widgets/shared/stats.js#L43-L127。本地用 SSE 推、远程用轮询,一套 onStats() 接口对上层组件完全透明。
三步体验实时仪表盘
想自己跑起来感受 SSE 推送效果?只需三步:
- 获取并安装:
git clone https://gitcode.com/gh_mirrors/lo/LobsterBoard cd LobsterBoard npm install - 启动服务:
node server.cjs,然后打开http://localhost:8080 - 添加监控组件:按
Ctrl+E进入编辑模式,从左侧组件库拖入 CPU / Memory、Network Speed 等组件,点击 💾 Save。打开浏览器开发者工具的 Network 面板,你会看到/api/stats/stream请求一直挂着text/event-stream,数据源源不断地流入。
一条链路,如何保证可靠?
实时功能最怕"推丢了、连断了、测不出来"。LobsterBoard 在 tests/sse.test.js 中为这条链路写满了测试用例,覆盖四个关键场景:
- ✅ 响应头必须是
text/event-stream+no-cache(避免被中间缓存拦截) - ✅ 连接后立即收到首帧数据,且包含
timestamp时间戳 - ✅ 持续接收多条更新(模拟 2 秒周期的广播节奏)
- ✅ 客户端断开后服务端正确清理连接,无资源泄漏
配合服务端的 10 连接上限、防重入的采集锁(同一指标采集未完成时跳过本轮),整条链路在各种异常情况下都能保持稳定。
小结
LobsterBoard 的实时数据流设计堪称"轻量级最佳实践":
- 服务端:分级频率采集 + 缓存 + 广播,CPU 数据 2 秒一跳
- 传输层:SSE 单向下行推送,原生
EventSource免费获得自动重连 - 客户端:单例共享连接 + 回调订阅,任意多个组件共用一条流
- 兜底策略:远程主机降级轮询,离线自动标记
- 质量保障:专门的 SSE 集成测试覆盖连接、推送、清理全生命周期
如果你的项目也需要监控类实时数据,这套"SSE 广播 + 共享连接"的模式非常值得参考——代码量不到 100 行,却能换来整个仪表盘的丝滑自动刷新。🦞


