Eclipse Hono 镜像文档

镜像概述

Eclipse Hono是一个开源物联网（IoT）中间件，提供统一服务接口以简化IoT设备与后端系统（如云端平台或企业应用）的连接。该镜像封装了Hono核心组件，支持设备注册、数据传输、命令下发等功能，帮助快速构建标准化IoT接入层。

主要用途

• 为各类IoT设备提供标准化接入接口，降低设备与后端集成复杂度
• 支持多协议设备接入与统一管理
• 实现设备身份验证、遥测数据传输及远程控制
• 作为IoT生态系统接入层，连接底层设备与上层应用服务

核心功能和特性

统一服务接口

• 提供设备注册、认证、遥测数据上传、事件通知、命令下发等标准化接口
• 基于REST和AMQP协议的服务端点，便于后端系统集成

多协议支持

• 内置协议适配器，支持MQTT、HTTP、AMQP等主流IoT协议
• 可扩展架构，支持自定义协议适配器开发

设备身份管理

• 设备身份注册与验证机制
• 基于租户的多租户隔离，保障数据安全

消息路由与处理

• 高效遥测数据和事件消息路由
• 支持与Apache Kafka、RabbitMQ等消息中间件集成，实现消息持久化

可扩展性与可靠性

• 微服务架构设计，支持水平扩展
• 高可用性配置，保障服务持续运行

使用场景和适用范围

适用场景

• IoT设备管理平台：统一管理多品牌、多类型设备接入
• 工业物联网（IIoT）：连接工业设备实现生产数据采集与远程控制
• 智能家居系统：整合智能家电设备，提供统一接入接口
• 智慧城市项目：连接交通、环保、安防等城市设备构建综合管理平台

适用范围

• 需要统一设备接入接口的云服务提供商
• IoT应用开发企业与开发者
• 构建大规模设备网络的组织
• 对多协议兼容性有需求的IoT项目

使用方法和配置说明

前提条件

• Docker Engine 20.10+ 或 Docker Desktop
• （可选）Docker Compose 用于多容器部署

Docker 快速启动示例

bash
# 启动设备注册服务
docker run -d \
  --name hono-registry \
  -p 28080:28080 \
  -e SPRING_PROFILES_ACTIVE=dev \
  eclipse/hono-service-device-registry:latest

# 启动命令路由服务
docker run -d \
  --name hono-router \
  -p 5000:5000 \
  --link hono-registry \
  -e SPRING_PROFILES_ACTIVE=dev \
  -e HONO_REGISTRY_HOST=hono-registry \
  eclipse/hono-service-command-router:latest

# 启动MQTT协议适配器
docker run -d \
  --name hono-mqtt \
  -p 1883:1883 \
  --link hono-registry --link hono-router \
  -e SPRING_PROFILES_ACTIVE=dev \
  -e HONO_REGISTRY_HOST=hono-registry \
  -e HONO_COMMAND_ROUTER_HOST=hono-router \
  eclipse/hono-adapter-mqtt-vertx:latest

Docker Compose 配置示例

创建docker-compose.yml文件：

yaml
version: '3.8'

services:
  device-registry:
    image: eclipse/hono-service-device-registry:latest
    ports:
      - "28080:28080"  # HTTP API端口
      - "5775:5775"    # AMQP端口
    environment:
      - SPRING_PROFILES_ACTIVE=dev
      - HONO_REGISTRY_STORAGE_TYPE=memory  # 开发环境使用内存存储
    restart: unless-stopped

  command-router:
    image: eclipse/hono-service-command-router:latest
    ports:
      - "5000:5000"  # AMQP端口
    environment:
      - SPRING_PROFILES_ACTIVE=dev
      - HONO_REGISTRY_HOST=device-registry
      - HONO_REGISTRY_PORT=5775
    depends_on:
      - device-registry
    restart: unless-stopped

  mqtt-adapter:
    image: eclipse/hono-adapter-mqtt-vertx:latest
    ports:
      - "1883:1883"  # MQTT非加密端口
      - "8883:8883"  # MQTT加密端口
    environment:
      - SPRING_PROFILES_ACTIVE=dev
      - HONO_REGISTRY_HOST=device-registry
      - HONO_COMMAND_ROUTER_HOST=command-router
    depends_on:
      - device-registry
      - command-router
    restart: unless-stopped

启动命令：

bash
docker-compose up -d

核心配置参数（环境变量）

设备注册服务（hono-service-device-registry）

MQTT协议适配器（hono-adapter-mqtt-vertx）

注意事项

• 开发环境可使用dev配置文件快速启动，生产环境需配置持久化存储、TLS加密及认证授权
• 支持通过部署HTTP、AMQP等适配器扩展协议支持
• 详细配置请参考Eclipse Hono***文档