AIOS

Appearance

EdgeIOT 物联网云平台 ​

← 返回使用指南
平台地址：https://zhihongos.cn/iot
更新日期：2026-09-03

目录 ​

  1. 平台定位与架构
  2. 登录与界面导航
  3. 首页：统计与接入引导
  4. 设备接入完整链路（推荐顺序）
  5. 通知管理
  6. 设备管理
  7. 运维管理
  8. 告警中心
  9. 规则引擎 — 场景联动
  10. 系统管理
  11. 模块关系与数据流
  12. 截图索引
  13. 常见问题与排错

1. 平台定位与架构 ​

EdgeIOT 是智鸿 OS 生态中的企业级物联网管理平台，提供从产品定义、物模型、设备接入、协议解析、规则引擎、告警通知到运维监控的全链路能力。

平台顶部有两个一级模块：

模块路由前缀说明
物联网#/iot/...设备、接入、运维、告警、规则引擎
系统管理#/system/...用户、角色、权限、组织、字典等后台配置

核心概念关系：

产品（物模型 + 接入方式）
    ↓
设备实例（绑定产品，获取连接凭证）
    ↓
设备接入网关 ← 协议管理 ← 网络组件 ← 证书管理
    ↓
设备上线 → 属性/事件上报 → 规则引擎 / 告警中心 → 通知管理

登录页

2. 登录与界面导航 ​

2.1 登录步骤 ​

  1. 浏览器访问 https://zhihongos.cn/iot
  2. 确认右上角语言为 中文（若为 English，点击切换为中文）
  3. 输入账号 、密码
  4. 点击 登录

2.2 界面布局 ​

区域说明
顶栏EdgeIOT Logo、「物联网 / 系统管理」模块切换、语言、通知、用户菜单
左侧菜单当前模块下的功能树，支持展开/折叠
面包屑显示当前路径，如物联网 / 设备管理 / 产品
主内容区搜索栏、操作按钮、列表/卡片、分页

2.3 左侧菜单结构（物联网模块） ​

一级菜单二级菜单Hash 路由
首页—#/iot/home
通知管理通知配置 / 通知模板#/iot/notice/Config / Template
设备管理仪表盘 / 产品 / 设备 / 产品分类#/iot/device/DashBoard / Product / Instance / Category
运维管理仪表盘 / 设备接入网关 / 协议管理 / 日志管理 / 网络组件 / 证书管理 / 插件管理 / 设备插件管理#/iot/link/...
告警中心仪表盘 / 基础配置 / 告警配置 / 告警记录#/iot/Alarm/...
规则引擎场景联动#/iot/rule-engine/scene

注意：部分子页面为微前端懒加载，直接输入 URL 后需等待 5–10 秒，或通过左侧菜单点击对应项以确保内容渲染完成。

3. 首页：统计与接入引导 ​

路径：物联网 → 首页（#/iot/home）

首页

3.1 页面组成 ​

区块内容
物联网引导三步快速入口：创建产品 → 创建设备 → 规则引擎
运维引导设备接入配置 → 日志排查 → 实时监控
设备统计产品数量、设备数量（实测：产品 2、设备 0）
基础统计CPU 使用率、JVM 内存等平台运行指标
平台架构图物联接入、设备管理、运维管理、规则引擎、告警中心、应用支撑的可视化关系
设备接入推荐步骤五步详细说明（见下节）
运维管理推荐步骤协议管理、证书管理、网络组件、设备接入网关、日志管理

3.2 设备接入推荐步骤（首页文案摘要） ​

  1. 创建产品 — 产品是设备的集合，物联设备必须通过产品进行接入方式配置
  2. 配置产品接入方式 — 对同一类型设备统一配置接入方式
  3. 添加测试设备 — 添加单个设备验证物模型
  4. 功能调试 — 验证连接与功能是否正确
  5. 批量添加设备 — 同一产品下批量创建设备

4. 设备接入完整链路（推荐顺序） ​

这是平台首页推荐的标准上线流程，各模块按以下顺序配置：

① 运维管理：网络组件（MQTT Broker 等）
       ↓
② 运维管理：协议管理（上传/选择协议包，如实测 JetLinks 官方协议 jar）
       ↓
③ 运维管理：设备接入网关（关联网关 + 协议 + 网络组件）
       ↓
④ 设备管理：产品（创建产品，配置接入方式，定义物模型）
       ↓
