deconzcommunity/deconz Docker 镜像 - 轩辕镜像

迁移说明

此镜像正在替代marthoc/deconz镜像。

如果要将现有marthoc/deconz安装迁移到deconzcommunity/deconz，必须稍微修改配置。请仔细按照以下步骤操作：

1. 确保已从Phoscon获取最新备份。
2. 将镜像从marthoc/deconz更改为deconzcommunity/deconz。可用标签见此处。
3. 将现有deCONZ卷的容器挂载点从/root/.local/share/dresden-elektronik/deCONZ更改为/opt/deCONZ。

拉取新镜像并启动。

---

deCONZ Docker镜像

此Docker镜像容器化了Dresden Elektronik的deCONZ软件，该软件通过Conbee USB或RaspBee GPIO串口接口控制ZigBee网络。此镜像以"最小"模式运行deCONZ，支持通过WebUI（"Wireless Light Control"和"Phoscon"）、REST API和Websockets控制ZigBee网络，还可选择运行VNC服务器，用于通过deCONZ UI查看和交互ZigBee网格。

Conbee支持amd64、armhf/armv7和aarch64/arm64（如RaspberryPi 2/3B/3B+及其他arm64板）架构；RaspBee支持armhf/armv7和aarch64/arm64（有关配置Raspbian以允许访问RaspBee串口硬件的说明，请参见下文"为RaspBee配置Raspbian"部分）。

此镜像的构建版本可从Docker Hub或Github Container Registry拉取，标签如下：

"latest"、"stable"和"version"标签支持amd64、armv7和arm64的多架构，因此指定这些标签将拉取对应架构的正确版本。

请查阅Docker Hub或Github Container Registry获取此镜像的最新可用版本。

注册表

• Docker Hub: docker pull deconzcommunity/deconz:latest
• Github Container Registry: docker pull ghcr.io/deconz-community/deconz-docker:latest，更多信息见官方文档

运行deCONZ容器

前提条件

在运行创建deconz Docker容器的命令之前，可能需要将Linux用户添加到dialout组，以允许用户访问串口设备（如Conbee/Conbee II/RaspBee/RaspBeeII）：

bash
sudo usermod -a -G dialout $USER

对于Raspberry PI 4B上的RaspBee/Raspbee 2安装：确保Wiring Pi已更新到最新版本！

bash
sudo apt install wiringpi

命令行

bash
docker run -d \
    --name=deconz \
    --restart=always \
    -p 80:80 \
    -p 443:443 \
    -v /etc/localtime:/etc/localtime:ro \
    -v /opt/deconz:/opt/deCONZ \
    --device=/dev/ttyUSB0 \
    deconzcommunity/deconz

命令行选项

环境变量

使用以下环境变量可更改容器的默认行为。

Docker-Compose

此镜像GitHub仓库的根目录提供了完整的docker-compose.yml文件。您也可将以下内容复制粘贴到现有docker-compose.yml中，根据需要修改选项（省略version和services行，因为您的docker-compose.yml已包含这些）。

yaml
version: "2"
services:
  deconz:
    image: deconzcommunity/deconz
    container_name: deconz
    restart: always
    ports: 
      - 80:80
      - 443:443
    volumes:
      - /opt/deconz:/opt/deCONZ
    devices:
      - /dev/ttyUSB0
    environment:
      - DECONZ_WEB_PORT=80
      - DECONZ_WS_PORT=443
      - DEBUG_INFO=1
      - DEBUG_APS=0
      - DEBUG_ZCL=0
      - DEBUG_ZDP=0
      - DEBUG_OTAU=0

然后，可执行docker-compose pull拉取最新的deconzcommunity/deconz镜像，docker-compose up -d启动deconz容器服务，docker-compose down停止deconz服务并删除容器。注意，这些命令也会拉取、启动和停止docker-compose.yml中定义的其他服务。

在Docker for Mac / Docker for Windows上运行

Mac/Windows尚不支持--net=host选项。要在这些平台上运行此容器，请在run命令中显式指定端口并省略--net=host：

bash
docker run -d \
    --name=deconz \
    -p 80:80 \
    -p 443:443 \
    --restart=always \
    -v /opt/deconz:/opt/deCONZ \
    --device=/dev/ttyUSB0 \
    -e DECONZ_WEB_PORT=80 \
    -e DECONZ_WS_PORT=443 \
    deconzcommunity/deconz

为RaspBee配置Raspbian

Raspbian默认将蓝牙分配给/dev/ttyAMA0，并通过串口（tty）配置登录shell。必须禁用tty登录shell并启用串口硬件，同时将蓝牙交换到/dev/S0，以允许RaspBee在Docker下正常工作。

