架构概览
FastBee 开源版采用分层架构设计，各层职责清晰，便于扩展和维护。本页说明系统分层、核心模块与典型数据链路；安装部署与平台操作细节见对应章节。
1. 系统分层
| 层级 | 说明 | 核心组件 |
|---|---|---|
| 接入层 | 设备协议适配与连接管理 | MQTT Broker (Netty)、SIP Server |
| 业务层 | 物联网核心业务逻辑 | 产品/设备/物模型/场景/规则 |
| 服务层 | 通用服务能力 | 认证授权、缓存、消息队列 |
| 数据层 | 数据持久化与存储 | MySQL、Redis、TDengine(可选) |
| 展示层 | 用户界面 | Vue Web、UniApp 移动端 |
接入层基于 Netty 实现 MQTT Broker，设备经 TCP 1883 或 WebSocket 8083 接入；视频设备经 SIP Server 按 GB/T 28181 国标接入。业务层以 Spring Boot 承载产品、设备、物模型、场景联动与规则脚本等核心域。数据层默认 MySQL + Redis，时序数据可选 TDengine、IoTDB、InfluxDB。展示层为 Vue Web 控制台与 UniApp 移动端（微信小程序 / Android / iOS / H5）。完整技术选型见技术栈。
2. 核心模块
- 设备接入：内置 MQTT Broker，支持 MQTT 3.1.1、QoS 0/1、保留消息与遗嘱消息，采用产品 ID + 设备密钥认证，无需额外部署 EMQX。
- 产品/设备/物模型：创建产品并定义物模型（属性、功能、事件），管理设备注册、分组、实时状态与远程控制，见产品管理、设备管理与物模型。
- 场景联动与规则脚本：场景联动以可视化方式配置设备间自动化协作；规则脚本基于 Groovy 语法处理设备上报与平台下发数据，转发匹配设备交互格式。
- 视频监控：支持 GB/T 28181 国标协议，SIP Server 对接 ZLMediaKit 流媒体，提供视频直播与云台控制（开源版仅直播），见视频监控。
- 权限管理：基于若依框架的用户、角色、部门、岗位及操作日志精细化管理。
3. 核心流程
3.1. 设备数据上报
设备 → MQTT Broker → 消息路由 → 规则脚本(可选) → 业务处理3.2. 平台指令下发
用户/API → 业务层 → MQTT Broker → 设备3.3. 视频监控
摄像头 → SIP Server → ZLMediaKit → Web 播放4. 部署架构
4.1. 单机部署（推荐）
所有服务运行在同一台服务器，适合中小规模（≤ 1000 设备），可按安装部署章节使用 Docker Compose 一键部署。
4.2. 分离部署
- Web 与 API 分离到不同服务器
- 数据库独立部署
- 适合中等规模（1000-5000 设备）
5. 版本能力边界
开源版覆盖 MQTT 接入、产品/设备/物模型、场景联动、规则脚本、视频监控（仅直播）与权限管理等核心能力。以下能力仅商业版提供：CoAP/HTTP/TCP 协议接入、可视化大屏、Web 组态（SCADA）、AI 知识库、数据桥接、工单管理、物联网卡管理、告警中心、多租户、OAuth SSO 与 OTA 固件升级，详见商业版文档；集群部署、负载均衡与大规模压测能力见集群版文档。完整功能对照见开源物联网平台的版本对比表。