1.1 产品定位立即云 - 智联是立即云体系下自研的全栈式物联网服务平台，以云平台 + 智联 APP为核心载体，面向企业开发者、设备厂商、终端用户提供一站式物联网基础设施服务。平台对外提供标准化物联网服务接口与设备全生命周期管理能力，支持海量多协议设备快速接入，配套智联 APP 实现跨品牌、跨品类设备的统一智能管控，助力各行业客户快速完成设备数字化、智能化转型，降低物联网应用开发与落地门槛。1.2 适用范围本产品适用于以下场景与用户群体：·        设备厂商：实现自有智能设备的云端管理、远程运维与移动端控制，无需从零搭建物联网底层架构·        企业开发者：基于平台开放接口快速定制开发行业物联网应用，覆盖工业物联网、智慧园区、智慧农业、智慧商企等场景·        系统集成商：为客户提供一体化物联网解决方案，实现多品类设备的统一接入与集中管控·        终端用户：通过智联 APP 实现家庭 / 办公场景智能设备的远程控制、场景联动与状态监控1.3 核心价值1.   降本提效：提供开箱即用的设备管理能力与标准化接口，大幅缩短物联网项目开发周期，降低研发与运维成本2.   海量兼容：支持主流物联网协议与多品类硬件设备接入，实现跨厂商设备的互联互通3.   安全可靠：全链路加密防护，符合国家网络安全与数据安全相关规范，保障设备、数据、接口的全流程安全4.   灵活扩展：支持公有云、私有化部署两种模式，可根据客户业务规模弹性扩容，适配从小型项目到超大型商用场景的全量级需求5.   闭环体验：平台端管理 + APP 端控制的一体化设计，覆盖从设备接入、数据处理到用户交互的全业务链路  

立即云 - 智联采用分层化、微服务化的云原生架构，全链路分为 5 个核心层级，安全防护体系贯穿所有层级，架构图如下：plaintext【应用层】 ├─ 智联APP（iOS/Android） ├─ 行业定制应用（基于开放接口开发） ├─ 平台管理后台 【平台服务层】（核心层） ├─ 设备管理中心 ├─ 开放接口服务 ├─ 规则引擎 ├─ 数据处理中心 ├─ 消息推送中心 ├─ 权限管理中心 【网络接入层】 ├─ 协议适配网关（MQTT/CoAP/HTTP/WebSocket/TCP） ├─ 接入认证 ├─ 流量控制 ├─ 消息路由 【终端设备层】 ├─ 智能硬件设备（家电、传感器、控制器、工业设备等） ├─ 边缘网关 ├─ 通信模组 【安全防护体系】 ├─ 设备安全 ├─ 传输安全 ├─ 数据安全 ├─ 接口安全 ├─ 应用安全2.1 终端设备层平台的接入对象，包括各类带通信能力的智能终端设备、边缘网关、通信模组，支持有线、无线（Wi-Fi、蓝牙、5G/4G、NB-IoT、LoRa）等多种网络接入方式。2.2 网络接入层平台的设备接入入口，提供多协议适配网关，兼容物联网主流通信协议，完成设备接入认证、消息加解密、流量控制与消息路由，保障设备与云端的稳定通信。2.3 平台服务层平台的核心能力中枢，承载所有核心业务服务，包括设备全生命周期管理、数据采集与分析、规则引擎、开放接口、消息推送、权限管控等核心模块，是所有能力的输出载体。2.4 应用层面向用户的交互入口，包括平台管理后台（面向管理员 / 开发者 / 企业用户）、智联 APP（面向终端用户），以及基于平台开放接口开发的各类行业定制化应用。2.5 安全防护体系贯穿全架构的安全体系，覆盖设备接入、数据传输、数据存储、接口调用、应用访问全链路，提供全方位的安全防护与合规保障。  

3.1 平台端核心功能3.1.1 设备全生命周期管理提供设备从接入到退役的全流程可视化管理能力，核心功能包括：1.   设备快速接入：支持一机一密、一型一密两种认证方式，提供可视化设备注册流程，支持单设备创建与批量设备导入，生成设备唯一身份标识与接入凭证2.   设备状态监控：实时展示设备在线 / 离线 / 故障状态、运行参数、信号强度、激活时间等核心信息，支持设备列表筛选、搜索与分组管理，可自定义设备监控看板3.   远程设备运维：支持远程设备调试、指令下发、固件 OTA 升级（全量 / 灰度升级）、远程重启、配置批量同步，支持故障设备远程排查与日志拉取4.   设备资产管理：记录设备归属、激活地域、使用时长、维修记录等资产信息，支持设备生命周期台账导出，满足企业资产管理需求5.   告警管理：支持自定义设备告警规则（如阈值超标、离线超时、故障上报），告警事件实时记录与分级推送，支持告警工单闭环处理与历史回溯 3.1.2 标准化开放接口服务平台对外提供全功能 RESTful API 与多语言 SDK，覆盖物联网全业务场景，核心能力包括：1.   核心接口覆盖：设备管理、数据读写、指令下发、用户管理、权限配置、消息推送、数据统计等全业务模块2.   多语言 SDK：提供 Java、Python、PHP、Node.js 等主流开发语言 SDK，降低开发者集成门槛3.   接口调试工具：配套在线接口调试平台，支持接口测试、参数校验、响应结果实时查看，方便开发者快速对接4.   接口权限管控：支持接口调用权限精细化配置，可按应用、按角色分配接口调用范围，设置调用频率限流规则 3.1.3 数据智能处理能力内置高性能时序数据库与大数据处理引擎，实现海量设备数据的全流程处理：1.   数据采集与存储：实时采集设备上报的运行数据、状态数据、传感数据，支持高并发数据写入，提供冷热数据分级存储，满足长期数据归档需求2.   数据清洗与转换：支持自定义数据清洗规则，对原始数据进行过滤、格式转换、聚合计算，剔除无效数据，保障数据有效性3.   可视化数据分析：提供拖拽式数据报表与可视化看板，支持设备运行趋势、能耗统计、故障分布、在线率等多维度数据分析，支持报表导出与定时推送4.   数据开放能力：支持设备数据通过接口、消息队列等方式同步至第三方业务系统，实现数据互联互通 3.1.4 智能规则引擎提供可视化拖拽式规则配置能力，无需代码即可实现设备自动化联动与业务流程触发：1.   触发条件配置：支持设备属性上报、定时任务、设备状态变化、API 调用等多种触发方式，可设置多条件组合逻辑2.   执行动作配置：支持设备指令下发、告警推送、消息通知、数据流转、API 回调等多种执行动作，实现设备间的场景联动3.   规则生命周期管理：支持规则的启用、停用、编辑、复制，可查看规则执行日志与执行成功率，方便运维排查 3.1.5 多维度权限管理基于 RBAC（基于角色的访问控制）模型，提供精细化的权限管控能力：1.   角色管理：支持自定义角色，可按企业组织架构、业务模块分配角色权限2.   用户管理：支持多用户账号创建，分配对应角色与数据权限，可设置账号有效期与登录限制3.   数据权限隔离：支持企业级、项目级、设备级三级数据隔离，不同账号仅可查看与管理授权范围内的设备与数据 3.2 智联 APP 端核心功能智联 APP 是平台配套的移动端控制入口，支持 iOS、Android 双平台，是终端用户与智能设备的核心交互载体，核心功能如下： 3.2.1 账号与设备管理1.    支持手机号、邮箱注册登录，支持验证码、密码双重登录方式2.    支持设备快速添加：通过扫码、蓝牙发现、局域网搜索三种方式绑定平台接入的智能设备3.    支持设备分组管理、设备名称自定义、设备位置标注，可按房间、场景分类管理设备4.    支持设备共享：可将设备权限分享给其他 APP 用户，可设置管理员 / 普通用户分级权限，满足家庭、办公多用户管控需求 3.2.2 设备远程控制1.    实时查看设备在线状态与运行参数，支持设备开关、模式切换、参数调节、定时任务等远程控制功能2.    支持设备控制历史记录查询，可回溯设备操作时间、操作人、操作内容3.    支持离线缓存控制，设备上线后自动同步指令，保障控制指令的可靠执行 3.2.3 告警与消息推送1.    设备故障、阈值超标、离线等告警事件实时推送至 APP，支持弹窗、通知栏双重提醒2.    可自定义告警接收时段与免打扰模式，区分告警等级推送3.    支持设备固件升级提醒，可在 APP 内一键完成设备 OTA 升级 3.2.4 智能场景联动1.    支持自定义智能场景，可设置 “一键执行” 与 “自动化触发” 两种模式2.    支持多设备联动配置，例如 “回家模式” 一键开启灯光、空调、窗帘，“离家模式” 一键关闭所有设备并开启安防设备3.    支持定时场景、地理围栏场景、设备状态联动场景等多种触发方式3.2.5 辅助功能4.    设备使用指南与常见问题查询，支持在线客服咨询5.    个人中心与账号安全管理，支持密码修改、手机号更换、账号注销6.    支持多语言切换、深色模式适配，适配不同用户使用习惯  

