tommysense/virtual-bridge Docker 镜像 - 轩辕镜像

TOMMY智能家居通信枢纽镜像

镜像概述

本镜像为TOMMY智能家居系列产品的核心通信枢纽，基于Wi-Fi传感技术构建，旨在实现智能家居设备间的高效通信、数据交互与指令协调，是连接用户与各类智能设备的关键中间件。

核心功能与特性

• Wi-Fi传感技术支持：采用专用Wi-Fi传感协议，实现设备状态实时感知与数据采集
• 设备通信协调：统一管理多品牌、多类型智能设备的通信协议转换与数据转发
• 低延迟数据传输：优化数据处理流程，确保设备指令与状态同步的实时性
• 跨设备兼容性：支持TOMMY全系列智能设备及主流智能家居协议（如Zigbee、Bluetooth等）的桥接
• 安全加密：内置数据传输加密机制，保障设备通信与用户隐私安全

使用场景与适用范围

• TOMMY智能家居系统的中枢节点部署
• 家庭、公寓、小型办公场所的智能设备网络构建
• 需要集中管理多类型智能设备（如智能灯具、传感器、控制器等）的场景
• 对设备响应速度和通信稳定性有较高要求的智能家居环境

使用方法与配置说明

基本部署（Docker Run）

bash
docker run -d \
  --name tommy-hub \
  --restart always \
  --network host \  # 推荐使用host网络以确保Wi-Fi通信稳定性
  -v /etc/tommy-hub:/config \  # 持久化配置文件
  -e TZ=Asia/Shanghai \  # 设置时区
  tommy/smart-home-hub:latest

Docker Compose配置

yaml
version: '3'
services:
  tommy-hub:
    image: tommy/smart-home-hub:latest
    container_name: tommy-hub
    restart: always
    network_mode: host
    volumes:
      - /etc/tommy-hub:/config
    environment:
      - TZ=Asia/Shanghai
      - LOG_LEVEL=info  # 日志级别：debug/info/warn/error
      - MAX_DEVICES=32  # 最大支持设备数量

环境变量配置

设备配对流程

1. 启动容器后，通过浏览器访问 http://<容器IP>:8080 进入管理界面
2. 在"设备管理"页面点击"添加设备"
3. 按照界面提示将智能设备置于配对模式
4. 系统自动识别并完成设备配对，配对结果将显示在设备列表中

数据持久化

配置文件与设备状态数据存储在 /config 目录，建议通过卷挂载实现持久化，避免容器重启后配置丢失。

注意事项

• 确保主机设备具备Wi-Fi功能且已开启
• 初次部署需通过管理界面完成初始网络配置
• 设备数量较多时建议适当调整 MAX_DEVICES 参数以优化性能
• 定期备份 /config 目录下的配置文件以防数据丢失