Mosquitto MQTT Docker容器拒绝连接问题排查

你使用以下命令启动Mosquitto MQTT Docker容器：

docker run -it -p 1883:1883 -p 9001:9001 eclipse-mosquitto

启动日志如下：

1686127493: mosquitto version 2.0.15 starting
1686127493: Config loaded from /mosquitto/config/mosquitto.conf.
1686127493: Starting in local only mode. Connections will only be possible from clients running on this machine.
1686127493: Create a configuration file which defines a listener to allow remote access.
1686127493: For more details see https://mosquitto.org/documentation/authentication-methods/
1686127493: Opening ipv4 listen socket on port 1883.
1686127493: Opening ipv6 listen socket on port 1883.
1686127493: Error: Address not available
1686127493: mosquitto version 2.0.15 running

容器内找到的mosquitto-no-auth.conf配置内容：

listener 1883
allow_anonymous true

尽管该配置已允许匿名访问，但客户端连接仍被拒绝，可能的原因如下：

• 未加载正确的配置文件：从启动日志可见，当前加载的是/mosquitto/config/mosquitto.conf，而非你找到的mosquitto-no-auth.conf。默认配置处于本地仅访问模式，会拒绝外部连接，需要启动容器时指定加载这个允许匿名的配置文件。
• IPv6监听失败的连锁影响：日志中出现Error: Address not available，说明容器尝试监听IPv6的1883端口失败。部分环境下，IPv6配置异常可能导致IPv4监听受影响，或客户端尝试通过IPv6连接时被阻断。可以在配置里明确指定监听IPv4地址，比如改成listener 1883 0.0.0.0。
• 端口映射未生效：虽然启动时添加了-p 1883:1883，但需确认宿主机1883端口是否被其他进程占用，或Docker端口映射规则是否正常生效。可通过netstat -tulpn | grep 1883检查宿主机端口状态。
• 网络层面限制：若Docker使用默认桥接网络，需确认客户端所在网络能访问宿主机IP；或容器是否配置了错误的网络模式（比如host模式但端口冲突）。另外，宿主机的防火墙/安全组是否放行1883端口，也是常见的阻断原因。
• 客户端连接参数错误：客户端可能使用了错误的连接地址（比如用容器内部IP而非宿主机IP）、填错端口号，或MQTT协议版本不兼容（比如容器用MQTT 3.1.1，客户端用5.0且未适配）。

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