4.1 核心技术指标表格 指标项 规格参数 设备接入协议 支持 MQTT 3.1/3.1.1/5.0、CoAP、HTTP、WebSocket、TCP、Modbus 协议 单实例设备接入上限 公有云版支持百万级设备并发接入，私有化部署可弹性扩容 消息并发处理能力 单集群支持每秒 10 万 + 条设备消息处理，消息送达时延≤100ms 数据存储能力 支持时序数据高效存储，单集群支持 PB 级数据归档，数据存储时长可自定义 接口响应时间 99% 的 API 请求响应时间≤200ms 服务可用性 公有云版 SLA≥99.95%，私有化部署版可支持双活集群，可用性≥99.99% 设备指令送达率 在线设备指令送达率≥99.99% OTA 升级成功率 设备固件升级成功率≥99.9%，支持断点续传、升级失败回滚  4.2 运行环境要求4.2.1 平台管理后台运行环境表格 环境类型 要求规格 客户端浏览器 支持 Chrome 90+、Edge 90+、Firefox 88+、Safari 14+，建议使用 Chrome 浏览器获得最佳体验 网络要求 上行带宽≥2Mbps，下行带宽≥10Mbps，可稳定访问平台服务器地址 操作系统 支持 Windows 7+、macOS 10.15+、Linux 桌面版  4.2.2 智联 APP 运行环境表格 系统类型 要求规格 iOS 系统 支持 iOS 13.0 及以上版本，兼容 iPhone、iPad 设备 Android 系统 支持 Android 9.0 及以上版本，兼容主流品牌手机、平板设备 网络要求 支持 Wi-Fi、4G、5G 网络，可稳定访问平台服务器地址 硬件要求 支持蓝牙 5.0 及以上（用于蓝牙设备配网），摄像头（用于扫码添加设备） 4.2.3 私有化部署服务器环境表格 部署规模 最低服务器配置 系统要求 小型部署（10 万设备以内） 8 核 16G CPU / 内存，500G SSD 硬盘，4 台服务器（2 主 2 从） CentOS 7.9+/Ubuntu 20.04+，Docker 20+，Kubernetes 1.22+ 中型部署（100 万设备以内） 16 核 32G CPU / 内存，1T SSD 硬盘，8 台服务器集群 CentOS 7.9+/Ubuntu 20.04+，Docker 20+，Kubernetes 1.22+ 大型部署（100 万设备以上） 可根据业务规模提供定制化集群配置方案 适配主流 Linux 发行版，支持国产化服务器与操作系统  

