tiagocoutinho/modbus-proxy

Modbus TCP 代理

镜像概述和主要用途

许多Modbus设备仅支持一个或极少数客户端。本代理作为客户端与Modbus设备之间的桥梁，可视为七层反向代理，允许多个客户端与同一Modbus设备通信。当多个客户端连接时，通过先到先服务的REQ/REP方式序列化通信，避免交叉消息冲突。

核心功能和特性

• 作为七层反向代理，实现Modbus设备与多客户端的连接桥接
• 支持多个并发客户端同时访问单个Modbus设备
• 通过先到先服务的REQ/REP机制序列化通信，防止交叉消息干扰
• 支持YAML（.yml或.yaml）和TOML（.toml）两种配置文件格式
• 可同时配置和管理多个Modbus设备，每个设备独立监听端口

使用场景和适用范围

适用于工业自动化、楼宇控制等需要多个客户端同时访问Modbus设备的场景，尤其适合解决PLC、传感器等Modbus设备客户端连接数量受限的问题。

使用方法和配置说明

配置文件编写

需创建配置文件，为每个Modbus设备指定以下信息：

• Modbus连接信息（设备URL）
• 监听接口（客户端连接的URL）

YAML配置示例

若PLC设备监听于plc1.acme.org:502，希望客户端通过主机9000端口连接，YAML配置如下：

yaml
devices:
- modbus:
    url: plc1.acme.org:502
  listen:
    bind: 0:502

启动容器

默认镜像运行命令为modbus-proxy-rs -c /etc/modbus-proxy.yml（ENTRYPOINT为["modbus-proxy-rs"]，CMD为["-c", "/etc/modbus-proxy.yml"]）。

基本启动命令：

bash
docker run -d -p 5020:502 -v $PWD/config.yml:/etc/modbus-proxy.yml docker.xuanyuan.run/tiagocoutinho/modbus-proxy

参数说明：

• -p 5020:502：将主机5020端口映射到容器502端口（客户端通过主机5020端口连接）
• -v $PWD/config.yml:/etc/modbus-proxy.yml：挂载本地配置文件到容器内默认配置路径

多设备配置

支持同时配置多个Modbus设备，示例配置：

yaml
devices:
- modbus:
    url: plc1.acme.org:502
  listen:
    bind: 0:502
- modbus:
    url: plc2.acme.org:502
  listen:
    bind: 0:503

多设备启动命令（需为每个设备端口添加映射）：

bash
docker run -d -p 5020:502 -p 5030:503 -v $PWD/config.yml:/etc/modbus-proxy.yml docker.xuanyuan.run/tiagocoutinho/modbus-proxy

日志设置

通过RUST_LOG环境变量调整日志级别（默认级别为warn）：

bash
docker run -d -p 5020:502 -v $PWD/config.yml:/etc/modbus-proxy.yml -e RUST_LOG=debug docker.xuanyuan.run/tiagocoutinho/modbus-proxy

日志级别可设置为：trace、debug、info、warn、error。