mc303/zigbee2mqtt-socat

该Docker镜像结合socat和zigbee2mqtt，支持通过网络映射的串行设备（替代本地Zigbee设备）运行zigbee2mqtt，自动监控并重启失败的socat和zigbee2mqtt进程，确保稳定运行。

0 次下载activemc303镜像

zigbee2mqtt-socat Docker镜像文档

镜像概述

本镜像基于peterforeman/deconz-socat修改，将原项目更改为zigbee2mqtt-socat并使用最新分支。其主要用途是允许通过网络映射的串行设备（而非本地连接的Zigbee设备如USB加密狗/CC2531）运行zigbee2mqtt，通过ser2net或socat将网络串行设备映射为本地Zigbee串行设备。

核心功能与特性

同时运行socat和zigbee2mqtt服务
实时监控进程状态，若socat或zigbee2mqtt发生故障自动重启
完全兼容koenkk/zigbee2mqtt镜像的所有配置选项
额外提供进程监控、日志管理和网络串行设备连接的专用配置参数
支持多架构部署

使用场景

适用于以下场景：

需要远程连接Zigbee设备（如通过网络映射的串行设备）
无法直接连接本地USB Zigbee适配器（设备位于远程主机）
需确保Zigbee服务高可用性，自动恢复故障进程的场景

详细使用方法

前提条件

请参考标准zigbee2mqtt Docker容器文档的系统要求。

安装与配置

容器需配置额外参数以支持网络串行设备连接。除支持koenkk/zigbee2mqtt的所有选项外，新增以下专用配置参数：

基础配置选项

环境变量	说明	默认值
DEBUG_VERBOSE	设置为1启用详细日志输出	0
PAUSE_BETWEEN_CHECKS	进程状态检查间隔时间（秒）	2
LOG_TARGET	日志文件路径，省略则输出到stdout	stdout

Socat配置选项

环境变量	说明	默认值
SOCAT_ZIGBEE_TYPE	网络连接类型	"tcp"
SOCAT_ZIGBEE_HOST	远程串行设备主机地址	"192.168.5.5"
SOCAT_ZIGBEE_PORT	远程串行设备端口	"7676"
SOCAT_ZIGBEE_LINK	本地映射的Zigbee设备路径，需在zigbee2mqtt配置中使用	"/dev/zigbee"

部署示例

主机系统socat服务配置

在远程主机上运行socat以共享Zigbee设备：

bash
/usr/bin/socat /dev/zigbee,b***,rawer,echo=0 tcp-listen:7677,reuseaddr,su=nobody

systemd服务配置（Debian系统）

创建/etc/systemd/system/zigbee.service文件以持久化运行socat：

ini
[Unit]
Description=zigbee socat
After=network.target auditd.service

[Service]
ExecStart=/usr/bin/socat /dev/zigbee,b***,rawer,echo=0 tcp-listen:7677,reuseaddr,su=nobody
ExecReload=/bin/kill -HUP $MAINPID
KillMode=process
Restart=always
Type=simple

[Install]
WantedBy=multi-user.target
Alias=zigbee.service