5.1 平台部署方式平台提供两种部署模式，可根据客户需求灵活选择：1.   公有云 SaaS 部署 平台提供开箱即用的 SaaS 服务，客户无需自行部署服务器，注册账号后即可快速使用平台全部能力，按设备接入量、消息量按需付费，适合中小设备厂商、开发者、中小型项目快速落地。2.   私有化部署 平台可完整部署至客户自有服务器、私有云、政务云环境，实现数据与业务的完全自主可控，提供定制化功能开发与专属运维服务，适合大型企业、政府项目、对数据安全有高要求的客户。5.2 设备接入流程1.   前期准备：确认设备支持的通信协议，完成设备端固件开发，适配平台接入协议规范2.   平台创建设备：登录平台管理后台，进入设备管理模块，创建产品型号与设备实例，获取设备唯一接入凭证（ProductKey、DeviceKey、DeviceSecret）3.   设备端适配：在设备固件中集成平台接入 SDK，配置接入凭证与平台接入地址，完成设备联网与协议适配4.   设备接入测试：设备上电联网，在平台后台查看设备在线状态，测试设备数据上报、指令下发功能，确认接入正常5.   批量接入与发布：完成测试后，可批量创建设备实例，实现设备规模化量产接入5.3 开发者接口接入流程1.   创建应用：登录平台管理后台，进入开放平台模块，创建开发者应用，获取应用唯一的 AppKey 与 AppSecret2.   接口鉴权：通过平台认证接口获取 Access Token，所有接口调用需携带 Token 完成身份鉴权3.   接口对接开发：参考平台接口文档，调用对应业务接口，完成设备管理、数据读写、指令下发等功能集成4.   联调测试：使用平台在线调试工具完成接口测试，验证接口调用逻辑与业务流程正常5.   上线发布：完成测试后，正式上线应用，平台提供接口调用监控与运维支持  

6.1 平台管理后台核心操作6.1.1 账号登录与初始化1.    打开平台管理后台网址，输入管理员账号与密码，完成身份验证后登录系统2.    首次登录需完成企业信息认证，设置组织架构与角色权限，创建子用户账号（如需）3.    进入产品管理模块，创建产品型号，定义产品功能点（属性、指令、事件），选择设备接入协议6.1.2 设备创建与管理1.    进入设备管理模块，选择对应产品型号，点击 “添加设备”，输入设备名称、设备编号，完成单设备创建；如需批量添加，可下载模板填写设备信息，批量导入创建2.    设备创建完成后，可查看设备接入凭证、接入地址与接入教程3.    设备上线后，可在设备详情页查看设备实时上报数据、在线状态，可手动下发控制指令，查看设备操作日志4.    如需设备固件升级，进入 OTA 升级模块，上传固件包，创建升级任务，选择升级设备范围，执行全量 / 灰度升级 6.1.3 规则引擎配置1.    进入规则引擎模块，点击 “创建规则”，设置规则名称与触发类型2.    配置规则触发条件，可选择设备属性、设备状态、定时任务等触发方式，设置条件阈值与组合逻辑3.    配置规则执行动作，可选择设备指令下发、告警推送、API 回调等动作，设置执行参数4.    保存规则并启用，可在规则列表查看规则执行状态与执行日志 6.2 智联 APP 核心操作6.2.1 账号注册与登录1.    下载并安装智联 APP，打开 APP 后点击 “注册账号”，输入手机号 / 邮箱，获取验证码，设置登录密码，完成账号注册2.    输入注册的账号与密码，或使用验证码快捷登录，进入 APP 首页6.2.2 设备添加与绑定1.    点击 APP 首页 “添加设备” 按钮，选择对应设备型号，可通过扫码、蓝牙发现、局域网搜索三种方式查找设备2.    按照 APP 指引完成设备配网，输入设备接入的 Wi-Fi 账号与密码，等待设备配网完成3.    配网成功后，设备自动绑定至当前账号，可自定义设备名称与所属分组，完成设备添加6.2.3 设备控制与场景设置1.    在 APP 首页点击对应设备，进入设备控制页面，可查看设备实时状态，执行开关、参数调节、模式切换等操作2.    点击 “定时” 按钮，可设置设备定时开关、定时执行动作，支持重复周期设置3.    进入 “场景” 模块，点击 “创建场景”，设置场景名称，添加触发条件与执行动作，保存后即可一键执行或自动化触发场景  

