Docker部署Telegraf时inputs.mqtt_consumer连接失败求助

核心原因 #

Docker容器的localhost/127.0.0.1指向容器自身网络栈，而非宿主机或其他容器，这是导致连接被拒绝的根本原因。

分场景解决方案 #

场景1：Mosquitto在宿主机上运行（非Docker容器） #

• 修改Telegraf配置文件中的MQTT服务器地址：

  [[inputs.mqtt_consumer]]
  servers = ["tcp://host.docker.internal:1883"]
  topics = ["#"]
  data_format = "json"
  

• 启动Telegraf容器时，需添加参数让容器能解析host.docker.internal到宿主机IP（Linux环境需手动指定）：

  docker run -d \
    --name telegraf \
    --add-host host.docker.internal:host-gateway \
    -v /本地配置文件路径/telegraf.conf:/etc/telegraf/telegraf.conf \
    telegraf
  

场景2：Mosquitto以Docker容器运行 #

• 第一步：统一Docker网络
  确保Telegraf和Mosquitto处于同一个Docker自定义网络（比默认bridge网络更稳定）：

  # 创建自定义网络
  docker network create mqtt-telegraf-net
  # 重启Mosquitto并加入该网络
  docker run -d \
    --name mosquitto \
    --network mqtt-telegraf-net \
    eclipse-mosquitto
  

• 第二步：修改Telegraf配置
  用Mosquitto容器的名称作为MQTT服务器地址：

  [[inputs.mqtt_consumer]]
  servers = ["tcp://mosquitto:1883"]
  topics = ["#"]
  data_format = "json"
  

• 第三步：启动Telegraf容器
  加入同一个自定义网络：

  docker run -d \
    --name telegraf \
    --network mqtt-telegraf-net \
    -v /本地配置文件路径/telegraf.conf:/etc/telegraf/telegraf.conf \
    telegraf
  

通用检查项 #

• 确认Mosquitto允许外部连接：修改mosquitto.conf，设置监听地址为0.0.0.0（而非仅127.0.0.1）：

  listener 1883 0.0.0.0
  

• 进入Telegraf容器验证网络连通性：

  # 场景1验证命令
  docker exec -it telegraf ping host.docker.internal
  # 场景2验证命令
  docker exec -it telegraf ping mosquitto
  

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