mc303/zigbee2mqtt-socat Docker 镜像 - 轩辕镜像 | Docker 镜像高效稳定拉取服务

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的所有选项外，新增以下专用配置参数：

基础配置选项

Socat配置选项

部署示例

主机系统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

问题反馈

请在GitHub上报告问题。

致谢

• 基于peterforeman/deconz-socat镜像构建
• 基于koenkk/zigbee2mqtt镜像构建
• 参考vladbabii/homeassistant-socat