功能开启
进度说明:
- 管理后台,请使用 https://gitee.com/yudaocode/yudao-ui-admin-vue3 (opens new window) 仓库的
master分支 - 后端项目,请使用 https://gitee.com/zhijiantianya/yudao-cloud (opens new window) 仓库的
master(JDK8) 或master-jdk17(JDK17/21) 分支
IoT 系统(对标 阿里云物联网 (opens new window)),后端由 yudao-module-iot 服务实现,前端由 yudao-ui-admin-vue3 的 iot 目录实现。
考虑到编译速度,默认 yudao-module-iot 服务是关闭的,需要手动开启。步骤如下:
- 第一步,导入 IoT 系统的 SQL 数据库脚本
- 第二步,搭建 TDengine 时序数据库
- 第三步,重启后端项目,确认功能是否生效
# 1. 第一步,导入 SQL
① 点击 iot-2026-02-10.sql.zip (opens new window) 下载附件,解压出 SQL 文件,然后导入到数据库中。
所有表名字,都使用 iot_ 作为前缀。
友情提示:↑↑↑ iot.sql 是可以点击下载的! ↑↑↑
重要说明:该 SQL 仅芋道星球成员可使用和商用,否则视为侵权(索赔 100 万,永久追溯)【下载即视为同意】。
② 参考 《定时任务》 (opens new window) 文档,只需要将 Quartz 定时任务的 quartz.sql 导入到数据库中即可(其它不用做)。【场景联动需要 Quartz 定时任务】
# 2. 第二步,搭建 TDengine 时序数据库
① 参考 《用 Docker 快速体验 TDengine》 (opens new window) 文档,快速搭建 TDengine 时序数据库。命令如下:
docker run -d \
--name tdengine-test \
-p 6030:6030 \
-p 6041:6041 \
-p 6043:6043 \
-p 6044-6049:6044-6049 \
-p 6044-6045:6044-6045/udp \
-p 6060:6060 \
tdengine/tdengine
② 在 TDengine 中,创建 ruoyi_vue_pro 数据库。命令如下:
## 进入容器
docker exec -it tdengine-test /bin/bash
## 在容器内,使用 taos 命令行工具创建数据库:
taos
## 进入 TDengine CLI 后,执行以下 SQL 命令创建数据库:
CREATE DATABASE ruoyi_vue_pro;
默认的账号是 root,密码是 taosdata。
③ 修改项目的 application-local.yaml 配置文件,配置 TDengine 数据库。如下图所示:

# 3. 第三步,重启项目
① 运行该服务的 IoTServerApplication (opens new window) 启动类,看到 "Started IoTServerApplication in 18.105 seconds" 说明开启成功。

至此,我们就成功开启了 IoT 的功能 🙂
② (可选)同步内置的测试产品的物模型配置,创建对应的表结构到 TDengine 时序数据库中。如下图所示:

# 4. 阅读指南
IoT 手册的文章较多,建议按照以下顺序阅读,循序渐进:
# 4.1 第一阶段:基础管理(必读)
先掌握产品、物模型、设备三个核心概念:
# 4.2 第二阶段:设备接入(按需阅读)
了解设备如何接入平台,先看概述,再根据协议需求选读:
- 设备接入(概述) —— 务必先读! 整体架构、消息格式、认证方式
- 设备接入(MQTT 协议) —— 最常用的协议,推荐优先阅读
- 其它协议按需选读:HTTP、EMQX、TCP、UDP、WebSocket、CoAP、Modbus Client、Modbus Server
- 设备接入(自定义协议) —— 扩展新协议的开发指南
# 4.3 第三阶段:进阶功能(按需阅读)
根据业务需要选读: