Skip to content

快速开始

📋 环境要求(必须)

  • Java: JDK 21+
  • MySQL: 8.0+
  • Redis: 6.0+
  • EMQX: 5.8.6(支持共享订阅即可)

🧭 部署与启动(一键启动)

  • git clone https://gitee.com/NexIoT/Universal-IoT-Java.git

  • docker-compose up -d

  • 访问地址

    • 后台 http://localhost:80(默认密码进gitee readme.md)
    • IDE调试器 http://localhost:9092/magic/debug/index.html (密码同后台)
    • EMQX 管理 http://localhost:18083(默认 admin/public

🧭 本地打包和部署

  • 必须安装node v16+maven 3.9+Java 21

  • git 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 dev

  • nginx部署,请搜索网上一大堆

如何增加接入方式

  • 开源版本默认开启httpmqtt两种接入方式可以
  • 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