⑤ 设备管理：设备（创建设备实例，获取 ClientID/密钥/证书）
       ↓
⑥ 端侧配置连接参数并上线
       ↓
⑦ 设备管理：功能调试（验证属性上报与服务调用）
       ↓
⑧ 告警中心 / 规则引擎 / 通知管理（可选，业务联动）

4.1 实测环境已有配置（供参考） ​

配置项实测值
网络组件JetLinks MQTT，类型 MQTT_SERVER，地址 mqtt://71.255.5.4:1883，状态正常
协议JetLinks官方协议，类型 jar
设备接入网关EdgeComputer接入网关，协议 JetLinks MQTT，地址同上
产品Linux边缘子设备（网关子设备）、EdgeComputer...（网关设备），接入方式均为「未接入」

5. 通知管理 ​

通知管理负责定义消息如何发出，与告警中心、规则引擎配合使用。

5.1 通知配置 ​

路径：通知管理 → 通知配置（#/iot/notice/Config）

通知配置

界面元素说明
搜索栏按「配置名称」等字段筛选，支持保存常用筛选条件
新增创建通知通道配置
导入 / 导出批量迁移通知配置
列表/卡片视图右上角可切换展示方式

典型配置类型（创建时在表单中选择）：

  • 邮件（SMTP）
  • 短信
  • Webhook / HTTP 回调
  • 钉钉 / 企业微信等（视平台插件而定）

操作步骤：

  1. 点击 新增
  2. 填写配置名称、通道类型、服务器地址/密钥等参数
  3. 保存后可在此页 编辑 / 禁用 / 删除
  4. 在告警「基础配置」或场景联动中引用该通知配置

5.2 通知模板 ​

路径：通知管理 → 通知模板（#/iot/notice/Template）

通知模板

通知模板定义消息正文格式，支持变量占位（如 ${deviceName}、${alarmName}）。

步骤操作
1点击新增，选择模板类型（告警、设备事件等）
2编写模板标题与正文，插入变量
3保存后在告警配置或场景联动的「执行动作」中引用

6. 设备管理 ​

设备管理是 IoT 平台的核心业务模块，管理产品、物模型、设备实例与分类。

6.1 设备管理仪表盘 ​

路径：设备管理 → 仪表盘（#/iot/device/DashBoard）

设备管理仪表盘

展示设备维度的统计图表：产品数量、设备数量、在线/离线分布、消息量趋势等，用于日常监控设备接入健康度。

6.2 产品管理 ​

路径：设备管理 → 产品（#/iot/device/Product）

产品列表

6.2.1 什么是产品 ​

产品是具有相同功能与接入方式的设备集合。平台要求：

  • 设备必须先归属某个产品
  • 接入方式、物模型在产品级别统一配置
  • 同一产品下的设备共享物模型定义

6.2.2 产品列表界面 ​

元素说明
卡片/列表展示产品名称、设备类型（网关设备/网关子设备/直连设备等）、接入方式、状态
新增创建新产品
导入批量导入产品定义
编辑 / 导出 / 禁用 / 删除卡片底部操作

6.2.3 创建产品步骤 ​

  1. 点击 + 新增
  2. 填写 产品名称、选择 产品分类（可先在「产品分类」中维护）
  3. 选择 设备类型：网关设备、网关子设备、直连设备等
  4. 选择 接入方式：关联已配置的设备接入网关
  5. 保存产品

6.2.4 产品详情与物模型 ​

点击产品卡片或 编辑 进入产品详情，通常包含以下页签：

页签功能
基本信息产品 ID、名称、分类、设备类型
物模型定义属性、事件、服务（Thing Model）
设备接入查看/修改接入网关与认证方式
远程升级固件 OTA 配置
告警产品级告警关联

物模型三类要素：

类型说明示例
属性（Property）设备状态，可读/可写温度、CPU 使用率、开关状态
事件（Event）设备主动上报高温告警、故障码上报
服务（Service）平台下发控制重启、设置阈值、固件升级

物模型操作：

  • 使用 标准物模型 模板快速导入
  • 手动 新增属性 / 事件 / 服务，配置数据类型、单位、读写权限
  • 导入 / 导出 JSON 格式物模型，便于版本管理
  • 发布物模型 后设备方可按模型通信

6.3 设备实例 ​

路径：设备管理 → 设备（#/iot/device/Instance）

设备列表

