mtand/vera2mqtt Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

镜像概述

本Docker镜像旨在通过MQTT协议实现Vera设备与Home Assistant之间的通信集成，专为内部环境设计使用。它作为中间件，负责采集Vera设备数据并通过MQTT协议转发至Home Assistant，同时支持反向控制指令的传递，实现Vera设备在Home Assistant生态中的统一管理。

核心功能与特性

• 设备数据转发：实时采集Vera设备的状态数据（如开关状态、传感器读数等），并通过MQTT协议推送至Home Assistant。
• 控制指令响应：接收Home Assistant通过MQTT发送的控制指令，转发至Vera设备执行，并同步状态反馈。
• 轻量化设计：基于精简基础镜像构建，资源占用低，运行稳定。
• 内部环境适配：针对内部网络环境优化，支持常见内部部署的Vera设备与Home Assistant架构。

使用场景

适用于内部智能家居系统环境，需将Vera系列智能设备（如智能开关、传感器、温控器等）接入Home Assistant平台，实现设备统一监控、自动化场景配置及集中控制的场景。

使用方法

前提条件

• 已部署运行的MQTT服务器（如Mosquitto）。
• 可访问的Vera设备（已联网并获取IP地址）。
• 运行中的Home Assistant实例，并已配置MQTT集成。

环境变量配置

Docker Run 命令示例

bash
docker run -d \
  --name vera-homeassistant-mqtt \
  -e MQTT_BROKER="mqtt://192.168.1.100:1883" \
  -e MQTT_USER="mqtt_user" \
  -e MQTT_PASSWORD="mqtt_pass123" \
  -e VERA_IP="192.168.1.200" \
  -e HOME_ASSISTANT_PREFIX="homeassistant/vera" \
  --restart unless-stopped \
  [镜像名称]:[标签]

Docker Compose 配置示例

yaml
version: '3'
services:
  vera-mqtt-bridge:
    image: [镜像名称]:[标签]
    container_name: vera-homeassistant-mqtt
    environment:
      - MQTT_BROKER=mqtt://192.168.1.100:1883
      - MQTT_USER=mqtt_user
      - MQTT_PASSWORD=mqtt_pass123
      - VERA_IP=192.168.1.200
      - HOME_ASSISTANT_PREFIX=homeassistant/vera
    restart: unless-stopped

验证与调试

1. 启动容器后，通过docker logs vera-homeassistant-mqtt查看日志，确认是否成功连接Vera设备及MQTT服务器。
2. 在Home Assistant的MQTT集成中，检查是否接收到来自HOME_ASSISTANT_PREFIX主题下的Vera设备状态消息。
3. 若连接失败，优先检查环境变量配置（如MQTT地址、Vera IP是否正确）及网络连通性。

注意事项

• 本镜像仅供内部使用，未经过外部生产环境安全验证，请勿用于公网环境。
• 需确保Vera设备与MQTT服务器、Home Assistant处于同一网络环境，且端口开放（如Vera的3480端口、MQTT的1883端口）。
• 镜像标签建议使用固定版本，避免自动更新导致兼容性问题。