Ubuntu 18.04下Mosquitto 2.0.7配自签名SSL连接报协议错误排查
Mosquitto 2.0.7 版本SSL连接报「Client disconnected due to protocol error」的排查修正
问题根因
该报错并非证书本身失效导致,核心是Mosquitto 2.0.x与1.4.x版本在SSL/TLS模块的默认配置规则存在本质差异,直接套用旧版本配置必然触发握手失败,具体差异点包括:
- 2.0版本对加载了
certfile/keyfile的SSL监听端口,默认开启强制双向客户端证书校验,而1.4版本默认仅做单向服务端证书校验 - 2.0版本默认支持TLS 1.3协议协商,配套OpenSSL 1.1.1会对证书的扩展密钥用法字段做严格校验,旧版本生成的自签名证书(为1.4版本环境适配)缺少TLS 1.3要求的扩展字段,会直接在握手阶段被判定为非法,抛出协议错误
- 2.0版本要求必须显式配置
cafile路径完成信任链校验,即使是自签名证书,缺少该配置时服务端无法完成证书合法性校验,会直接切断连接 - 现有配置中写的
#tlv_version tlsv1.2存在参数名拼写错误,正确参数为tls_version,该行因被注释未生效,也进一步触发了默认TLS 1.3的协商流程
配置修正步骤
- 调整conf.d目录下的
mosquitto_local.conf配置,替换为如下可正常兼容的生效内容:listener 8883 # 对齐1.4版本默认行为,关闭强制双向客户端证书校验 require_certificate false # 指定自签名根证书路径,完成信任链校验配置 cafile /etc/mosquitto/certs/ca.crt # 锁定TLS 1.2版本,避开TLS1.3对旧自签名证书的严格校验 tls_version tlsv1.2 certfile /etc/mosquitto/certs/mqtt.crt keyfile /etc/mosquitto/certs/mqtt.key allow_anonymous true - 调整mosquitto_pub的连接命令,原命令缺少CA信任配置,正确基础连接命令为:
若不需要双向客户端证书校验,原命令中携带的mosquitto_pub -h localhost -p 8883 --cafile /etc/mosquitto/certs/ca.crt -t testtopic -m "hi"--cert、--key参数无实际作用;若必须保留双向校验要求,需确认客户端证书的签发主体与cafile指定的根证书完全一致。 - 校验证书文件权限:确认mosquitto服务运行用户对
/etc/mosquitto/certs/目录下的ca.crt、mqtt.crt、mqtt.key文件拥有读取权限,权限不足会导致服务端无法正常加载证书,外部表现同样为协议错误断开。
为什么相同配置在1.4版本可正常运行
- Mosquitto 1.4版本默认
require_certificate false,最高仅支持TLS 1.2协议,对自签名证书的扩展字段无严格校验要求,也不需要显式配置cafile路径即可完成单向SSL握手 - 2.0版本从设计层面提升了SSL模块的安全默认值,与1.4版本的配置逻辑完全不向后兼容,直接复用旧版本的配置文件是触发报错的核心原因
内容的提问来源于stack exchange,提问作者karthik bulusu
相关产品推荐
相关产品推荐