6.3.1 创建设备 ​

  1. 点击 + 新增
  2. 选择所属 产品（必选）
  3. 填写 设备名称；设备 ID 可自动生成或手动指定
  4. 保存后进入设备详情，获取连接凭证：
  • MQTT：clientId、username、password 或证书
  • 其他协议视接入方式而定

6.3.2 设备列表字段 ​

字段说明
设备名称 / ID唯一标识
所属产品关联产品名称
状态在线 / 离线 / 未激活
最后上线时间最近一次连接时间

6.3.3 功能调试 ​

设备详情中提供 运行状态 / 物模型 / 设备功能 / 日志 等页签：

  • 属性：查看实时上报值，可手动写入（若属性可写）
  • 功能：调用物模型服务，验证下行控制
  • 日志：查看设备通信日志

6.3.4 端侧上线 ​

端侧需配置与平台一致的：

  1. Broker 地址（来自网络组件，如实测 mqtt://71.255.5.4:1883）
  2. 认证信息（设备详情页获取）
  3. Topic 规范（按 JetLinks 物模型 Topic 规则订阅/发布）

验证：设备列表状态变为 在线，属性页出现上报数据。

6.4 产品分类 ​

路径：设备管理 → 产品分类（#/iot/device/Category）

产品分类

用于对产品进行层级分类（如「边缘计算 / 传感器 / 网关」），便于大量产品时的检索与管理。建议先建分类，再建产品。

7. 运维管理 ​

运维管理配置设备与平台之间的通信基础设施：网络、协议、网关、证书与插件。

7.1 运维仪表盘 ​

路径：运维管理 → 仪表盘（#/iot/link/dashboard）

运维仪表盘

展示 CPU、消息吞吐、在线连接数、网关状态等运维指标。

7.2 设备接入网关 ​

路径：运维管理 → 设备接入网关（#/iot/link/accessConfig）

设备接入网关

设备接入网关是设备连接的逻辑入口，将「传输层（网络组件）」与「协议层（协议管理）」组合为可供产品选择的接入方式。

创建网关步骤 ​

  1. 点击 + 新增
  2. 填写网关名称、说明
  3. 选择 网络组件（如 JetLinks MQTT）
  4. 选择 消息协议（如 JetLinks官方协议）
  5. 配置认证方式（一机一密、一型一密等）
  6. 保存并启用

实测已有网关 EdgeComputer接入网关，使用 JetLinks MQTT + 官方协议，状态 正常。

7.3 协议管理 ​

路径：运维管理 → 协议管理（#/iot/link/protocol）

协议管理

协议包负责解析设备报文（二进制/JSON 等）为平台统一的物模型消息。

操作说明
新增上传.jar 协议包或选择内置协议
编辑修改协议配置参数
删除移除未使用的协议（需先解除网关关联）

实测平台已部署 JetLinks官方协议（类型 jar），适用于标准 JetLinks 设备接入。

自定义协议开发（高级）：

  1. 按 JetLinks 协议 SPI 开发 Java 协议包
  2. 在协议管理上传 jar
  3. 在设备接入网关中引用
  4. 通过日志管理验证编解码是否正确

7.4 日志管理 ​

路径：运维管理 → 日志管理（#/iot/link/Log）

日志管理

提供 访问日志、系统日志、设备通信日志 等查询，是排查接入失败、协议解析错误的首要工具。

场景建议
设备无法上线查设备通信日志 + 网关状态
属性不上报查 Topic 是否匹配、协议是否解析成功
平台异常查系统日志

7.5 网络组件 ​

路径：运维管理 → 网络组件（#/iot/link/type）

网络组件

配置底层网络服务实例：

类型说明
MQTT_SERVER内置或外接 MQTT Broker
TCP_SERVERTCP 长连接服务
HTTP_SERVERHTTP 接入
COAP_SERVERCoAP 轻量协议

实测 JetLinks MQTT 组件状态 正常，公网地址 mqtt://71.255.5.4:1883。创建设备接入网关前必须先有正常运行的网络组件。

7.6 证书管理 ​

路径：运维管理 → 证书管理（#/iot/link/Certificate）

证书管理

管理 TLS 通信证书（Base64 标准），用于 MQTT over TLS、HTTPS 等加密接入。当前环境暂无证书数据，生产环境建议为外网接入配置正式证书。

7.7 插件管理 ​

