vzwingmadomatic/deconz

deCONZ Docker镜像

镜像概述

本镜像为deconzcommunity/deconz镜像的克隆版本，容器化了德累斯顿电子（Dresden Elektronik）的deCONZ软件，可通过Conbee USB接口或RaspBee GPIO串口接口控制ZigBee网络。镜像以“最小模式”运行，支持通过WebUI（“Wireless Light Control”和“Phoscon”）、REST API及Websockets管理ZigBee网络，还可选择启动VNC服务器以查看和交互ZigBee mesh。

核心功能

• 支持Conbee（amd64、armhf/armv7、aarch64/arm64架构）和RaspBee（armhf/armv7、aarch64/arm64架构）设备；
• 提供WebUI（Phoscon和Wireless Light Control）、REST API及Websockets接口；
• 可选VNC服务器，用于可视化管理ZigBee网络；
• 多架构支持，适配amd64、armv7、arm64等平台（如树莓派2/3B/3B+）。

使用场景

• 智能家居设备控制：管理ZigBee协议的智能灯、传感器、开关等设备；
• ZigBee网络运维：监控和调试ZigBee mesh网络状态；
• 系统集成：通过REST API将ZigBee设备集成到自定义智能家居系统中。

配置说明

镜像标签

可从Docker Hub或GitHub Container Registry拉取镜像，支持以下标签：

RaspBee配置（Raspbian系统）

若使用RaspBee设备，需先配置Raspbian系统以允许访问串口硬件（参考原镜像文档中的“Configuring Raspbian for RaspBee”部分）。

部署示例

Docker Run命令

bash
docker run -d \
  --name deconz \
  --net=host \
  --restart=always \
  -v /etc/localtime:/etc/localtime:ro \
  -v /opt/deconz:/root/.local/share/dresden-elektronik/deCONZ \
  --device=/dev/ttyACM0 \  # Conbee设备路径，根据实际情况调整
  -e DECONZ_WEB_PORT=80 \
  -e DECONZ_VNC_PORT=5900 \
  vzwingmadomatic/deconz:latest

说明：--net=host模式可确保设备发现功能正常，若不需要可改用端口映射（如-p 80:80 -p 5900:5900）。

Docker Compose示例

yaml
version: '3'
services:
  deconz:
    image: vzwingmadomatic/deconz:latest
    container_name: deconz
    network_mode: host
    restart: always
    volumes:
      - /etc/localtime:/etc/localtime:ro
      - deconz_data:/root/.local/share/dresden-elektronik/deCONZ
    devices:
      - /dev/ttyACM0:/dev/ttyACM0
    environment:
      - DECONZ_WEB_PORT=80
      - DECONZ_VNC_PORT=5900
volumes:
  deconz_data: