Eclipse Mosquitto 1.6.2 安全与缺陷修复版本解析:Will 消息内存安全、$SYS 消息保留与 -L URL 解析

原创2026-09-27 11:43:342,298 阅读
文章标签:物联网消息队列后端

Eclipse Mosquitto 1.6.2 安全与缺陷修复版本解析:Will 消息内存安全、$SYS 消息保留与 -L URL 解析

本指南基于当前仓库中 1.6.2 版本发布公告(version-1-6-2-released.md)及其源码实现,系统梳理该安全修复版本中每一项修复的触发场景、根因与验证方式。读完本文,你将理解 MQTT v5 Will 消息属性解析的内存安全缺陷为何会导致 broker 崩溃、check_retain_source 与 $SYS 保留消息的交互机制,以及客户端 -L URL 参数的完整解析规则,并能据此评估自身部署是否需要升级。

版本定位:一次安全与缺陷修复版本

Eclipse Mosquitto 1.6.2 于 2019 年 4 月 30 日发布,官方公告将其明确定位为 security and bugfix release(安全与缺陷修复版本),不包含新功能,而是集中修复 1.6 系列中暴露出的 1 项安全缺陷与 6 项功能缺陷。修复范围横跨 broker、客户端库(libmosquitto)与命令行客户端(mosquitto_pub / mosquitto_sub / mosquitto_rr)三个层面,分别对应公告中记录的 5 个问题单(#1244、#1245、#1246、#1248、#1250)。

  • Broker:4 项修复,含 1 项安全相关修复;
  • Library(libmosquitto):1 项崩溃修复;
  • Clients:1 项 -L URL 解析修复。

安全修复:MQTT v5 Will 消息属性导致的内存释放后访问

这是 1.6.2 版本中唯一被归入 Security 类别的修复,也是本次发布最重要的内容。

触发条件

公告给出的精确触发条件为:

如果一个客户端使用 MQTT v5 连接,携带了带 MQTT v5 属性的 Will 消息,且 Will 消息的第一个属性是 content-type、correlation-data、payload-format-indicator 或 response-topic 其中之一,那么当该客户端断开连接时,broker 会尝试从已释放的内存中读取数据,可能导致崩溃。

注意两个关键限定词:"MQTT v5 客户端"(MQTT v3.1.1 的 Will 消息不携带属性,不受影响)与 "第一个 Will 属性"(只有属性列表的首项命中这四种属性之一才会触发,而非任意位置)。

底层机制:Will 属性如何进入 broker

Will 消息(遗嘱消息)由客户端在 CONNECT 报文中携带,当连接异常断开(如网络中断、客户端异常退出)时由 broker 代为发布。在客户端库一侧,Will 属性通过 mosquitto_will_set_v5() 设置,其核心实现位于 will_mosq.c 的 will__set():

  • 属性列表传入后,先由 mosquitto_property_check_command(CMD_WILL, ...) 对每一个属性做命令合法性校验(will_mosq.c);
  • 校验通过后,Will 及其属性链表被整体存入 mosq->will 结构;
  • 当连接建立时,这些属性随 CONNECT 报文发送给 broker,broker 在 handle_connect.c 中解析并保存。

content-type、correlation-data、payload-format-indicator、response-topic 这四种属性在 property_mosq.c 中由 mosquitto_property_check_command() 明确允许用于 CMD_PUBLISH 和 CMD_WILL 两类报文,属于 Will 的合法属性,因此正常连接时校验无法拦截该场景。

缺陷本质:断开时读取已释放的属性内存

公告指出缺陷发生在 "客户端断开连接、broker 准备发布 Will 消息" 的时点。结合 handle_disconnect.c 的流程可以看到,客户端断开时 broker 进入 mosq_cs_disconnect_with_will 状态并触发 Will 发布;1.6.2 之前的实现中,当 Will 属性链表的首元素恰为上述四种属性之一时,broker 在解析/转发属性过程中访问了一块已被释放(free 之后)的内存,造成 use-after-free,轻则行为异常,重则直接崩溃(segfault)。

这也是典型的 MQTT v5 新特性(属性化 Will)引入的边界缺陷:属性列表的内存生命周期与 Will 消息发布时机的管理不一致。修复后的行为是确保 Will 属性在发布完成前始终持有有效内存。

受影响面与升级建议

  • 仅影响 MQTT v5 协议连接,v3.1.1 客户端不受影响;
  • 需要客户端在 CONNECT 中携带带属性的 Will,且首个属性命中四种属性之一;
  • 建议所有运行 1.6.x 早期版本的部署升级到 1.6.2 或更高版本(当前仓库源码已包含该修复,后续版本持续受益)。

Broker 修复详解

修复一:Will 消息恢复对 user-property 属性的支持

除上述安全缺陷外,1.6.2 修复了 Will 消息不允许携带 user-property 属性的问题。MQTT v5 规范中 user-property 是应用最广泛的通用属性,允许出现在大多数报文中,包括 Will。修复前 broker 在解析带 user-property 的 Will 时错误拒绝或丢弃;修复后,user-property 与其余合法 Will 属性(如 property_mosq.c 中列出的 payload 格式指示器、消息过期间隔、响应主题、关联数据、遗嘱延迟间隔 will-delay-interval 等)均可正常随遗嘱消息发布。

修复二:check_retain_source=true 时 broker 自产消息不再被拦截

问题单 #1245 涉及两个关联缺陷,根源都在于 check_retain_source 配置项与 broker 自产 $SYS 消息的交互。

配置项背景:check_retain_source 是 broker 的 ACL 相关选项,在 conf.c 中解析,默认关闭。开启后,broker 在向订阅者投递保留消息(retained message)时会额外校验原始发布者的写权限(retain.c):如果保留消息的 origin 不是 broker 自身(retained->origin != mosq_mo_broker)且记录了原始来源 ID,则以原始发布者的身份重新执行一次 ACL 写检查,防止"发布时有权、订阅时权限已撤销"导致的信息泄露。

缺陷表现:$SYS/broker/version 这类由 broker 自身生成的保留消息,其 origin 标记是 mosq_mo_broker,本应被该逻辑豁免;但 1.6.2 之前的版本中,broker 自产消息未被正确豁免,导致在 check_retain_source=true 的配置下,新订阅者订阅 $SYS/# 时收不到 $SYS/broker/version,该消息"凭空消失"。

修复验证:从 sys_tree.c 可以看到,$SYS/broker/version 在 sys_tree__init() 中由 broker 以 db__messages_easy_queue(NULL, "$SYS/broker/version", SYS_TREE_QOS, ...) 方式直接入队为保留消息;修复后该消息在 retain.c 的保留源检查中因 origin == mosq_mo_broker 而被正确放行。

修复三:$SYS/broker/version 不再被错误过期

同一问题单下的第二个缺陷:$SYS/broker/version 被错误地设置为 60 秒后过期。Mosquitto 1.6 引入了保留消息过期(retained message expiry)机制,retain.c 中通过 expiry_time 与当前时间比较来判定保留消息是否过期并清除。1.6.2 之前,broker 在生成 $SYS/broker/version 时被错误地附加了 60 秒的过期时间,导致 broker 运行 60 秒后该消息从保留树中消失,订阅者此后无法再获取版本信息。修复后该静态消息不再设置过期时间,与 sys_tree.c 中其他静态 $SYS 指标一致,长期稳定可查。

修复四:WITH_TLS=no 构建恢复

问题单 #1250:1.6.2 修复了编译期配置 WITH_TLS=no(禁用 TLS 支持)时构建失败的问题。该问题通常源于无 TLS 分支下残留了 TLS 相关符号引用或头文件依赖。修复后,无 OpenSSL 环境下(如精简嵌入式系统)可以正常编译 broker 与客户端库。构建方式参见仓库根目录的 README-compiling.md。

Library 修复:客户端连接失败后的清理崩溃

问题单 #1246:libmosquitto 在客户端始终无法连接 broker 且进程退出时,会在库的最终清理例程(final library cleanup routine)中崩溃。典型场景是:程序创建了客户端实例,但由于 broker 地址不可达或认证失败导致连接从未建立成功,随后程序直接退出——此时 mosquitto_destroy() 等清理路径访问了尚未正确初始化的内部状态,触发崩溃。

该问题影响所有使用 libmosquitto 的嵌入式应用与服务端程序,属于"失败路径(failure path)"上的资源清理缺陷。修复后,无论连接是否成功建立,客户端实例的销毁都能安全完成。当前仓库中 mosquitto.c 及其相关清理逻辑即为修复后的实现。

Clients 修复:-L URL 解析

问题单 #1248:命令行客户端(mosquitto_pub / mosquitto_sub / mosquitto_rr)的 -L/--url 参数在 1.6.2 之前解析存在缺陷。

-L 允许用户用一条 URL 同时指定主机、端口、协议、认证信息与主题,其完整解析逻辑位于 client_shared.c,规则如下:

  • 协议前缀(不区分大小写)决定默认端口与传输方式:
    • mqtt:// → 默认端口 1883,原生 TCP;
    • mqtts:// → 默认端口 8883,启用 TLS(需 WITH_TLS 编译支持,并自动使用操作系统证书库);
    • ws:// → 默认端口 1883,WebSocket 传输;
    • wss:// → 默认端口 8883,TLS + WebSocket;
    • 其他 scheme 报错 Unsupported URL scheme。
  • URL 中第一个 / 之后的部分解析为主题(topic = strchr(url, '/')),主题缺失时报错退出;
  • 可选 username[:password]@ 前缀提供认证信息,冒号前为用户名、冒号后为密码;
  • 主机名后可选 :port 覆盖默认端口。

典型用法:

# 原生 MQTT,指定端口与主题
mosquitto_sub -L mqtt://broker.example.com:1883/sensors/#

# TLS + 用户名密码
mosquitto_pub -L mqtts://user:pass@broker.example.com/home/temperature \
  -m 25.5

# WebSocket
mosquitto_pub -L ws://broker.example.com/ws/topics/data -m hello

1.6.2 修复了该解析流程中的边界缺陷(如端口缺失、认证段缺密码、主题含特殊字符等场景),使 -L 与 --url 的行为符合上述文档化规则。

升级与验证建议

  1. 判定是否需要升级:若部署运行 1.6.0 / 1.6.1 且允许 MQTT v5 客户端连接,强烈建议升级——尤其是客户端可能携带带属性 Will 的物联网/遥测场景;开启 check_retain_source=true 且依赖 $SYS 监控指标的部署同样应尽快升级。
  2. 升级后验证:
    • 使用 MQTT v5 客户端设置 Will,将 content-type 或 response-topic 作为第一个 Will 属性,异常断开连接,确认 broker 不崩溃且 Will 正常发布;
    • 以 check_retain_source true 配置启动 broker,订阅 $SYS/#,确认 $SYS/broker/version 可立即收到且持续可查(不再 60 秒后消失);
    • 用带认证段与自定义端口的 -L URL 分别验证 pub/sub/rr 客户端行为正常。
  3. 仓库证据索引:本仓库为修复后的代码状态,可对照阅读 will_mosq.c(Will 设置与属性校验)、property_mosq.c(属性命令合法性表)、retain.c(保留消息过期与来源检查)、sys_tree.c($SYS 静态消息生成)以及 client_shared.c(-L URL 解析),理解各修复的最终实现形态。
登录后查看全文
mosquitto