环境要求
大约 1 分钟frameworkintro
MQTT 消息服务器选择
BladeX-Links 提供原生 blade-broker 与 EMQX 两种接入方式。设备协议与物模型共用，服务部署和注册方式按下表选择。
| 项目 | blade-broker | EMQX 接入 |
|---|---|---|
| 服务实现 | Java，基于 mica-mqtt 2.6.13 | EMQX、平台认证服务与 Kafka 插件 |
| 部署方式 | 单机模式或 Kafka 集群模式 | EMQX 配合 blade-emqx、Kafka 和 blade-data |
| MQTT 会话 | 连接断开后清理会话 | 支持会话保留，保留时间由客户端与服务端配置决定 |
| MQTT 动态注册 | 支持 authtype=register | 先通过平台或应用侧注册接口创建设备，再使用设备密钥连接 |
| 平台规则 | 支持场景联动与规则转发 | 支持场景联动与规则转发 |
需要离线会话保留时选择 EMQX。原生服务的单机模式适合先完成设备接入，再按业务负载扩展。
运行环境
教程截图保留制作时的版本，Links 3.0 的运行环境如下。
| 组件 | 版本要求 |
|---|---|
| JDK | 21 |
| Maven | 3.8+ |
| Node.js | 18+ |
| MySQL | 推荐 8.x |
| Redis | 推荐 7.x |
| 时序数据库 | TDengine 3.x、InfluxDB 1.8.x / 2.x、IoTDB 1.3.x，按存储插件选择 |
后端使用 Spring Boot 4.1.1、blade-tool 5.0.2、mica-mqtt 2.6.13，业务序列化保持 Jackson 2。前端使用 Vue 3、TypeScript 和 Vite 5。
- 前端配置文件：
website.js→website.ts，vite.config.mjs→vite.config.mts。 - Java 基础镜像：
bladex/alpine-java:openjdk21_cn_slim。
工程目录与模块职责见项目架构。