PLC4x打包为Docker容器后连接PLC超时问题求助

排查步骤 #

• 基础网络连通性校验
  进入运行中的容器执行ping 10.250.46.28确认IP路由可达，再执行nc -zv 10.250.46.28 102（S7协议默认服务端口）验证端口连通性。最高发诱因是PLC侧配置了IP白名单，Docker容器默认走网桥出口IP和宿主机IP不一致，会被PLC直接丢包，表现为连接超时。
• 网络栈适配校验
  启动容器时追加--net=host参数复用宿主机网络栈测试，如果此时连接正常，即可确认是Docker虚拟网络隔离导致的驱动适配问题。PLC4X 0.9.1版本的S7驱动默认会探测主机网卡信息生成握手报文，容器内的虚拟网卡命名、网段规则和宿主机差异较大，会导致握手报文格式不符合PLC预期。
• 环境一致性校验
  检查容器内时区配置，部分S7型号PLC会校验握手报文中的时间戳，容器默认UTC时区如果和PLC侧时区差超过阈值，会直接丢弃握手请求不返回响应，表现为连接超时。

可行解决方案 #

• 网络层修复
  对网络隔离要求不高的场景直接在启动容器时加--net=host参数，容器完全复用宿主机网络栈，和直接在宿主机执行Java命令的网络环境完全一致，可快速恢复连通。
  需要做网络隔离的场景，给Docker配置macvlan网络，给业务容器分配和PLC同网段的独立IP，将该IP加入PLC白名单即可。
• 驱动参数适配
  不使用host网络的场景，在S7连接串中追加参数关闭自动网卡探测，手动指定PLC型号参数，示例启动命令：

  java -jar plc4j-datacare-plc4x-0.9.1-uber-jar.jar --connection-string 's7://10.250.46.28?s7-use-single-rack-slot=true&s7-controller-type=S7_1500' --field-addresses '%DB67:10:INT[1]'
  

  其中s7-controller-type根据实际对接的PLC型号调整，可选值包括S7_300、S7_400、S7_1200、S7_1500。
• 容器环境统一
  构建Docker镜像时在Dockerfile中明确指定时区，和PLC侧配置保持一致，示例配置：

  ENV TZ=Asia/Shanghai
  RUN ln -snf /usr/share/zoneinfo/$TZ /etc/localtime && echo $TZ > /etc/timezone
  

快速定位技巧 #

调整配置后可在容器内安装tcpdump，抓取102端口的双向流量：如果能看到容器发出的握手请求但收不到PLC回包，优先排查白名单、防火墙、路由问题；如果能收到PLC回包但还是报超时，优先排查驱动参数、时区匹配问题。

内容的提问来源于stack exchange，提问作者Pet