物联网集成平台-enjoy-iot-新手安装手册

摘要：

本文讨论了项目的快速入门相关内容，涵盖获取源码、开发环境、编译安装、运行项目以及Docker运行等方面的操作说明。关键要点包括：​

1. 获取源码：
   • 后端代码拉取地址为 https://gitee.com/open-enjoy/enjoy-iot，
   • 前端代码拉取地址为 https://gitee.com/open-enjoy/enjoy-web 。​
2. 开发环境：后端需JDK=1.8、Maven >= 3.6 ，多种数据库可选（部分sql脚本待补充），Redis >= 5 ，时序数据库可选择实现对应接口；前端需特定浏览器大版本号在100以上，nodeJs v18+ ，pnpm 。​
3. 编译安装：推荐使用IDEA ，项目默认jdk1.8（11、17也可），按步骤配置JDK ，下载后端代码后在根目录点击install 。​
4. 运行项目：基础设施搭建可选择Docker快速搭建或手动搭建；启动后端项目需新增host、修改连接配置后启动服务；前端项目可在编辑器或命令行操作启动，登录账号为admin/admin123
5. Docker运行 ：docker官方仓库国内访问不便，需自行更新镜像源。

1 获取源码

拉取代码

• 后端：https://gitee.com/open-enjoy/enjoy-iot
• 前端：https://gitee.com/open-enjoy/enjoy-web

2 开发环境

2.2.1后端环境

JDK >=1.8
Maven >= 3.6

2.2.2 基础设施

1. 数据库(必须)(数据库脚本目前只有mysql8的):
   PostgreSQL、Oracle、SQL Server、DM、大金 等其它数据库，也是可以的,目前sql脚本待补充

2. Redis >= 5 (必须)

3. 时序数据库-(必须):

时序数据库可选择自己熟悉的,实现对应的接口即可
TDengine = 3.3.2.0 (已实现)
Elasticsearch (已实现)
Timescale (待移植)
IotDB(待贡献)

4. MQ(可选)
   Kafka
   等
5. EMQX(可选)

2.2.3 前端环境

请使用下列浏览器，浏览器大版本号需在100以上。

• Chrome >= 100
• Firefox >= 100
• Edge >= 100

前端环境

• nodeJs v18+
• pnpm

2.3 编译安装

开发工具：推荐使用IDEA

2.3.0 IDE项目配置

项目默认使用jdk1.8版本(11,17也是可以的)

2.3.1 项目JDK配置

2.3.1 安装步骤

1. 下载后端代码： https://gitee.com/open-enjoy/enjoy-iot， 使用 idea 打开项目，等待项目加载完成以后，打开 maven 栏在根目录点击 install:
   

2. 点击按钮，重新加载项目：
   

2.4 运行项目

2.4.1 基础设施搭建

可以使用项目中的docker-compose快速搭建运行环境mysql,redis,tdengine等服务.如果已经有这些服务,则忽略

方式一：Docker搭建

方式二：手动搭建

搭建mysql
搭建redis
搭建tdegine

2.4.2 启动后端项目

1. 新增host

可以使用switchhost 进行 host 管理。
一般位置：【C:\Windows\System32\drivers\etc】

127.0.0.1 改成你实际部署的服务器地址

127.0.0.1 eiot-server-db
127.0.0.1 iot-server-redis
127.0.0.1 eiot-server-td

2.修改连接配置

根据application.yml 可以看出当前使能了application-eiot.yml,基本的连接配置都在里面

mysql配置:

redis配置:

tdengine配置

需要在tdengine中创建数据库“eiot”
使用默认的用户名和密码即可

3.启动后端服务

2.4.3 启动前端项目

方式1:编辑器中操作

执行pnmp install

点击运行项目

方式2:命令行方式

#进入前端项目目录#安装扩展
pnpm install
#启动项目，须等后端项目启动后，再运行前端启动
pnpm run dev

1. 启动后，正常验证码会出现
   使用admin/admin123 登录系统
   
   联系作者：1571228974