krambox/homekit2mqtt

homekit2mqtt镜像说明

镜像概述

homekit2mqtt是一款HomeKit与MQTT协议的桥接工具，依赖HAP-NodeJS开发，用于将MQTT连接的智能家居设备整合到HomeKit生态，支持通过Siri语音或HomeKit应用控制设备，适用于家庭自动化场景。

核心功能

1. 支持多种HomeKit服务类型（如温度传感器、灯光、门锁、摄像头等）
2. 通过MQTT协议与智能设备通信，同步状态与控制指令
3. 提供Web UI配置界面（默认端口51888），支持可视化设备映射
4. 支持MQTT认证、TLS加密连接及持久化数据存储
5. 可自定义MQTT payload解析规则，适配不同设备协议

使用场景

• 家庭自动化中，将非HomeKit的MQTT设备接入HomeKit生态
• 通过Siri语音控制MQTT设备（如开关灯光、调节温度）
• 监控MQTT设备状态并同步到HomeKit应用

配置说明

关键参数

• --url: MQTT broker地址（默认：mqtt://127.0.0.1）
• --storagedir: 持久化存储目录（建议设置外部路径避免更新覆盖）
• --mapfile: 设备映射配置文件路径（默认：./example-homekit2mqtt.json）
• --pincode: HomeKit配对码（默认：031-45-154）
• --web-port: Web UI端口（默认：51888）

Web UI配置

访问http://<主机IP>:51888，使用用户名homekit和配对码登录，可可视化配置设备映射规则。

Docker部署示例

Docker Run命令

bash
docker run -d \
  --name homekit2mqtt \
  -p 51826:51826 \
  -p 51888:51888 \
  -v /本地存储路径:/storage \
  -v /本地映射文件路径:/app/mapfile.json \
  krambox/homekit2mqtt \
  --storagedir /storage \
  --mapfile /app/mapfile.json \
  --url mqtt://你的MQTT broker地址:1883

Docker Compose示例

yaml
version: '3'
services:
  homekit2mqtt:
    image: krambox/homekit2mqtt
    ports:
      - "51826:51826"
      - "51888:51888"
    volumes:
      - ./storage:/storage
      - ./mapfile.json:/app/mapfile.json
    command: >
      --storagedir /storage
      --mapfile /app/mapfile.json
      --url mqtt://mqtt-broker:1883