john30/ebusd

ebusd Docker镜像

镜像概述和主要用途

ebusd Docker镜像是基于https://github.com/john30/ebusd/%E9%A1%B9%E7%9B%AE%E7%9A%84%E5%AE%B9%E5%99%A8%E5%8C%96%E9%83%A8%E7%BD%B2%E6%96%B9%E6%A1%88%EF%BC%8C%E5%8F%AF%E4%BB%8Ehttps://hub.docker.com/r/john30/ebusd/%E8%8E%B7%E5%8F%96%E3%80%82%E8%AF%A5%E9%95%9C%E5%83%8F%E8%83%BD%E8%87%AA%E5%8A%A8%E4%B8%8B%E8%BD%BD%E6%9C%80%E6%96%B0%E5%BE%B7%E5%9B%BD%E9%85%8D%E7%BD%AE%E6%96%87%E4%BB%B6%EF%BC%8C%E6%97%A0%E9%9C%80%E5%9C%A8%E7%B3%BB%E7%BB%9F%E4%B8%AD%E5%AE%89%E8%A3%85%E6%88%96%E6%9E%84%E5%BB%BAebusd%E5%8D%B3%E5%8F%AF%E8%BF%90%E8%A1%8C%EF%BC%8C%E6%94%AF%E6%8C%81%E9%9D%9ELinux%E7%B3%BB%E7%BB%9F%E5%A6%82Synology Diskstation和Windows Docker Desktop环境。

核心功能和特性

• 跨架构支持：自动适配amd64、i386、arm32v7、arm64v8架构
• 配置自动获取：从专用服务下载最新https://github.com/john30/ebusd-configuration/
• 灵活部署：支持串行设备和网络设备连接
• 后台/交互式运行：可根据需求选择运行模式
• MQTT集成：支持连接MQTT代理实现数据转发
• 环境变量配置：支持通过环境变量传递参数，简化部署

获取镜像

最新发布版

bash
docker pull john30/ebusd

开发版

bash
docker pull john30/ebusd:devel

使用方法

交互式运行

适用于测试和调试，直接在终端显示输出：

bash
docker run --rm -it --device=/dev/ttyUSB1:/dev/ttyUSB0 -p 8888 john30/ebusd

说明：--device参数将主机的/dev/ttyUSB1映射到容器内的/dev/ttyUSB0，-p 8888映射端口

后台运行

创建名为"ebusd"的后台容器：

bash
docker run -d --name=ebusd --device=/dev/ttyUSB1:/dev/ttyUSB0 -p 8888 john30/ebusd

查看运行日志：

bash
docker logs ebusd

使用网络设备

连接网络设备时无需--device参数，直接通过参数指定设备信息：

bash
docker run --rm -it -p 8888 john30/ebusd --scanconfig -d 192.168.178.123:10000 --latency=20

注意：

• "-f"（前台）参数通过环境变量自动传递，无需手动指定
• 仅在无附加参数时默认启用--scanconfig，传递其他参数时需显式添加或设置EBUSD_SCANCONFIG环境变量

与MQTT代理集成

后台运行并连接MQTT代理（替换BROKERHOST为实际代理地址）：

bash
docker run -d --name=ebusd --device=/dev/ttyUSB0 -p 8888 john30/ebusd --scanconfig -d /dev/ttyUSB0 --mqttport=1883 --mqtthost=BROKERHOST

环境变量配置

支持通过EBUSD_前缀的环境变量传递参数，替代命令行参数：

bash
docker run -d --name=ebusd --device=/dev/ttyUSB0 -p 8888 \
  -e EBUSD_SCANCONFIG= \
  -e EBUSD_DEVICE=/dev/ttyUSB0 \
  -e EBUSD_MQTTPORT=1883 \
  -e EBUSD_MQTTHOST=BROKERHOST \
  john30/ebusd

说明：此方式特别适合docker-compose等场景，简化配置管理

参数说明