求Docker多MODBUS客户端/服务端容器免硬编码IP的可扩展网络配置及运行慢解决方案

一、先解决启动等待10分钟的通信延迟问题 #

你遇到的启动后等待10分钟才输出数据的问题，不是Docker网络速度慢导致的，是几个配置和代码错误叠加出来的：

• 服务端监听地址错误：原代码里把Modbus服务绑定到了localhost，这个地址在容器环境里仅代表容器自身的回环接口，同网络下其他容器发来的连接请求根本进不来。客户端发起连接后会触发pyModbusTCP默认的300秒超时机制，连续两次连接超时刚好凑够10分钟的等待时长。
• 代码语法错误：原Server.py中server.start()行的缩进多了一层，正常情况下Python解释器会直接抛出语法错误终止进程，能跑起来大概率是你手动临时调整过缩进，运行状态本身就不稳定。
• 手动指定静态IP的配置容易引发IP冲突，进一步拉长连接重试的等待时间。

二、零硬编码IP的可扩展实现 #

Docker自定义桥接网络本身就内置了服务发现能力，只要所有容器接入同一个自定义桥接网络，容器之间可以直接通过服务名互相访问，完全不需要手动分配静态IP。你之前尝试用环境变量传值没成功，本质是没利用好这个内置能力。

1. 代码修正 #

服务端代码调整

核心改两个点：把监听地址从localhost换成0.0.0.0，允许外部流量接入；修正缩进语法错误，调整后的核心代码如下：

from pyModbusTCP.server import ModbusServer, DataBank
from time import sleep
from random import uniform

# 监听所有网卡地址，而非仅回环接口
server = ModbusServer('0.0.0.0', 502, no_block=True)
DataBank.set_words(0, [80])

try:
    print("Start server...")
    server.start()
    print("Server is online...")
    while True:
        DataBank.set_words(0, [int(uniform(0,100))])
        DataBank.set_words(1, [int(uniform(0,100))])
        DataBank.set_words(2, [int(uniform(0,100))])
        DataBank.set_words(3, [int(uniform(0,100))])
        sleep(5)
except:
    print("Shutdown server....")
    server.stop()
    print("Server is offline...")
    sleep(0.5)

客户端代码调整

把硬编码的服务端IP换成从环境变量读取，同时缩短连接超时时间，避免一次失败就等5分钟，调整后的核心代码如下：

from pyModbusTCP.client import ModbusClient
import os
import time    

# 从环境变量读取配置，设置默认值兜底
SERVER_HOST = os.getenv("MODBUS_SERVER_HOST", "server")
SERVER_PORT = int(os.getenv("MODBUS_SERVER_PORT", 502))

c = ModbusClient()
c.host(SERVER_HOST)
c.port(SERVER_PORT)
# 把连接超时从默认300秒缩到5秒，加快重试速度
c.timeout(5)

while True:
    if not c.is_open():
        if not c.open():
            print(f"Unable to connect to Server at {SERVER_HOST}:{SERVER_PORT}")
        time.sleep(1)
    if c.is_open():
        regs = c.read_holding_registers(0, 4)
        if regs:
            print("Register #0: " + str(regs[0]))
            print("Register #1: " + str(regs[1]))
            print("Register #2: " + str(regs[2]))
            print("Register #3: " + str(regs[3]))
    time.sleep(5)

2. Docker Compose配置修正 #

去掉所有手动指定静态IP的配置，利用内置的服务发现能力，同时支持任意规模的容器扩展，调整后的配置如下：

version: '3.8'
services:
  server:
    build: ./server
    image: modbus-server
    restart: always
    networks:
      - modbus_net

  client:
    build: ./client
    image: modbus-client
    restart: always
    environment:
      # 直接把服务名作为主机名传给客户端，Docker内部DNS会自动解析成对应容器的IP
      MODBUS_SERVER_HOST: server
      MODBUS_SERVER_PORT: 502
    depends_on:
      - server
    networks:
      - modbus_net

networks:
  modbus_net:
    driver: bridge

3. 扩展方式 #

• 如果需要启动10个甚至更多客户端，不需要修改任何配置，直接执行docker-compose up --scale client=10即可，所有客户端会自动通过服务名发现机制连到同一个Modbus服务端，全程不需要手动分配IP。
• 如果需要部署多个服务端，只需要在compose配置里新增一个服务条目，客户端通过环境变量指定对应的服务名就能完成连接，不管服务端容器怎么重启、IP怎么变化，DNS解析都会自动同步最新地址，不需要手动维护IP映射。

三、关于Docker Swarm的补充说明 #

如果后续需要跨多台物理机扩展集群规模，Docker Swarm同样不需要手动分配静态IP：Swarm集群内置的Ingress网络会自动管理服务发现、IP分配、流量转发逻辑，你只需要指定服务名和端口配置即可，完全不需要关心底层容器的运行节点和实际IP地址。

之前你尝试用环境变量传IP没生效，本质是两个常见踩坑：

• 没有使用自定义桥接网络：Docker默认的公共bridge网络没有内置DNS服务发现能力，只有自定义桥接网络才支持通过服务名互相解析。
• 传值逻辑错误：就算用环境变量传硬编码IP，后续容器重启IP变更后还是要重新修改配置，直接传服务名作为主机名，才能实现和IP解耦的效果。

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