maretodoric/theengsgateway-arm64

Theengs Gateway - Docker版本（arm64架构）

镜像概述

Theengs Gateway Docker镜像是基于Theengs Gateway项目的容器化版本，支持arm64架构。它通过BLE（蓝牙低功耗）技术采集多种传感器数据，转换为可读的JSON格式后推送到MQTT broker，实现与智能家居平台或IoT系统的集成。

核心功能

• 多传感器兼容：支持Govee、Xiaomi、Inkbird等品牌的BLE传感器（如LYWSD03MMC、RuuviTag、MiScale等）；
• 数据转换推送：将传感器数据转换为JSON格式，并发送至指定MQTT broker；
• 平台集成：可对接Home Assistant、NodeRED、OpenHAB等智能家居/物联网平台；
• 灵活配置：支持自定义MQTT参数、扫描时间、日志级别等配置项。

使用场景

• 智能家居系统中BLE传感器数据的采集与整合；
• 替代故障的设备内置蓝牙适配器，恢复传感器数据获取；
• IoT项目中BLE设备与MQTT生态的对接。

配置说明

关键环境变量

• MQTT_HOST：必填，MQTT broker的IP地址或域名；
• MQTT_USERNAME/MQTT_PASSWORD：可选，MQTT broker的认证信息；
• SCAN_TIME：可选，BLE设备扫描间隔（默认60秒）；
• LOG_LEVEL：可选，日志级别（如DEBUG、INFO）。

部署示例

Docker Compose方式

yaml
version: '3.1'
services:
  theengsgateway:
    image: docker.xuanyuan.run/maretodoric/theengsgateway-arm64:latest
    network_mode: host
    environment:
      MQTT_HOST: <你的MQTT主机IP>
      # 可选参数（按需添加）
      # MQTT_USERNAME: <用户名>
      # MQTT_PASSWORD: <密码>
    volumes:
      - /var/run/dbus:/var/run/dbus

执行命令：docker compose up -d（后台运行）

Docker Run方式

bash
docker run --rm -d \
  --network host \
  -e MQTT_HOST=<你的MQTT主机IP> \
  -v /var/run/dbus:/var/run/dbus \
  --name theengsgateway \
  docker.xuanyuan.run/maretodoric/theengsgateway-arm64:latest

注意事项

• 容器需挂载/var/run/dbus以访问蓝牙设备；
• 网络模式需设为host以正常扫描BLE设备；
• 更多配置参数可参考Theengs Gateway官方文档。