carldebilly/zigbee2mqttassistant

Zigbee2Mqtt Assistant Docker镜像文档

镜像概述和主要用途

本镜像为Zigbee2Mqtt Assistant项目的Docker封装，项目GitHub地址：https://github.com/yllibed/Zigbee2MqttAssistant%E3%80%82%E4%BD%9C%E4%B8%BAZigbee2Mqtt%E9%A1%B9%E7%9B%AE%E7%9A%84%E5%9B%BE%E5%BD%A2%E5%8C%96%E7%95%8C%E9%9D%A2%E5%B7%A5%E5%85%B7%EF%BC%8C%E5%AE%83%E6%8F%90%E4%BE%9B%E7%9B%B4%E8%A7%82%E7%9A%84%E6%93%8D%E4%BD%9C%E7%95%8C%E9%9D%A2%EF%BC%8C%E5%B8%AE%E5%8A%A9%E7%94%A8%E6%88%B7%E7%AE%A1%E7%90%86%E5%92%8C%E7%9B%91%E6%8E%A7Zigbee%E8%AE%BE%E5%A4%87%EF%BC%8C%E6%97%A0%E9%9C%80%E9%80%9A%E8%BF%87%E5%91%BD%E4%BB%A4%E8%A1%8C%E8%BF%9B%E8%A1%8C%E5%A4%8D%E6%9D%82%E6%93%8D%E4%BD%9C%E3%80%82

核心功能和特性

• 提供图形化用户界面(GUI)，简化Zigbee设备的配置与监控流程
• 支持通过环境变量配置MQTT服务器连接参数
• 兼容容器重启策略设置，确保服务稳定运行
• 可直接作为HASS.IO（Home Assistant）插件集成使用

使用场景和适用范围

• 适用于使用Zigbee2Mqtt协议的智能家居用户，需要可视化管理Zigbee设备
• 适合希望通过图形界面监控Zigbee网络状态的开发者或爱好者
• 可集成到基于HASS.IO的智能家居系统中，扩展设备管理功能

使用方法和配置说明

基本部署命令

通过docker run命令快速部署：

bash
docker run -p 8880:80 -e "Z2MA_SETTINGS__MQTTSERVER=<mqttserver>" -e "Z2MA_SETTINGS__MQTTUSERNAME=<mqttusername>" -e "Z2MA_SETTINGS__MQTTPASSWORD=<mqttpassword>" --restart unless-stopped carldebilly/zigbee2mqttassistant

参数说明

• 端口映射：-p 8880:80 将容器内80端口映射到主机8880端口，通过http://主机IP:8880访问Web界面
• 环境变量：
  • Z2MA_SETTINGS__MQTTSERVER：MQTT服务器地址（必填，如mqtt://192.168.1.100:1883）
  • Z2MA_SETTINGS__MQTTUSERNAME：MQTT服务器认证用户名（如启用认证需填写）
  • Z2MA_SETTINGS__MQTTPASSWORD：MQTT服务器认证密码（如启用认证需填写）
• 重启策略：--restart unless-stopped 配置容器在意外停止时自动重启（手动停止除外）

高级配置

更多配置选项（如MQTT端口、Zigbee2Mqtt路径等）请参考项目官方文档：https://github.com/yllibed/Zigbee2MqttAssistant#settings

HASS.IO插件使用

本镜像可直接作为HASS.IO插件使用，详细集成方法请查阅项目GitHub页面：https://github.com/yllibed/Zigbee2MqttAssistant