禁用串口登录shell并启用串口硬件：

1. sudo raspi-config
2. 选择Interfacing Options（接口选项）
3. 选择Serial（串口）
4. “是否希望通过串口访问登录shell？”选择No（否）
5. “是否希望启用串口硬件？”选择Yes（是）
6. 退出raspi-config并重启

将蓝牙交换到/dev/S0（将RaspBee移至/dev/ttyAMA0），运行以下命令并重启：

bash
echo 'dtoverlay=pi3-miniuart-bt' | sudo tee -a /boot/config.txt

运行上述命令并重启后，RaspBee应可在/dev/ttyAMA0访问。

更新Conbee/RaspBee固件

Web UI中的固件更新将静默失败。此Docker镜像提供了一个交互式实用脚本，可用于刷新设备固件。该脚本已在amd64 Debian Linux、armhf Raspbian Stretch（Conbee）和armhf Raspbian Stretch（RaspBee）上测试并验证可用。

但请注意，此固件刷新方式不保证一定有效。若有效，将加快整个过程；若无效，则需按照以下链接手动更新固件：

[***]

这可能需要将设备插入未运行Docker的其他系统（如Windows）。

该脚本调用刷新工具GCFFlasher_internal，将输出任何失败信息。在某些情况下，刷新工具运行成功但之后无法启动deCONZ（显示"disconnected device"）。此时，可多次尝试该过程或调整retries和timeout参数。

使用脚本更新固件，请按照以下说明操作：

1. 检查deCONZ容器日志中的更新固件文件名：

输入docker logs [容器名称]，查找日志开头附近如下行，记录列出的.GCF文件名（后续需要）：

GW update firmware found: /usr/share/deCONZ/firmware/deCONZ_Rpi_0x261e0500.bin.GCF
GW firmware version: 0x261c0500
GW firmware version shall be updated to: 0x261e0500

2. 停止运行中的deCONZ容器。必须执行此步骤，否则固件更新将失败：

bash
docker stop [容器名称]

或

bash
docker-compose down

3. 调用固件更新脚本：

bash
docker run -it --rm --entrypoint "/firmware-update.sh" --privileged --cap-add=ALL -v /dev:/dev -v /lib/modules:/lib/modules -v /sys:/sys deconzcommunity/deconz

若有多个USB设备，可映射对应Conbee/Raspbee的/dev/...卷以避免错误路径映射：

bash
docker run -it --rm --entrypoint "/firmware-update.sh" --privileged --cap-add=ALL -v /dev/serial/by-id/usb-dresden_elektronik_ingenieurtechnik_GmbH_ConBee_II_DExxxxxxx-if00:/dev/ttyACM0  -v /lib/modules:/lib/modules -v /sys:/sys deconzcommunity/deconz

也可在调用末尾添加其他选项：

bash
docker run ... deconzcommunity/deconz [option1] [value1] [option2] [value2] ...

若这些是刷新工具的有效选项，将添加到调用中：

请注意，脚本仍会询问设备和固件文件的值，但您的选项将作为默认值。

4. 按照提示操作：

• 输入列表中对应设备的路径（如/dev/ttyUSB0）。
• 输入或粘贴在步骤1中从deCONZ容器日志找到的完整文件名（或选择其他文件名，但需有充分理由）。 若有比Docker中包含的更新的固件文件（可在此处找到），可指定文件名，脚本将尝试下载。按照提示操作即可。
• 若设备/路径、文件名和列出的选项看起来正确，输入Y开始刷新！

5. 重启deCONZ容器：

bash
docker start [容器名称]

或

bash
docker-compose up

固件刷新脚本常见问题

问：为什么脚本提示无法卸载ftdi_sio和usbserial模块，或无法重置设备？

答：要刷新设备，系统上不能有其他程序或设备使用这些内核模块或设备。停止任何可能使用模块或设备的程序/容器（可能是deCONZ），然后再次调用脚本。若错误持续，可能需要暂时移除其他USB串口设备以允许脚本完全卸载内核模块。

问：为什么即使指定了更长的超时，刷新运行仍在几秒后失败？

答：设置超时允许刷新工具在超时时间内多次尝试运行，单次运行的超时时间无法通过参数更改。

通过VNC查看deCONZ ZigBee网格

将环境变量DECONZ_VNC_MODE设置为1可启用容器中的VNC服务器；使用VNC客户端连接到此VNC服务器以查看deCONZ ZigBee网格。环境变量DECONZ_VNC_PORT可控制VNC服务器监听的端口（默认5900）；环境