sonicblue/iot-devicetwin

IoT设备孪生服务

镜像概述

该服务用于存储已连接IoT设备的状态信息。当设备在IoT身份服务中注册后，会创建一个设备孪生记录，保存设备的当前状态和期望状态，支持IoT管理系统对设备的监控与控制。

核心功能

• 保存设备摘要信息
• 记录设备最后一次心跳数据
• 管理设备所属分组
• 存储设备当前状态与期望状态详情
• 提供缓存支持IoT管理服务监控设备
• 向IoT设备代理转发动作指令（如安装新应用）

使用场景

• 企业级IoT设备管理平台：实时监控设备状态，同步设备期望配置
• 智能工厂设备管理：远程下发设备操作指令，跟踪设备状态变化
• 智能家居系统：统一管理家居设备状态，实现设备联动控制

配置说明

运行服务时支持以下参数：

• -configdir：证书目录路径（默认"certs"）
• -datasource：数据存储源
• -driver：数据存储驱动（默认"memory"）
• -mqttport：MQTT broker端口（默认"8883"）
• -mqtturl：MQTT broker URL（默认"mqtt.example.com"）
• -port：服务监听端口（默认"8040"）

服务通过configdir中的证书（ca.crt、server.crt、server.key）连接MQTT Broker。

Docker部署示例

Docker Run命令

bash
docker run -d \
  -v ./your-certs-dir:/certs \
  -p 8040:8040 \
  docker.xuanyuan.run/sonicblue/iot-devicetwin \
  -mqtturl mqtt.yourdomain.com \
  -mqttport 8883 \
  -configdir /certs

贡献指南

在贡献代码前，请签署https://www.ubuntu.com/legal/contributors%EF%BC%8C%E4%BB%A5%E6%8E%88%E6%9D%83Canonical%E4%BD%BF%E7%94%A8%E6%82%A8%E7%9A%84%E8%B4%A1%E7%8C%AE%E5%86%85%E5%AE%B9%E3%80%82