7.1 接口基本规范1.   接口类型：所有接口均采用 RESTful 架构风格，基于 HTTP/HTTPS 协议传输2.   数据格式：请求与响应数据均采用 JSON 格式，字符编码统一为 UTF-83.   请求方法：遵循 HTTP 标准方法，GET 用于查询数据，POST 用于创建数据，PUT 用于更新数据，DELETE 用于删除数据4.   接口域名：公有云版统一接口域名：www.lijiy.com；私有化部署版使用客户自定义域名5.   版本控制：接口版本通过 URL 路径标识，例如： 7.2 接口鉴权规范1.    所有接口调用必须携带鉴权信息，采用 Access Token 鉴权机制2.    开发者需通过/v1/auth/token接口，使用 AppKey 与 AppSecret 换取有效期为 2 小时的 Access Token3.    业务接口请求时，需在 HTTP Header 中携带Authorization: Bearer {Access Token}，完成身份鉴权4.    平台对接口调用频率进行限流，默认单应用接口调用频率上限为 1000 次 / 分钟，可根据客户需求调整7.3 核心接口列表表格 接口分类 核心接口 接口功能 认证接口 /v1/auth/token 获取 Access Token 设备管理接口 /v1/device/create 创建设备实例   /v1/device/list 获取设备列表   /v1/device/detail 获取设备详情   /v1/device/delete 删除设备实例 设备指令接口 /v1/device/command/send 向设备下发控制指令   /v1/device/command/log 查询设备指令执行日志 数据查询接口 /v1/device/data/query 查询设备历史上报数据   /v1/device/data/realtime 获取设备实时数据 用户管理接口 /v1/user/create 创建终端用户账号   /v1/user/bind/device 绑定用户与设备 告警管理接口 /v1/alarm/list 查询设备告警列表   /v1/alarm/handle 处理告警事件 7.4 响应码规范平台接口采用统一的 HTTP 状态码与业务响应码，核心规范如下：表格 HTTP 状态码 说明 200 请求成功，业务正常执行 400 请求参数错误，请求格式不符合规范 401 鉴权失败，Access Token 无效或过期 403 权限不足，无接口调用权限 404 请求的资源不存在 500 服务器内部错误 业务响应通过统一格式返回，示例如下：json{   "code": 0,   "msg": "success",   "data": {} }·        code=0 表示业务执行成功，非 0 表示业务执行失败，对应具体业务错误码·        msg 为响应信息，成功时返回 success，失败时返回具体错误描述·        data 为响应业务数据，成功时返回对应数据，失败时可返回空  

8.1 设备接入安全1.    所有设备接入必须通过一机一密 / 一型一密身份认证，未认证设备无法接入平台2.    设备接入凭证采用高强度加密存储，禁止明文传输，支持凭证定期更新与泄露吊销3.    支持设备接入 IP 白名单、接入地域限制，可自定义设备接入规则，防范非法接入8.2 数据传输安全1.    设备与平台、客户端与平台之间的通信全链路采用 TLS 1.2 + 加密传输，禁止明文通信2.    设备上报的敏感数据支持端到端加密，平台仅做密文转发，不获取明文数据3.    消息传输采用签名校验机制，防止数据被篡改、重放攻击8.3 数据存储安全1.    设备数据、用户数据采用加密存储，敏感数据采用国密算法加密，保障数据存储安全2.    数据备份采用多副本、异地容灾机制，防止数据丢失，支持数据恢复3.    严格遵循数据最小化原则，仅收集业务必要数据，支持用户数据删除、导出，符合《个人信息保护法》《数据安全法》相关要求8.4 接口安全1.    接口调用全流程采用 HTTPS 加密，防止数据抓包与篡改2.    接口调用采用 Access Token 鉴权 + 签名校验双重机制，防止非法调用3.    接口调用频率限流、异常调用监控告警，防范 DDoS 攻击、刷接口等恶意行为8.5 应用安全1.    智联 APP 采用代码混淆、加固技术，防止反编译与恶意篡改2.    用户账号支持密码强度校验、二次验证、异地登录提醒，保障账号安全3.    APP 权限最小化申请，仅申请业务必要的系统权限，保障用户隐私安全  

