# IOTGateConsole

**Repository Path**: willbeahero/IOTGateConsole

## Basic Information

- **Project Name**: IOTGateConsole
- **Description**: IOTGate智能网关的控制台程序，用于查看当前GATE CLUSTER的运行状态，执行 网关启动、关闭、重启以及网关多规约策略配置等操作
- **Primary Language**: Java
- **License**: GPL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 66
- **Forks**: 56
- **Created**: 2019-03-18
- **Last Updated**: 2026-10-10

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# IOTGateConsole —— IOTGate 智能网关控制台（AI 智能体版）

![IOTGate Logo](iotgate-logo.png)

> IOTGate 智能网关的**管理平台**：实时查看 IOTGate CLUSTER 运行状态，远程执行网关规约解析服务的启动、关闭、重启，以及多规约策略配置；**v3.0.1 全新升级为 AI 智能体版本**，内置 AI 悬浮机器人，粘贴协议帧结构描述即可自动生成规约配置。

[![文档站](https://img.shields.io/badge/📚%20文档站-BrianApple.github.io-38bdf8)](https://BrianApple.github.io/docs/iotgate-console/intro)
[![Gitee Stars](https://img.shields.io/badge/dynamic/json?label=Gitee%20Stars&query=stargazers_count&url=https%3A%2F%2Fgitee.com%2Fapi%2Fv5%2Frepos%2Fwillbeahero%2FIOTGateConsole&color=red)](https://gitee.com/willbeahero/IOTGateConsole)

---

## ✨ 核心功能

| 能力 | 说明 |
|---|---|
| **节点监控** | 实时展示网关节点列表，HTTP 探针（默认 10s）判活并区分失败原因，SSE 实时推送上下线 |
| **规约远程管理** | 远程开启/关闭/新增/删除网关多规约解析服务，变更实时同步网关 |
| **AI 智能体（v3.0.1）** | 右下角悬浮机器人：粘贴协议**帧结构描述** → 大模型自动提取长度域、推导拆包/黏包解码参数 → **一键填充**规约表单 |
| **大模型动态配置** | 厂商无关（DeepSeek/通义/GLM/Ollama/OpenAI 等任意 OpenAI 兼容接口），可视化修改、保存即时生效、无需重启 |
| **节点托管** | 「节点管理」页登记网关 IP 即可接入，10s 探针判活；网关上无需任何注册配置，也无需 Zookeeper |
| **Vue3 前端** | 单页应用 + SSE 实时事件推送（节点状态/规约变更） |

## 🎯 项目价值

- **架构演进**：去除 Zookeeper 依赖，控制台主动探针（`GET /gate/status`）+ 主动下发（`POST /gate/command`），部署更简单
- **AI 提效**：协议接入从人工解析报文 → AI 自动推导解码参数，接入效率大幅提升
- **技术栈**：JDK 21 + Spring Boot 3.5 + LangChain4j 1.18（AiServices 声明式结构化输出）
- **开箱即用**：MySQL 建表 + 环境变量注入口令 + jar 启动，默认端口 8686

## 📸 截图

| AI 智能体对话解析 | 节点管理 |
|---|---|
| ![AI智能体](docs/screenshots/bot-chat-v2.2.png) | ![节点管理](docs/screenshots/node-manage-v2.2.png) |

| 大模型配置面板 | 规约管理（多规约策略） |
|---|---|
| ![模型设置](docs/screenshots/bot-settings-v2.2.png) | ![规约管理](docs/screenshots/strategy-page-v2.png) |

## 🚀 快速开始

```bash
# 1. 环境：jdk21（Temurin 21 LTS 及以上）、mysql5.5+、IOTGate 节点
# 2. 导入建表脚本
mysql -uroot -p < src/main/resources/strategy.sql

# 3. 数据库口令通过环境变量注入（避免明文入库）
export DB_USERNAME=root
export DB_PASSWORD=你的数据库密码

# 4. 启动后登录，在「节点管理」页新增网关节点（填网关 IP，端口填网关 iotGate.conf 的
#    commandPort，默认 10917）。节点存在 gate_node 表，不需要在 application.properties 里配列表。

# 5. 打包启动（默认端口 8686）
mvn package
java -jar target/iotgate-console.jar

# 6. 访问 http://127.0.0.1:8686/static/index.html （用户名密码随意填写，没有存库）
```

可调配置（`application.properties`）：

| 配置项 | 默认 | 说明 |
|---|---|---|
| `gate.monitor.interval-seconds` | 10 | 探针周期，同时决定差量补发的节奏 |
| `gate.command-token` | 空（关闭） | 与网关 `iotGate.conf` 的 `commandToken` 对应，开启后下发指令带 `X-Gate-Token` 请求头 |

## 📚 详细文档（文档站）

完整教程已迁移至文档站，**后续文档更新以文档站为核心**：

| 文档 | 链接 |
|---|---|
| 产品介绍 | https://BrianApple.github.io/docs/iotgate-console/intro |
| 快速开始 | https://BrianApple.github.io/docs/iotgate-console/quickstart |
| 使用指南 | https://BrianApple.github.io/docs/iotgate-console/guide |

## 📌 版本

- **v3.0.1（当前，AI 智能体版）**：全新升级为智能体版本——悬浮机器人 + 大模型配置动态化 + 节点/规约管理增强（JDK 21 + Spring Boot 3.5 + LangChain4j 1.18），与 IOTGate v3.0.1 网关配套
- **v2.2**：AI 智能体过渡版本（悬浮机器人 + 大模型配置动态化）
- **v2.1**：新增智能体模式（AI 解析协议帧结构、自动填充规约表单）
- **v2.0**：去 Zookeeper、Vue3 重构、SSE 实时推送

## 🔗 生态与链接

- **网关本体**：IOTGate —— https://gitee.com/willbeahero/IOTGate
- **GitHub 镜像**：https://github.com/BrianApple/IOTGateConsole
- **开源文档站**：https://BrianApple.github.io （全部产品教程）
- **交流群**：QQ 844082385