快速开始
📋 环境要求(必须)
- Java: JDK 21+
- MySQL: 8.0+
- Redis: 6.0+
- EMQX: 5.8.6(支持共享订阅即可)
🧭 部署与启动(一键启动)
git clone https://gitee.com/NexIoT/Universal-IoT-Java.gitdocker-compose up -d访问地址:
- 后台
http://localhost:80(默认密码进giteereadme.md) - IDE调试器
http://localhost:9092/magic/debug/index.html(密码同后台) - EMQX 管理
http://localhost:18083(默认admin/public)
- 后台
🧭 本地打包和部署
必须安装
node v16+、maven 3.9+、Java 21git clone https://gitee.com/NexIoT/Universal-IoT-Java.git后端打包
mvn clean package -Dmaven.test.skip=true -Pdev其中dev自己换当前配置环境前端打包
cd cn-universal-web-ui && npm install && npm run devnginx部署,请搜索网上一大堆
如何增加接入方式
- 开源版本默认开启
http和mqtt两种接入方式可以 - application-{your}.properties 选择开启和关闭
- 自己二次开发扩展或购买商业模块

properties
# ================================
# 接入模块开关配置
# ================================
# TCP协议
tcp.protocol.enabled=true
# UDP协议
udp.protocol.enabled=true
# CT-AIoT协议 (电信)
ctaiot.protocol.enable=true
# OneNet协议 (移动)
onenet.protocol.enabled=true
# ImouLife协议 (乐橙)
imoulife.protocol.enabled=true
#wvp
wvp.protocol.enabled=true📸相关教程
注意
IDEA必须 2023.2版本之后才支持JDK21
【NexIoT课程】(一)IDEA与Docker一键启动
【NexIoT课程】(二)EMQX配置
【NexIoT课程】(三)打包和服务器启动
【NexIoT课程】(四)MQTT任意主题Topic与全流程对接教程
启动必须修改的配置
properties
spring.datasource.url=jdbc:mysql://192.168.31.194:3307/univ?useUnicode=true&characterEncoding=utf8&serverTimezone=GMT%2B8&useSSL=true&useJDBCCompliantTimezoneShift=true
spring.datasource.username=root
spring.datasource.password=
# ================================
# Redis 配置:IP和Port
# ================================
spring.data.redis.host=192.168.31.194
spring.data.redis.port=6379
spring.data.redis.password=
# EMQX:IP和地址账号密码
# ================================
mqtt.cfg.desc=MQTT IoT 平台 broker 服务器配置
mqtt.cfg.enable=true
mqtt.cfg.host=tcp://192.168.31.194:1883
#外网访问的域名,在产品连接信息会显示
mqtt.cfg.host.out=tcp://mqtttest.nexiot.xyz:51883
mqtt.cfg.clientIdPrefix=
mqtt.cfg.client.username=
mqtt.cfg.client.password=
#EMQX-http鉴权
mqtt.cfg.emqx.header.key=universal-emqx
mqtt.cfg.emqx.header.value=d41d8cd98f00b204e9800998ecf8427e🎯 下一步
最后更新时间:2025-01-15