![物联网平台内置 MQTT Broker 决策示意图](images/covers/cover-protocol.svg)

一句话结论：**中小规模、以设备接入为主的 FastBee 项目，先用内置 MQTT Broker，可以少部署、少运维一个独立消息中间件**；当连接规模、协议特性或运维分工超出内置 Broker 边界时，再切换到外部 EMQX，或在商业交付中直接规划集群版 FMQ。这不是"谁替代谁"的问题，而是"当前阶段哪个组件数量与能力边界最匹配"的问题。

## 1. 讨论范围与证据边界

本文写于 2026 年 10 月 31 日，依据是 FastBee 官方文档站的公开页面，文末附来源清单。本文不自行压测：文中涉及的容量描述均标注出处，且不构成任何项目的容量承诺。具体项目的连接数、吞吐与时延目标，请在 POC 环境用真实设备和真实消息模型复测。

## 2. 内置 Broker 什么时候能减少组件

按官方[内置 MQTT Broker 文档](https://www.fastbee.cn/doc/open/v2/architecture/mqtt-broker.html)，FastBee 社区版把基于 Netty 的 MQTT Broker 直接做进了接入服务，与后端同进程启动：

* MQTT 3.1.1，TCP 1883 与 WebSocket 8083 两种接入方式；
* QoS 0/1、保留消息、遗嘱消息、持久会话与清理会话；
* 认证复用平台的产品 ID + 设备密钥体系，设备凭据与平台设备管理天然一致。

对设备规模不大、以"设备上报 + 平台下发"为主的项目，这意味着部署清单里少了一个 EMQX 进程，也少了配套的 [HTTP 认证、Webhook 与规则配置](https://www.fastbee.cn/doc/business/v2/install/emqx.html)。认证、上下线、消息路由在同一应用内闭环，排错时不用在"设备—Broker—平台"三方之间来回定位。快速体验、二次开发环境和小规模私有化交付，通常都属于这一档。

## 3. 内置 Broker 的边界

内置 Broker 是平台自带的接入组件，不是通用消息中间件，也不是 EMQX 的直接替代品。动手之前先确认以下边界：

* **协议特性**：官方文档列明 MQTT 3.1.1、QoS 0/1。需要 MQTT 5.0 扩展特性或 QoS 2 精确一次语义的项目，内置 Broker 不在能力清单内。
* **主题模型**：平台主题以 `/{productId}/{deviceNum}/...` 组织，服务于设备接入语义；它不承担业务系统之间任意发布订阅的总线职责，自定义数据格式需经规则脚本转换。
* **部署形态**：内置 Broker 面向单机部署，与应用共享节点资源；集群接入、负载均衡与大规模连接属于集群版的能力范围。
* **运维形态**：没有独立的 Broker 控制台、插件体系与认证扩展生态；需要 EMQX Dashboard、规则插件或定制认证链路的项目，内置 Broker 不提供等价物。

如果上述任何一条是硬需求，直接评估外部 Broker，不要围绕内置 Broker 做绕行设计。

## 4. 接入链路怎么验证：不要只验证"能连上"

无论用内置 Broker 还是外部 EMQX，验收标准相同。按 [MQTT 接入](https://www.fastbee.cn/doc/open/v2/quickstart/mqtt.html) 文档用 MQTTX 走一遍最小闭环：

1. 用 `S&设备编号&产品ID&用户ID` 格式的 clientId 连接 1883 端口，确认设备详情显示在线；
2. 发布 `/{productId}/{deviceNum}/info/post` 与 `/{productId}/{deviceNum}/property/post`，确认设备信息与运行状态刷新；
3. 订阅 `/{productId}/{deviceNum}/function/get`，从平台下发指令并让设备回传结果；
4. 触发一次规则或场景联动，确认数据进入业务闭环。

[部署 FAQ](https://www.fastbee.cn/doc/help/deployment-faq.html) 特别提醒：切换 Broker 实现后不能只验证客户端能连接，设备上线、属性上报、指令下发、状态回传要全部重验。这条对内置与外部两种形态同样适用。

## 5. 什么时候改用外部 EMQX

官方[技术栈文档](https://www.fastbee.cn/doc/business/v2/architecture/technology-stack.html)给出的启用条件很直接："需要独立 MQTT Broker 或更高连接规模时启用"。落到项目语言，通常是这几类信号：

* 接入连接数或消息吞吐明显超出单节点舒适区，需要 Broker 独立扩容；
* 需要 MQTT 5.0、QoS 2 或 EMQX 的插件、控制台与认证生态；
* 组织上 Broker 由独立团队运维，或已有现成的 EMQX 集群与监控体系。

FastBee 与 EMQX 的对接是官方支持的形态：EMQX 通过 HTTP 认证（`/iot/tool/mqtt/authv5`）校验设备凭据，通过 Webhook（`/iot/tool/mqtt/webhookv5`）把设备上下线与订阅事件回传平台，完整配置样例见 [EMQX 安装与配置](https://www.fastbee.cn/doc/business/v2/install/emqx.html)。切换入口是后端配置：

```yaml
server:
  broker:
    enabled: true   # true = 内置 Netty Broker；false = 外部 EMQX（需配置 spring.mqtt.host-url）
```

注意成本也同步回来了：EMQX 的部署、认证回调、Webhook 规则、控制台账号与升级都变成你的运维责任，部署清单从"一个应用"变回"应用 + 消息中间件"。

## 6. 连接规模继续增长：集群版 FMQ 路径

当单节点之外还要横向扩展接入能力时，FastBee 的商业路线是集群版：以自研 FMQ 服务集群承接 MQTT 接入，配合 Web 集群与负载均衡横向扩容，见[集群版文档](https://www.fastbee.cn/doc/cluster/v2.md)与 [FMQ 集群部署](https://www.fastbee.cn/doc/cluster/v2/server/fmq-cluster-deploy.html)。这是一条与"内置 Broker → 外部 EMQX"不同的扩展路径：它保留平台一体化的认证与设备管理模型，把接入层本身做成可多节点部署的独立服务。

选型不要凭架构图下单。专业版已有[压测报告](https://www.fastbee.cn/doc/business/v2/architecture/stresstest.html)，集群版压测报告仍在编写中；任何容量结论都应以项目自己的同环境压测为准，版本与授权边界以[商用授权说明](https://www.fastbee.cn/doc/sponsor.md)为准。

## 7. 一页决策清单

| 项目特征 | 建议路径 |
| --- | --- |
| 快速体验、演示、二次开发环境 | 内置 Broker |
| 中小规模私有化，设备以 MQTT 3.1.1 + QoS 0/1 接入 | 内置 Broker，按第 4 节验收 |
| 需要 MQTT 5.0 / QoS 2 / Broker 独立扩容 / 已有 EMQX 运维体系 | 外部 EMQX |
| 大规模接入、明确高可用与横向扩展要求 | 评估集群版 FMQ，以 POC 压测为准 |

## 8. 来源与延伸阅读

2026 年 11 月 19 日补充延伸阅读：[开源物联网平台（社区版总览）](https://www.fastbee.cn/doc/open/v2.md)

以下来源用于核对本文事实，核对日期为 2026 年 10 月 31 日：

* [内置 MQTT Broker（社区版架构）](https://www.fastbee.cn/doc/open/v2/architecture/mqtt-broker.html)：特性、能力边界与模块结构
* [MQTT 接入](https://www.fastbee.cn/doc/open/v2/quickstart/mqtt.html)：连接参数、认证格式与 MQTTX 联调验收清单
* [EMQX 安装与配置](https://www.fastbee.cn/doc/business/v2/install/emqx.html)：外部 Broker 的认证、Webhook 与规则配置
* [技术栈与模块](https://www.fastbee.cn/doc/business/v2/architecture/technology-stack.html)：组件启用条件与拆分原则
* [部署与升级 FAQ](https://www.fastbee.cn/doc/help/deployment-faq.html)：内置 Broker 与 EMQX 的切换注意事项
* [FMQ 集群部署](https://www.fastbee.cn/doc/cluster/v2/server/fmq-cluster-deploy.html)、[专业版压测报告](https://www.fastbee.cn/doc/business/v2/architecture/stresstest.html)：集群路径与容量参考口径

## 9. 常见问题

### 9.1. 内置 Broker 能替代 EMQX 吗？

不能按"替代品"理解。内置 Broker 覆盖 FastBee 设备接入所需的 MQTT 3.1.1、QoS 0/1、保留消息与遗嘱消息，并与平台认证一体；但它不提供 MQTT 5.0、QoS 2、独立控制台与插件生态，也不承担业务系统之间的通用消息总线职责。需要这些能力时应使用外部 EMQX。

### 9.2. 从内置 Broker 切换到 EMQX 要改什么？

将后端 `server.broker.enabled` 置为 `false` 并配置 `spring.mqtt.host-url`，在 EMQX 侧配置 HTTP 认证与 Webhook，分别指向平台的 `/iot/tool/mqtt/authv5` 与 `/iot/tool/mqtt/webhookv5`，并同步调整前端 WebSocket 地址与端口。切换后按第 4 节完整重验上线、上报、下发与回传。

### 9.3. 内置 Broker 能支撑多少设备？

官方文档给出的量级参考是单机数千并发连接，这是文档陈述而非容量承诺。实际上限取决于服务器配置、上报频率、消息大小与业务负载；正式容量结论请用项目自己的消息模型做压测，并参考[专业版压测报告](https://www.fastbee.cn/doc/business/v2/architecture/stresstest.html)的硬件与统计口径。

### 9.4. 什么情况下应该直接评估集群版？

当项目明确要求接入层高可用、横向扩展，或单节点压测已不满足连接与吞吐目标时，不必先经历"外部 EMQX"这一步，可以直接评估集群版的 FMQ 服务集群、Web 集群与负载均衡，并以项目自己的 POC 压测数据做最终决定。
