阿里云云云对接接入
约 915 字大约 3 分钟
设备接入第三方协议阿里云云云对接
2026-08-20
简介
阿里云云云对接(aliyunCloud)是联犀平台对接阿里云物联网平台的云云对接协议,已上云设备无需改动固件,通过配置阿里云凭据即可将设备数据同步到联犀平台。
应用场景
- 存量阿里云设备迁移:阿里云 IoT 平台已有设备,平滑接入联犀
- 设备/产品同步:协议自动同步阿里云侧的产品与设备信息
前置条件
- 协议容器已部署:
protocol-aliyun-cloud容器运行正常 - 阿里云凭据:已开通阿里云物联网平台,具备 AccessKey/Secret、Region、消费组等信息
1. 在阿里云准备实例和订阅
- 登录阿里云控制台,在物联网平台选择目标实例,记录实例 ID、地域 ID 和实例所属主账号 UID。
- 在访问控制 RAM 中准备可访问该实例和所需设备接口的 AccessKey ID、AccessKey Secret。
- 进入实例的「消息转发 → 服务端订阅 → 消费组列表」,创建或选择消费组,复制消费组 ID。
- 在服务端订阅中为目标产品新建 AMQP 订阅,选择消费组和需要接收的消息类型。多个产品逐一核对订阅关系。
阿里云控制台操作和截图见AMQP 消费组与服务端订阅示例。
2. 在联犀创建企业账号
打开「设备接入 → 协议配置 → 企业级」,在阿里云云云对接行选择「配置详情」,新增或编辑配置。
| 字段 | 在哪里找 |
|---|---|
| AccessKey ID、AccessKey Secret | 阿里云 RAM 访问密钥 |
| 地域 ID | 实例所在地域,例如 cn-shanghai |
| 实例 ID | 阿里云物联网平台实例详情 |
| 阿里云账号 UID | 实例所属主账号 |
| 消费组 ID | 服务端订阅的消费组列表 |
AccessKey Secret 保存后会隐藏。只改其他字段时可以留空,以保留原密钥。新建云账号使用企业级;已有历史项目账号按原项目归属读取。
3. 绑定产品并验证
选择 aliyunCloud 协议。在产品详情「设备接入」选择对应企业账号,核对云端产品 ProductKey 和实例归属。设备通过网关同步,新增设备归到绑定账号的企业。
在阿里云消费组详情查看客户端和消费状态,再让一台测试设备上报,确认联犀设备列表、调试日志与物模型值均有更新。若保存成功但没有数据,逐项核对 RAM 权限、实例、ProductKey、订阅消息类型和消费组。
技术方案
接入架构
阿里云物联网平台 ──SDK──> protocol-aliyun-cloud 容器 ──MQTT/NATS──> 联犀平台- 协议进程以阿里云凭据连接阿里云物联网平台(AMQP/SDK)
- 消费设备消息并转换为联犀标准物模型格式上报
- 联犀侧下发指令反向推送到阿里云设备
消息流转
- 上行:阿里云设备上报 → 消费组消费 → 协议解析 → 联犀物模型属性/事件
- 下行:联犀服务调用 → 协议转发 → 阿里云设备
注意事项
- 凭据需有阿里云物联网平台对应权限
- 消费组需与设备消息通道一致
- 设备同步依赖协议进程的同步能力(
isEnableSyncDevice)
更新日志
2026/11/10 05:37
查看所有更新日志
ae9e0-docs(设备接入): 更新多协议接入流程与配置范围于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于