故障现象 可能原因 排查与解决方法 设备无法接入平台，一直处于离线状态 1. 设备网络异常，无法访问公网 2. 设备接入凭证错误 3. 接入协议与平台不匹配 4. 平台接入地址配置错误 5. 设备防火墙 / 安全组限制了端口访问 1. 检查设备网络，确认可正常访问公网 2. 核对设备接入凭证（ProductKey、DeviceKey、DeviceSecret）是否正确 3. 确认设备接入协议与平台产品型号配置的协议一致 4. 核对平台接入地址与端口配置正确 5. 检查设备与服务器防火墙 / 安全组，放开对应协议端口 智联 APP 无法添加设备，配网失败 1. 手机与设备不在同一局域网 2. 配网的 Wi-Fi 为 5G 频段，设备仅支持 2.4G Wi-Fi 3. Wi-Fi 密码输入错误 4. 设备处于配网模式异常 5. 路由器开启了 AP 隔离、防火墙限制 1. 确认手机与设备连接同一 2.4G 频段 Wi-Fi 2. 核对 Wi-Fi 密码输入正确，无特殊字符 3. 重启设备，重新进入配网模式 4. 关闭路由器 AP 隔离、防火墙限制，重新配网 APP 远程控制设备无响应 1. 设备处于离线状态 2. 设备网络延迟高，指令未送达 3. 平台与设备通信异常 4. 设备固件异常，无法执行指令 1. 查看 APP 内设备在线状态，确认设备在线 2. 检查设备网络，确认网络稳定 3. 在平台后台下发指令，确认指令是否正常送达 4. 重启设备，升级设备固件至最新版本 开放接口调用返回 401 鉴权失败 1. Access Token 过期 2. Authorization Header 格式错误 3. AppKey 与 AppSecret 错误 4. Token 获取方式错误 1. 重新调用鉴权接口获取新的 Access Token 2. 核对 Header 格式为 Authorization: Bearer {Token} 3. 核对 AppKey 与 AppSecret 与平台创建的应用信息一致 4. 确认鉴权接口请求参数与格式符合规范 设备告警未推送至 APP 1. 告警规则未启用 2. 设备未触发告警阈值 3. APP 通知权限未开启 4. APP 处于免打扰时段 1. 检查平台告警规则配置正确，且处于启用状态 2. 核对设备上报数据是否达到告警阈值 3. 打开手机系统设置，开启智联 APP 的通知权限 4. 检查 APP 内免打扰设置，关闭或调整免打扰时段

术语 全称 解释 MQTT 消息队列遥测传输 物联网行业主流的轻量级通信协议，适用于低带宽、不稳定网络环境的设备通信 CoAP 受限应用协议 面向低功耗物联网设备的轻量化应用层协议，适用于 NB-IoT、LoRa 等低功耗广域网场景 OTA 空中下载技术 通过网络远程为设备进行固件升级、配置更新的技术，无需现场操作设备 RBAC 基于角色的访问控制 一种权限管理模型，通过为角色分配权限，为用户分配角色，实现精细化的权限管控 时序数据库 时间序列数据库 专门用于存储和处理带时间标签的时序数据的数据库，适用于设备传感器数据、运行数据的存储与查询 一机一密 设备认证方式 每个设备拥有唯一的身份凭证，设备接入时通过唯一凭证完成身份认证，安全性高 一型一密 设备认证方式 同型号设备共用统一产品级凭证，设备激活时动态获取设备唯一凭证，适合规模化量产设备