yozik04/nibe-mqtt

Nibe-MQTT Docker镜像文档

镜像概述和主要用途

Nibe-MQTT Docker镜像封装了nibe-mqtt工具，提供Nibe热泵系统与MQTT协议的集成能力。通过该镜像，用户可实现Nibe热泵运行数据的实时采集、状态监控及基于MQTT消息的远程控制，支持将热泵系统无缝接入智能家居或工业监控平台。

核心功能和特性

• 多型号支持：兼容多种Nibe热泵型号，覆盖主流家用及商用系列
• 双向数据通信：支持MQTT消息发布（热泵运行状态、温度、能耗等数据）和订阅（控制命令接收）
• 灵活配置：支持通过配置文件或环境变量进行参数设置，适配不同网络环境
• 数据安全：支持MQTT broker的TLS加密连接，保障数据传输安全
• 轻量高效：基于Alpine基础镜像构建，资源占用低，运行稳定

使用场景和适用范围

• 智能家居集成：与Home Assistant、OpenHAB等智能家居系统联动，实现热泵自动化控制（如根据室内温度调节运行模式）
• 远程监控：通过MQTT消息平台（如Mosquitto、EMQX）远程监控热泵运行状态，实时获取故障告警
• 数据记录与分析：结合时序数据库（如InfluxDB、Prometheus）存储历史运行数据，用于能耗分析和优化
• 工业场景应用：商业场所多热泵集群管理，通过MQTT协议实现集中监控与调度

使用方法和配置说明

前置要求

• 运行中的MQTT broker（如Mosquitto、EMQX）
• Nibe热泵设备网络接入信息（IP地址、端口、访问凭证等）
• Docker环境（Docker Engine 20.10+或Docker Compose 2.0+）

基本使用（docker run）

bash
docker run -d \
  --name nibe-mqtt \
  -v /path/to/config.yaml:/app/config.yaml \
  -e MQTT_HOST=mqtt.example.com \
  -e MQTT_PORT=1883 \
  -e NIBE_SERIAL_NUMBER=12345678 \
  -e NIBE_ACCESS_KEY=your_access_key \
  docker.xuanyuan.run/yozik04/nibe-mqtt

Docker Compose配置示例

yaml
version: '3'
services:
  nibe-mqtt:
    image: docker.xuanyuan.run/yozik04/nibe-mqtt
    container_name: nibe-mqtt
    restart: unless-stopped
    volumes:
      - ./config.yaml:/app/config.yaml
    environment:
      - MQTT_HOST=mqtt.example.com
      - MQTT_PORT=8883
      - MQTT_TLS=true
      - MQTT_USER=mqtt_user
      - MQTT_PASSWORD=mqtt_password
      - NIBE_SERIAL_NUMBER=12345678
      - NIBE_ACCESS_KEY=your_access_key
      - DATA_UPDATE_INTERVAL=60  # 数据更新间隔（秒）

配置参数说明

环境变量

配置文件挂载

若需更复杂配置（如自定义MQTT主题、数据点过滤等），可通过挂载config.yaml配置文件实现，示例配置结构：

yaml
mqtt:
  host: mqtt.example.com
  port: 8883
  tls: true
  username: mqtt_user
  password: mqtt_password
  topic_prefix: nibe/heatpump
nibe:
  serial_number: 12345678
  access_key: your_access_key
  data_points:
    - temperature_outdoor
    - temperature_water_in
    - power_consumption
update_interval: 60

数据交互说明

• 数据发布：镜像定期向nibe/heatpump/<serial_number>/<data_point>主题发布JSON格式数据（如{"value": 23.5, "unit": "°C"}）
• 控制命令：通过向nibe/heatpump/<serial_number>/control/<command>主题发布消息实现控制（如{"target_temperature": 25}）