Docker容器中OPC UA服务器绑定主机IP无法连接的解决方法

核心问题分析 #

你将OPC Server的ServerConfiguration.BaseAddresses直接设为主机IP，但容器通过端口映射（非主机网络模式）运行时，容器内的Server实际只能监听自身的网络接口，无法直接绑定宿主机IP。UA Expert通过宿主机IP发起连接时，容器内的Server并未在该地址上监听，导致握手失败。

具体修复步骤 #

• 调整OPC Server的监听地址配置
  将ServerConfiguration.BaseAddresses改为绑定容器的所有网络接口，确保端口映射能正常转发流量：

  ServerConfiguration.BaseAddresses = "opc.tcp://0.0.0.0:4840/OPCUA/abb";
  

  这样Server会监听容器内的所有可用接口，配合端口映射就能接收来自宿主机的连接请求。

• 确认容器端口映射的正确性
  启动容器时必须明确映射端口，确保宿主机4840端口指向容器内的4840端口：

  docker run -p 4840:4840 <你的镜像名称>
  

  同时检查宿主机的4840端口是否被其他进程占用，可用netstat -ano | findstr :4840（Windows）或ss -tulpn | grep 4840（Linux）排查。

• 验证容器内端口监听状态
  进入容器内部，确认Server已正确监听4840端口：

  docker exec -it <容器ID> ss -tulpn | grep 4840
  

  输出中若显示0.0.0.0:4840的监听记录，说明配置生效。

• 处理端点地址一致性校验问题
  部分OPC UA客户端（如UA Expert）会校验连接URL与Server返回的端点列表是否匹配。若遇到此类错误，可在UA Expert的连接设置中关闭端点地址校验，或在Server配置中添加宿主机IP作为备用端点地址。

额外排查点 #

• 检查宿主机防火墙是否允许4840端口的入站流量，避免防火墙阻断连接。
• 若跨网络访问，确认宿主机所在网络的路由规则允许外部设备访问该IP和端口。

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