路径：运维管理 → 插件管理（#/iot/link/plugin）

插件管理

管理系统级插件（协议扩展、编解码、数据处理等），通过 插件 ID 检索与管理。

7.8 设备插件管理 ​

路径：运维管理 → 设备插件管理（#/iot/link/edge-device-plugin）

设备插件管理

面向边缘设备插件包的上传与管理，列表字段包括：名称、包 ID、版本、类型、架构、MD5、上传/发布时间、状态。

操作说明
上传设备插件上传符合平台规范的插件 zip 包
发布 / 禁用控制插件是否可用于设备

适用于 EdgeComputer 等边缘节点需要加载自定义采集/协议插件的场景。

8. 告警中心 ​

告警中心负责监控异常并记录，可与通知管理、规则引擎联动。

8.1 告警仪表盘 ​

路径：告警中心 → 仪表盘（#/iot/Alarm/dashboard）

告警仪表盘

展示今日告警数、告警级别分布、处理状态等统计。

8.2 基础配置 ​

路径：告警中心 → 基础配置（#/iot/Alarm/Config）

告警基础配置

配置告警级别定义（如紧急/重要/一般）、默认通知方式、告警声音等全局参数。新建告警规则前建议先完成基础配置。

8.3 告警配置 ​

路径：告警中心 → 告警配置（#/iot/Alarm/Configuration）

告警配置

定义具体告警规则：

配置项说明
配置名称规则标识
告警级别引用基础配置中的级别
触发条件设备属性阈值、离线超时、场景输出等
通知方式关联通知配置与模板
生效范围指定产品/设备/场景

创建步骤：

  1. 点击 + 新增
  2. 选择告警类型（设备告警 / 场景告警等）
  3. 配置触发条件（如温度 > 40℃ 持续 5 分钟）
  4. 选择通知通道与模板
  5. 保存并启用

8.4 告警记录 ​

路径：告警中心 → 告警记录（#/iot/Alarm/Log）

告警记录

查看历史告警，支持按 全部 / 产品 / 设备 / 场景 页签筛选，可标记处理状态、查看告警详情与关联设备。

9. 规则引擎 — 场景联动 ​

路径：规则引擎 → 场景联动（#/iot/rule-engine/scene）

场景联动

场景联动实现自动化编排：当满足条件时自动执行动作。

9.1 典型场景 ​

场景触发条件执行动作
高温联动温度属性 > 40℃发送告警通知 + 调用空调服务
门禁事件门禁打开事件记录日志 + Webhook 推送
设备离线设备离线超过 10 分钟告警 + 短信通知

9.2 创建场景步骤 ​

  1. 点击 + 新增
  2. 填写场景名称
  3. 触发器：选择设备属性/事件/定时/Cron 等
  4. 条件：可选，添加过滤逻辑
  5. 动作：设备功能调用、告警、通知、延迟等
  6. 保存并 启用 场景

9.3 与告警的区别 ​

模块侧重
告警中心异常检测、分级、记录、处理流程
规则引擎通用自动化，可组合多设备、多动作

二者可配合：场景联动触发告警，告警中心统一记录与通知。

10. 系统管理 ​

点击顶栏 系统管理 进入后台管理模块（路由 #/system/...）。

10.1 基础配置 ​

路径：系统管理 → 基础配置（#/system/Basis）

基础配置

平台级参数：系统名称、Logo、会话超时、密码策略等。

10.2 用户管理 ​

路径：系统管理 → 用户管理（#/system/user）

用户管理

功能说明
新增创建普通管理员/操作员账号
编辑 / 禁用 / 删除账号生命周期管理
重置密码通过操作列图标执行

实测默认存在 Administrator（admin，超级管理员，状态正常）。

10.3 组织管理 ​

路径：系统管理 → 组织管理（#/system/Department）

组织管理

树形组织结构，支持 新增 部门、绑定用户、批量解绑，用于多租户/多部门权限隔离。

10.4 角色管理 ​

路径：系统管理 → 角色管理（#/system/Role）

角色管理

定义角色分组与 全局角色，为角色分配菜单与操作权限。

10.5 菜单管理 ​

路径：系统管理 → 菜单管理（#/system/Menu）

菜单管理

维护左侧导航菜单树。实测根菜单包括 iot（物联网）与 system（系统管理）。

10.6 权限管理 ​

路径：系统管理 → 权限管理（#/system/Permission）

