阿里云云云对接接入
约 649 字大约 2 分钟
设备接入第三方协议阿里云云云对接
2026-08-20
简介
阿里云云云对接（aliyunCloud）是联犀平台对接阿里云物联网平台的云云对接协议，已上云设备无需改动固件，通过配置阿里云凭据即可将设备数据同步到联犀平台。
应用场景
- 存量阿里云设备迁移：阿里云 IoT 平台已有设备，平滑接入联犀
- 设备/产品同步：协议自动同步阿里云侧的产品与设备信息
前置条件
- 协议容器已部署：
protocol-aliyun-cloud容器运行正常 - 阿里云凭据：已开通阿里云物联网平台，具备 AccessKey/Secret、Region、消费组等信息
产品配置
1. 创建产品
创建产品时选择协议 aliyunCloud（传输协议 MQTT），创建后进入产品详情。
2. 协议配置参数（产品维度）
aliyunCloud 协议注册了凭据字段（ConfigFields），配置保存到产品协议配置 protocolConf，协议进程据此连接阿里云并同步数据：
| 字段 | 说明 |
|---|---|
accessKeyID | 阿里云 AccessKey ID |
accessKeySecret | 阿里云 AccessKey Secret |
regionID | 地域（如 cn-shanghai） |
iotInstanceID | 阿里云物联网平台实例 ID |
uid | 阿里云账号 UID |
consumerGroupID | 消费组 ID |
aliyunCloud 协议未提供自托管配置页，产品/设备详情「设备接入」Tab 会显示「配置页暂不可用」占位提示，属正常现象；阿里云凭据通过产品协议配置（protocolConf）维护。
设备接入
云云对接模式下设备由阿里云侧管理，无需在联犀侧单独创建设备。设备数据经阿里云 → 协议网关 → 联犀平台流转。
技术方案
接入架构
阿里云物联网平台 ──SDK──> protocol-aliyun-cloud 容器 ──MQTT/NATS──> 联犀平台- 协议进程以阿里云凭据连接阿里云物联网平台（AMQP/SDK）
- 消费设备消息并转换为联犀标准物模型格式上报
- 联犀侧下发指令反向推送到阿里云设备
消息流转
- 上行：阿里云设备上报 → 消费组消费 → 协议解析 → 联犀物模型属性/事件
- 下行：联犀服务调用 → 协议转发 → 阿里云设备
注意事项
- 凭据需有阿里云物联网平台对应权限
- 消费组需与设备消息通道一致
- 设备同步依赖协议进程的同步能力（
isEnableSyncDevice）
更新日志
2026/8/31 22:31
查看所有更新日志
2fc1c-Merge #36 into master from docs/user-facing-cleanup于eb33f-Merge #35 into master from docs/third-party-protocols-update于4ab8f-Merge #25 into master from docs/third-party-protocols于
