阿里云云云对接接入
简介
阿里云云云对接（aliyunCloud）是联犀平台对接阿里云物联网平台的云云对接协议，已上云设备无需改动固件，通过配置阿里云凭据即可将设备数据同步到联犀平台。
应用场景
- 存量阿里云设备迁移：阿里云 IoT 平台已有设备，平滑接入联犀
- 设备/产品同步：协议自动同步阿里云侧的产品与设备信息
前置条件
- 协议容器已部署：
protocol-aliyun-cloud容器运行正常 - 阿里云凭据：已开通阿里云物联网平台，具备 AccessKey/Secret、Region、消费组等信息
产品配置
1. 创建产品
创建产品时选择协议 aliyunCloud（传输协议 MQTT），创建后进入产品详情。
2. 协议配置参数（产品维度）
进入产品详情「设备接入」Tab，填写阿里云凭据：
| 字段 | 说明 |
|---|---|
accessKeyID | 阿里云 AccessKey ID |
accessKeySecret | 阿里云 AccessKey Secret |
regionID | 地域（如 cn-shanghai） |
consumerGroupID | 消费组 ID |
| 其他字段 | 按协议注册的 ConfigFields 配置 |
配置保存到产品协议配置 protocolConf，协议进程据此连接阿里云并同步数据。
设备接入
云云对接模式下设备由阿里云侧管理，无需在联犀侧单独创建设备。设备数据经阿里云 → 协议网关 → 联犀平台流转。
技术方案
接入架构
阿里云物联网平台 ──SDK──> protocol-aliyun-cloud 容器 ──MQTT/NATS──> 联犀平台- 协议进程以阿里云凭据连接阿里云物联网平台（AMQP/SDK）
- 消费设备消息并转换为联犀标准物模型格式上报
- 联犀侧下发指令反向推送到阿里云设备
消息流转
- 上行：阿里云设备上报 → 消费组消费 → 协议解析 → 联犀物模型属性/事件
- 下行：联犀服务调用 → 协议转发 → 阿里云设备
注意事项
- 凭据需有阿里云物联网平台对应权限
- 消费组需与设备消息通道一致
- 设备同步依赖协议进程的同步能力（
isEnableSyncDevice）
更新日志
2026/8/20 21:56
查看所有更新日志
70f71-于
