ThingLinks物联网平台技术文档

【免费下载链接】thinglinks 开源ThingLinks物联网一体化平台，高性能、高吞吐量、高扩展性的物联网平台！单机可以支持百万链接，同时支持自定义扩展功能，功能非常强大，采用netty作为通信层组件，支持插件化开发集成！ 项目地址: https://gitcode.com/mqttsnet/thinglinks

1. 安装指南

1.1 环境要求

• JDK 1.8+
• Maven 3.5+
• MySQL 5.7+
• Redis 5.0+
• Nacos 2.0+
• TDengine 2.0+ (可选)
• Node.js 12+ (前端开发需要)

1.2 后端服务安装

1. 克隆项目仓库：

   git clone https://github.com/mqttsnet/thinglinks.git
   

2. 导入数据库脚本：

   • 执行/sql目录下的SQL文件初始化数据库

3. 配置Nacos：

   • 启动Nacos服务
   • 导入/nacos目录下的配置文件

4. 修改配置：

   • 根据实际环境修改application.yml中的数据库、Redis等连接信息

5. 编译项目：

   mvn clean package
   

6. 启动服务：

   java -jar thinglinks-admin.jar
   

2. 项目使用说明

2.1 系统登录

1. 默认管理员账号：admin/admin123
2. 首次登录后请修改默认密码

2.2 核心功能使用

2.2.1 设备管理

1. 创建产品：定义设备类型和通信协议
2. 添加设备：为产品添加具体设备实例
3. 设备调试：通过实时日志查看设备通信状态

2.2.2 规则引擎

1. 创建规则链：定义消息处理流程
2. 配置规则节点：支持多种消息处理方式
3. 启动规则：激活消息处理流程

2.2.3 数据可视化

1. 设备地理位置：在地图上查看设备分布
2. 数据图表：展示设备上报的历史数据

3. 项目API使用文档

3.1 设备接入API

3.1.1 MQTT设备接入

// MQTT连接示例
MqttClient client = new MqttClient("tcp://服务器地址:1883", "clientId");
client.connect();
client.subscribe("设备主题");

3.1.2 HTTP设备接入

# 设备数据上报示例
POST /api/v1/device/data
Content-Type: application/json
Authorization: Bearer {access_token}

{
  "deviceId": "设备ID",
  "data": "上报数据"
}

3.2 平台管理API

3.2.1 设备管理

# 创建设备
POST /api/v1/device
# 查询设备列表
GET /api/v1/device/list
# 发送设备指令
POST /api/v1/device/command

3.2.2 规则引擎

# 创建规则链
POST /api/v1/rule/chain
# 启停规则
PUT /api/v1/rule/chain/{id}/status

4. 项目安装方式

4.1 快速部署(Docker方式)

1. 准备docker-compose.yml文件
2. 启动服务：

   docker-compose up -d
   

4.2 集群部署

1. 部署Nacos集群
2. 配置Redis哨兵或集群
3. 部署多个MQTT Broker节点
4. 配置负载均衡

4.3 开发环境搭建

1. 导入IDE(推荐IntelliJ IDEA)
2. 配置Maven依赖
3. 启动前端开发服务：

   cd thinglinks-ui
   npm install
   npm run dev
   

5. 注意事项

1. 生产环境请配置SSL/TLS加密通信
2. 定期备份重要数据
3. 监控系统资源使用情况
4. 及时更新安全补丁

本技术文档将持续更新，建议定期查看项目官方文档获取最新信息。

【免费下载链接】thinglinks 开源ThingLinks物联网一体化平台，高性能、高吞吐量、高扩展性的物联网平台！单机可以支持百万链接，同时支持自定义扩展功能，功能非常强大，采用netty作为通信层组件，支持插件化开发集成！ 项目地址: https://gitcode.com/mqttsnet/thinglinks