Paho JS客户端连接启用TLS的Mosquitto Websockets端口报错求助

1. 配置文件修正 #

你当前的Websocket监听器未显式绑定TLS配置，即使全局配置了证书路径也不会对8081端口生效，按如下修改配置：

listener 8081
protocol websockets
http_dir /var/www/html
require_certificate false
keyfile /etc/mosquitto/certs/mqtt-server.key
certfile /etc/mosquitto/certs/mqtt-server.crt
cafile /etc/mosquitto/ca_certificates/mosquitto-certificate-authority.crt
# 新增：指定支持的TLS版本，避免兼容问题
tls_version tlsv1.2 tlsv1.3

修改后重启Mosquitto服务生效。

2. 网络与证书校验 #

• 确认服务器防火墙、安全组已开放8081端口的入站规则
• 注意：你使用的是自签证书，必须将CA根证书导入到客户端操作系统/浏览器的信任根证书列表，否则浏览器会默认拦截WSS连接
• 证书生成时填写的Common Name必须和你连接时使用的域名完全一致，不能用IP地址连接，否则会触发证书域名不匹配错误

3. 前端连接参数检查 #

使用Paho MQTT JS库连接时，参数要和服务端配置匹配：

• 连接地址格式为wss://<你的域名>:8081，不要写错协议头
• 用户名密码要和/etc/mosquitto/passwd中配置的信息一致

4. Nginx配置检查 #

如果测试页面部署在Nginx上，且WSS流量经过Nginx转发，需要添加Websocket专用代理配置：

location /mqtt {
    proxy_pass http://127.0.0.1:8081;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
    proxy_set_header Host $host;
    proxy_read_timeout 86400;
}

如果使用Nginx做SSL卸载，可将证书配置在Nginx侧，Mosquitto侧的Websocket监听器只需使用ws协议即可，无需额外配置证书。

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