Docker容器无法连接同一网络中另一个容器内的Mosquitto MQTT代理

问题核心原因 #

默认的mosquitto.conf配置中，MQTT代理仅绑定了127.0.0.1（localhost），导致只能在容器内部通过localhost访问，其他容器或外部无法通过容器IP/名称建立连接。同时启动时出现的Error: Cannot assign requested address错误，也是因为绑定localhost的配置在容器网络环境下的兼容性问题。

解决步骤 #

1. 修改Mosquitto配置文件
   打开mosquitto.conf（无配置文件则新建），添加或修改监听配置：

   listener 1883 0.0.0.0
   

   该配置让代理绑定容器的所有网络接口，允许外部（包括其他容器）发起连接。

2. 在Docker Compose中挂载配置文件
   更新你的docker-compose.yml，将本地修改后的配置文件挂载到容器内的默认配置路径：

   services:
     mosquitto:
       image: eclipse-mosquitto
       ports:
         - "1883:1883"
       volumes:
         - ./mosquitto.conf:/mosquitto/config/mosquitto.conf
   

3. 重启容器并验证

   • 重启Mosquitto容器：docker-compose restart mosquitto
   • 在容器内部测试跨IP访问：mosquitto_pub -h <容器IP> -t test -m "test_msg"
   • 其他容器中使用容器名称（比如mosquitto）作为MQTT服务器地址，即可正常建立连接。

补充说明 #

• expose指令仅用于声明容器开放的端口，不会完成端口映射，容器间通信无需依赖该指令；ports是用于宿主机访问容器端口的配置，保留即可。
• Docker Compose默认会将所有服务加入同一个bridge网络，容器间可以直接通过服务名称（容器名称）互相访问，无需额外配置网络。

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