如何将Docker容器连接至主机上的MQTT Broker？

以下是针对连接拒绝错误的具体排查和解决步骤：

1. 确认Mosquitto Broker的绑定地址 #

默认情况下，Mosquitto可能仅绑定127.0.0.1（仅允许本地进程访问），导致Docker容器无法通过172.17.0.1连接。

• 编辑Mosquitto配置文件（通常路径为/etc/mosquitto/mosquitto.conf）
• 找到bind_address配置项，修改为bind_address 0.0.0.0（允许所有网络地址访问），或指定Docker网桥地址bind_address 172.17.0.1
• 重启Mosquitto服务：sudo systemctl restart mosquitto

2. 检查主机防火墙规则 #

主机防火墙可能拦截了1883端口的外部请求：

• 临时关闭防火墙测试连通性：
  • firewalld环境：sudo systemctl stop firewalld
  • ufw环境：sudo ufw disable
• 若测试有效，添加永久端口开放规则：
  • firewalld：sudo firewall-cmd --add-port=1883/tcp --permanent && sudo firewall-cmd --reload
  • ufw：sudo ufw allow 1883/tcp

3. 使用主机局域网IP替代网桥地址 #

如果自定义了Docker网桥，172.17.0.1可能无法指向主机，可直接使用主机的局域网IP：

• 查看主机局域网IP：ip addr show（找到对应网卡的inet字段地址，如192.168.1.100）
• 修改Python代码中的broker变量为该IP：broker = '192.168.1.100'

4. 可选：使用Docker Host网络模式 #

启动容器时指定--network host，让容器共享主机网络栈，此时代码中broker可直接设为127.0.0.1：

docker run --network host your-python-app-image

代码修复提示 #

你提供的Python代码存在一处调用错误：publish函数中client.publish(msg, qos=0)不符合MQTT API要求，第一个参数应为主题（topic），正确写法如下：

def publish(client):
    msg = "test"
    client.publish("test/topic", msg, qos=0)  # 补充主题参数
    print(f"Published message: {msg}")

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