权限管理

细粒度 API/按钮级权限 标识（如 device-product、alarm-config、certificate 等），通过角色分配给用户。

10.7 关系配置 / 订阅管理 / 数据字典 ​

模块路径截图说明
关系配置#/system/Relationship027_...png定义实体间关系类型
订阅管理#/system/NoticeRule028_...png系统级消息订阅规则
数据字典#/system/Dictionary029_...png维护枚举值、下拉选项等字典项

关系配置订阅管理数据字典

11. 模块关系与数据流 ​

┌─────────────┐     ┌──────────────┐     ┌─────────────┐
│  网络组件    │ ──→ │ 设备接入网关  │ ──→ │    产品      │
│ (MQTT/TCP)  │     │ + 协议管理    │     │ + 物模型     │
└─────────────┘     └──────────────┘     └──────┬──────┘
                                                 │
                                                 ▼
                                          ┌─────────────┐
                                          │    设备      │
                                          │  (端侧上线)  │
                                          └──────┬──────┘
                                                 │ 属性/事件
                    ┌────────────────────────────┼────────────────────────────┐
                    ▼                            ▼                            ▼
             ┌─────────────┐              ┌─────────────┐              ┌─────────────┐
             │  规则引擎    │              │  告警中心    │              │  日志管理    │
             │  场景联动    │              │  告警配置    │              │  通信排查    │
             └──────┬──────┘              └──────┬──────┘              └─────────────┘
                    │                            │
                    └──────────────┬─────────────┘
                                   ▼
                            ┌─────────────┐
                            │  通知管理    │
                            │ 配置 + 模板  │
                            └─────────────┘

12. 截图索引 ​

文件页面
000_登录页.png登录页
001_首页.png物联网首页
002_通知管理_通知配置.png通知配置
003_通知管理_通知模板.png通知模板
004_设备管理_仪表盘.png设备管理仪表盘
005_设备管理_产品.png产品列表
006_设备管理_设备.png设备列表
007_设备管理_产品分类.png产品分类
008_运维管理_仪表盘.png运维仪表盘
009_运维管理_设备接入网关.png设备接入网关
010_运维管理_协议管理.png协议管理
011_运维管理_日志管理.png日志管理
012_运维管理_网络组件.png网络组件
013_运维管理_证书管理.png证书管理
014_运维管理_插件管理.png插件管理
015_运维管理_设备插件管理.png设备插件管理
016_告警中心_仪表盘.png告警仪表盘
017_告警中心_基础配置.png告警基础配置
018_告警中心_告警配置.png告警配置
019_告警中心_告警记录.png告警记录
020_规则引擎_场景联动.png场景联动
021–029系统管理各子页

13. 常见问题与排错 ​

13.1 子页面空白、只有侧栏没有内容 ​

原因：EdgeIOT 使用微前端懒加载，直接跳转 Hash 或加载未完成时主内容区为空。

解决：

  1. 通过左侧菜单点击目标项（不要仅改 URL）
  2. 等待 5–10 秒 直至出现面包屑与「新增」按钮
  3. 自动化截图需等待 .ant-spin-spinning 消失后再截屏

13.2 界面为英文 ​

登录后点击右上角语言选择器，切换为 中文。自动化脚本在每次导航后应调用语言切换逻辑。

13.3 设备无法上线 ​

检查项位置
网络组件是否正常运维管理 → 网络组件
网关是否启用运维管理 → 设备接入网关
产品接入方式是否已配置设备管理 → 产品 → 设备接入
设备凭证是否正确设备详情
通信日志运维管理 → 日志管理

13.4 物模型不生效 ​

  1. 确认物模型已 发布
  2. 设备 Topic 与物模型 ID 一致
  3. 协议包能正确解析报文（查日志）

13.5 快速上手 Checklist ​

  • [ ] 中文界面登录
  • [ ] 确认网络组件与设备接入网关正常
  • [ ] 创建/选择产品，配置接入方式，定义并发布物模型
  • [ ] 创建设备，配置端侧连接参数
  • [ ] 验证设备在线与属性上报
  • [ ] 配置告警规则或场景联动
  • [ ] 配置通知通道与模板

截图脚本：scripts/capture_iot_pages.py（全量）、scripts/capture_iot_retry.py（空白页重试）。 页面元数据：docs/iot_pages.json

AIOS 官方文档

Copyright © 2026 AIOS