samsonnguyen/homeassistant-socat

Home Assistant with socat 远程Zwave设备映射镜像

镜像概述

本镜像基于官方Home Assistant镜像构建，集成socat工具，可将通过ser2net网络映射的远程Zwave设备（如USB串口设备）转换为本地设备，供Home Assistant直接使用。同时，镜像会自动监控socat和Home Assistant进程状态，若发生故障则重启，确保服务稳定运行。

核心功能

1. 远程设备映射：通过socat将网络端的Zwave设备（如tcp连接）映射为本地串口设备。
2. 进程自动恢复：当socat或Home Assistant进程异常退出时，自动重启相关进程。
3. 兼容原配置：保留官方Home Assistant镜像的所有环境变量和配置选项。

使用场景

适用于智能家居系统中，Zwave设备不在Home Assistant所在本地网络或物理位置（如跨房间、远程场所），需要通过网络连接到Home Assistant进行管理的场景。

配置说明

环境变量

除官方Home Assistant镜像的所有选项外，新增以下变量：

• DEBUG_VERBOSE：设置为1开启详细日志，默认0。
• PAUSE_BETWEEN_CHECKS：进程状态检查间隔（秒），默认2。
• LOG_TARGET：日志文件路径，留空则输出到stdout，默认stdout。
• SOCAT_ZWAVE_TYPE：连接类型（如tcp），默认"tcp"。
• SOCAT_ZWAVE_HOST：远程设备所在主机IP，例如"192.168.5.5"。
• SOCAT_ZWAVE_PORT：远程设备端口，例如"7676"。
• SOCAT_ZWAVE_LINK：本地映射的设备路径，例如"/dev/zwave"（需在Home Assistant配置中使用此路径）。

部署示例

Docker Run命令

bash
docker run -d \
  --name homeassistant-socat \
  -e SOCAT_ZWAVE_HOST="192.168.5.5" \
  -e SOCAT_ZWAVE_PORT="7676" \
  -e SOCAT_ZWAVE_LINK="/dev/zwave" \
  -v /path/to/your/homeassistant/config:/config \
  --device=/dev/zwave:/dev/zwave \
  docker.xuanyuan.run/samsonnguyen/homeassistant-socat

Docker Compose配置

yaml
version: '3'
services:
  homeassistant-socat:
    image: samsonnguyen/homeassistant-socat
    container_name: homeassistant-socat
    environment:
      - SOCAT_ZWAVE_HOST=192.168.5.5
      - SOCAT_ZWAVE_PORT=7676
      - SOCAT_ZWAVE_LINK=/dev/zwave
    volumes:
      - /path/to/your/config:/config
    devices:
      - /dev/zwave:/dev/zwave
    restart: unless-stopped