# 版本发布

# v4.4.11

发布日期: 2022-11-26

本次版本更新包含了 18 个增强和 14 个修复。 在这些增强中,下面几个新功能值重点介绍:

  • 新增 OCSP (Online Certificate Status Protocol) Stapling。
  • 新增 CRL (Certificate Revocation List) cache。
  • OTP 从 24.1.5-3 升级到了 24.3.4.2-1。
  • 新增了 客户端别名的支持,使得定制化认证和授权更加容易实现。

该版本仍支持从老版本的 v4.4 热升级上来, 但需要注意的是:如果需要在热升级后使用新版本提供的功能(例如 OCSP Stapling 和 CRL) 那么节点重启(配合配置更新)仍然不能避免。

# 增强

  • OTP 升级: 从 24.1.5-3 至 24.3.4.2-1 #9265 (opens new window)。 重要更新:

    • Erlang/OTP SSL库漏洞修复 (opens new window)
    • 增加了对 OCSP (Online Certificate Status Protocol) Stapling 的支持
    • 增加了 CRL(证书吊销列表)缓存的自动刷新功能
  • 增加了 OCSP stapling 和 CRL 缓存 #9297 (opens new window)

  • 增加了可定制的 clientid 或 username 别名的回调模块 #9297 (opens new window)。 有了这个回调模块后,可以简单实现一个 Erlang 的回调函数用来给客户端增加别名,然后在认证和授权规则的占位符中使用这些别名 (%cida 用作 clientid 别名,%cna 用作 用户名别名)。

  • 增加了可定制的认证回调模块 #9297 (opens new window)。 对于一些简单的认证检查,不需要去实现一个完整的认证插件。

  • 为规则引擎增加了一个 JWT 令牌管理,用于在规则引擎动作中创建和刷新 JWT 令牌 #9241 (opens new window)。 该功能现在仅用于 EMQX 企业版的 Google PubSub 集成中。 后续会用于 webhook 集成的 JWT 认证。

  • 检查监听器的 tls_versions 配置值是 tlsv1tlsv1.1tlsv1.2tlsv1.3 中的一个或多个组合 #9260 (opens new window)

  • 删除 Dashboard 监听器失败时日志中的无用信息 #9260 (opens new window).

  • 当 CoAP 网关给设备投递消息并收到设备发来的确认之后,回调 'message.acked' 钩子 #9264 (opens new window)。 有了这个改动,CoAP 网关可以配合 EMQX (企业版)的离线消息缓存功能,让 CoAP 设备重新上线之后,从数据库读取其离线状态下错过的消息。

  • 支持在规则引擎的 Webhook 动作的 HTTP Headers 里使用 ${var} 格式的占位符 #9239 (opens new window)

  • 在 emqx 启动时,异步地刷新资源和规则 #9199 (opens new window)。 这个改动是为了避免因为一些资源连接建立过慢,而导致启动时间过长。

  • 订阅时,如果 ACL 检查不通过,打印一个警告日志 #9124 (opens new window)。 该行为的改变主要是为了跟发布失败时的行为保持一致。

  • 基于 JWT 的 ACL 支持 all 动作,指定同时适用于 pubsub 两个动作的规则列表 #9044 (opens new window)

  • 增强包含敏感数据的日志的安全性 #9189 (opens new window)。 如果日志中包含敏感关键词,例如 password,那么关联的数据回被模糊化处理,替换成 ******

  • 增强 ACL 模块中的日志安全性,敏感数据将被模糊化 #9242 (opens new window)

  • 增加 management.bootstrap_apps_file 配置,可以让 EMQX 初始化数据库时,从该文件批量导入一些 APP / Secret #9273 (opens new window)

  • 增加了固化认证和 ACL 模块调用顺序的配置 #9283 (opens new window)。 这两个新的全局配置名称为 auth_orderacl_order。 当有多个认证或 ACL 插件(或模块)开启时,没有该配置的话,模块调用的顺序取决于它们的启动顺序。 例如,如果一个插件(或模块)在系统启动之后单独重启了,那么它就有可能排到其他插件(或模块)的后面去。 有了这个配置之后,用户可以使用用逗号分隔的插件(或模块)的名字(或别名)来固化他们被调用的顺序。 例如,acl_order = jwt,http,可以用于保证 jwt 这个模块总是排在 http 的前面, 也就是说,在对客户端进行 ACL 检查时,如果 JWT 不存在(或者没有定义 ACL),那么回退到使用 HTTP。

  • 为更多类型的 client.disconnected 事件(计数器触发)提供可配置项 #9267 (opens new window)。 此前,client.disconnected 事件及计数器仅会在客户端正常断开连接或客户端被系统管理员踢出时触发, 但不会在旧 session 被新连接废弃时 (clean_session = true) ,或旧 session 被新连接接管时 (clean_session = false) 被触发。 可将 broker.client_disconnect_discardedbroker.client_disconnect_takovered 选项设置为 on 来启用此场景下的客户端断连事件。

  • 规则引擎资源创建失败后,第一次重试前增加一个延迟 #9313 (opens new window)。 在此之前,重试的延迟发生在重试失败之后。

# 修复

  • 修复日志追踪模块没开启时,GET Trace 列表接口报错的问题。#9156 (opens new window)

  • 修复创建追踪日志时偶尔会报end_at time has already passed错误,导致创建失败。#9156 (opens new window)

  • 修复若上传的备份文件名中包含非 ASCII 字符,GET /data/export HTTP 接口返回 500 错误 #9224 (opens new window)

  • 改进规则的 "最大执行速度" 的计数,只保留小数点之后 2 位 #9185 (opens new window)。 避免在 dashboard 上展示类似这样的浮点数:0.30000000000000004

  • 修复在尝试连接 MongoDB 数据库过程中,如果认证失败会不停打印错误日志的问题 #9184 (opens new window)

  • 修复 emqx-sn 插件在“空闲”状态下收到消息发布请求时可能崩溃的情况 #9024 (opens new window)

  • 限速 “Pause due to rate limit” 的日志级别从原先的 warning 降级到 notice #9134 (opens new window)

  • 保留老的 emqx_auth_jwt 模块的接口函数,保障热升级之前添加的回调函数在热升级之后也不会失效 #9144 (opens new window)

  • 修正了 /status API 的响应状态代码 #9210 (opens new window)。 在修复之前,它总是返回 200,即使 EMQX 应用程序没有运行。 现在它在这种情况下返回 503

  • 修复规则引擎的消息事件编码失败 #9226 (opens new window)。 带消息的规则引擎事件,例如 $events/message_delivered$events/message_dropped, 如果消息事件是共享订阅产生的,在编码(到 JSON 格式)过程中会失败。 影响到的版本:v4.3.21, v4.4.10, e4.3.16e4.4.10

  • 使规则引擎 API 在 HTTP 请求路径中支持百分号编码的 rule_idresource_id #9190 (opens new window)。 注意在创建规则或资源时,HTTP body 中的 id 字段仍为字面值,而不是编码之后的值。 详情请参考 创建规则 (opens new window)创建资源 (opens new window)

  • 修复调用 'DELETE /alarms/deactivated' 只在单个节点上生效的问题,现在将会删除所有节点上的非活跃警告 #9280 (opens new window)

  • 在进行消息重发布或桥接消息到其他 mqtt broker 时,检查 topic 合法性,确定其不带有主题通配符 #9291 (opens new window)

  • 关闭管理端口(默认为8081)上对 HTTP API api/v4/emqx_prometheus 的认证,Prometheus 对时序数据抓取不在需要配置认证 #9294 (opens new window)

# v4.4.10

发布日期: 2022-10-14

# 增强

  • TLS 监听器内存使用量优化 #9005 (opens new window)。 新增了配置项 listener.ssl.$NAME.hibernate_after (默认不开启),该配置生效后,TLS 连接进程在空闲一段时间后会进入休眠。 休眠可以较大程度减少内存占用,但是代价是 CPU 利用率会增加。 测试中使用 '5s' (即 5 秒空闲后休眠)可以减少 50% 的内存使用量。

  • 默认 TLS Socket 缓存大小设置为 4KB #9007 (opens new window) 这样可以有效的避免某些环境中操作系统提供的默认缓存过大而导致 TLS 连接内存使用量大的问题。

  • 关闭了 HTTP API api/v4/emqx_prometheus 的认证 #8955 (opens new window)。 Prometheus 对时序数据抓取不在需要配置认证。

  • 更严格的 flapping 检测,认证失败等原因也会进行计数 #9045 (opens new window)

  • 当共享订阅的会话终结时候,把缓存的 QoS1 和 QoS2 的消息向订阅组的其他成员进行转发 #9094 (opens new window)。 在这个增强之前,可以通过设置配置项 broker.shared_dispatch_ack_enabledtrue 来防止在共享订阅的会话中缓存消息, 但是这种转发因为需要对每个消息进行应答,会增加额外的系统开销。

  • 修复延迟发布可能因为修改系统时间而导致的延迟等问题 #8908 (opens new window)

# 修复

  • 修复慢订阅追踪模块在 stats_typeinternalresponse 时,计算单位使用错误 #8981 (opens new window)

  • 修复 HTTP 客户端库启用 SSL 后 Socket 可能会进入 passive 状态 #9145 (opens new window)

  • 隐藏 redis 客户端错误日志中的密码参数 #9071 (opens new window)。 也包含了如下一些改进:

  • 修复共享订阅消息转发逻辑 #9094 (opens new window)

    • QoS2 飞行窗口消息丢弃的日志过度打印问题
    • 对于通配符订阅的消息,会话中缓存的消息重发时,因为使用了发布主题(而非通配符主题)来进行重发, 导致无法匹配到 共享订阅组内的其他成员。
  • 修复共享订阅 sticky 策略下,客户端取消订阅后仍然可以收到消息的问题 #9119 (opens new window)。 这之前的版本中,仅处理了客户端会话终结,而没有处理取消订阅。

  • 修复共享订阅 sticky 策略在某些情况下退化成 random 策略的问题 #9122 (opens new window)。 集群环境下,在之前的版本中, 共享订阅组成员的选择在最开始时会随机选取,最终会选中在本节点连接的客户端,并开始粘性转发。 如果所有的订阅客户端都不在本节点,那么粘性策略就会退化成随机。 这个修复后,粘性策略将应用于第一个随机选取的客户端,不论该客户端是不是在本节点。

  • 修复规则引擎的备选(fallback)动作的计数重置失败的问题 #9125 (opens new window)

# v4.4.9

发布日期: 2022-09-17

# 增强

  • JWT 认证中的 expnbfiat 声明支持非整数时间戳

# 修复

  • 修复规则引擎的更新行为,此前会尝试初始化已禁用的规则
  • 修复 Dashboard 监听器绑定 IP 地址不生效的问题
  • 修复 shared_dispatch_ack_enabled 配置为 true 时共享订阅可能陷入死循环的问题
  • 修复规则引擎 SQL 对空值进行主题匹配时崩溃的问题

# v4.4.8

发布日期: 2022-08-29

# 增强

  • 新增 GET /trace/:name/detail API 以查看日志追踪文件信息
  • 改进 LwM2M 报文解析失败时的日志
  • 改进规则引擎错误日志,动作执行失败时的日志中将包含规则 ID
  • 改进 loaded_modulesloaded_plugins 文件不存在时的提醒日志
  • Dashboard 新增修改默认密码的引导

# 修复

  • 修复 client.disconnected 在某些情况下不会触发的问题
  • 修复内置数据库认证未区分客户端 ID 和用户名的认证数据的分页统计的问题
  • 修复 Redis 驱动进程泄漏的问题
  • 修复规则引擎 MQTT 桥接至 AWS IOT 连接超时的问题
  • 修复监听器未就绪时 GET /listener 请求崩溃的问题
  • 修复 v4.4.1 版本后规则引擎 SQL 中任意变量与空值比较总是返回 false 的问题
  • 修复错误地将 emqx_modules 应用作为插件管理的问题
  • 修复 ExHook 的执行优先级高于规则引擎时,被 ExHook Message Hook 过滤的主题将无法触发规则引擎的问题
  • 修复 ExHook 管理进程因 supervisor 关闭超时而被强制杀死的问题
  • 修复 ExProto client.connect 钩子中 Client ID 参数未定义的问题
  • 修复客户端被踢除时 ExProto 不会触发断开连接事件的问题

# v4.4.7

发布日期: 2022-08-11

# 重要变更

  • 从 4.4.7 版本开始,我们将不再为 macOS 10 提供安装包

# 增强

  • 允许配置连接进程在 TLS 握手完成后进行垃圾回收以减少内存占用,这可以使每个 SSL 连接减少大约 35% 的内存消耗,但相应地会增加 CPU 的消耗
  • 允许配置 TLS 握手日志的日志等级以便查看详细的握手过程

# v4.4.6

发布日期: 2022-07-29

# 增强

  • 支持对规则引擎中的规则进行搜索和分页
  • 提供 CLI ./bin/emqx check_conf 以主动检查配置是否正确
  • 优化共享订阅性能

# 修复

  • 修复热升级后一旦卸载了老版本 EMQX 将无法再次启动的问题
  • 修复多语言协议扩展中对 UDP 客户端的保活检查错误导致客户端不会过期的问题
  • 修复多语言协议扩展中客户端信息没有及时更新的问题
  • 修复客户端指定 Clean Session 为 false 重连时,飞行窗口中的共享订阅消息会被尝试重新派发给旧会话进程的问题
  • 修复 emqx_lua_hook 插件无法取消消息发布的问题

# v4.4.5

发布日期: 2022-06-30

# 增强

  • 规则引擎消息重发布动作中的 QoS 和保留消息标识现在可以使用占位符
  • 支持排他订阅,即一个主题只允许存在一个订阅者
  • 现在 Dashboard 和管理 API 的 HTTPS 监听器可以使用受密码保护的私钥文件,提供了 key_password 配置项
  • 支持在主题重写规则中使用占位符 %u%c
  • 支持在消息发布的 API 请求中设置 MQTT 5.0 的 Properties,例如消息过期间隔、响应主题等
  • 优化规则引擎资源创建时的 UI,例如折叠部分不常用的选项等
  • 为 ExHook 底层的 gRPC 连接开放了 KeepAlive、TCP_NODELAY、SO_RCVBUF 和 SO_SNDBUF 共 4 个与 TCP 相关的配置项

# 修复

  • 修复 Linux 系统中内存计算不准确的问题,并改为计算当前系统的内存占用,而不是 EMQX 的内存占用
  • 修复 ExHook 在客户端重连时旧的断开连接事件会晚于新的连接事件触发的问题
  • 修复主题重写与延迟发布执行顺序不固定的问题,现在固定为优先执行主题重写
  • 修复规则引擎无法编码 MQTT 5.0 用户属性的问题
  • 修复客户端使用 MQTT v5.0 以下的协议版本接入时 connack.auth_error 计数不准确的问题
  • 修复 LwM2M 和 CoAP 网关的 UDP 监听器无法绑定指定网络接口的问题
  • 修复在配置文件中移除默认的 Dashboard 用户后 Dashboard 无法启动的问题
  • 修复 client.subscribe 钩子无法拒绝订阅的问题
  • 如果 ACL 规则中的占位符没有被替换,则客户端的发布或订阅操作将被拒绝

# v4.4.4

发布日期: 2022-06-01

# 增强

  • 为规则引擎 SQL 增加更多的时间转换函数
  • 为规则引擎 SQL 增加 float2str/2 函数,支持指定浮点输出精度
  • 支持将 JWT 用于鉴权,现在 MQTT 客户端可以使用包含发布订阅白名单的特定声明进行授权
  • 改进认证相关指标使更易理解,现在 client.authenticate = client.auth.success + client.auth.failure
  • 支持 REST API 的监听器绑定到指定的网络接口上
  • 支持对使用内置数据库作为数据源的认证鉴权中的用户数据进行多条件查询和模糊查询
  • 支持将消息队列长度以及丢弃消息数量作为条件查询客户端
  • 支持配置日志时间格式以兼容旧版本中的时间格式
  • use_username_as_clientid 配置为 true 且客户端连接时未指定 username,现在将拒绝连接并返回 0x85 原因码
  • App secret 从部分随机改为完全随机
  • 通过 CLI 进行备份恢复时,不再要求备份文件必须位于 EMQX 数据目录的 backup 文件夹下
  • 现在不兼容版本之间的热升级将被拒绝
  • 允许 EMQX 的安装路径中有空格
  • 引导脚本将在遇到无效的节点名称时快速失败,并提高错误消息的可读性

# 修复

  • 修复规则引擎 SQL 函数 hexstr_to_bin/1 无法处理半字节的问题
  • 修复规则引擎资源删除时告警未被清除的问题
  • 修复 Dashboard HTTPS 监听器的 verify 选项未生效的问题
  • 修复共享订阅投递 QoS 1 消息过程中对端会话关闭导致消息丢失的问题
  • 修复日志跟踪功能跟踪大报文时堆大小增长过快而触发连接进程强制关闭策略的问题
  • 修复 MQTT-SN 客户端重传 QoS 2 消息时会被断开连接的问题
  • 修复消息发布 API api/v4/mqtt/publish 中用户属性类型错误导致订阅端连接断开的问题
  • 修复 PostgreSQL 驱动未适配 OTP 24 导致某些认证算法不可用的问题
  • 修复对订阅进行多条件查询时返回结果与查询条件不符的问题
  • 修复规则引擎资源连接测试不工作的问题
  • 修复多项 Dashboard 显示问题

# v4.4.3

发布日期: 2022-04-18

# 增强

  • 规则引擎支持重置指定规则的统计指标
  • 规则引擎新增连接确认和鉴权完成事件
  • 规则引擎支持拷贝规则以快速复用
  • 规则引擎 SQL 支持 zip、gzip 等压缩和解压缩函数
  • 改进规则引擎在解析 Payload 失败时的错误提示
  • 优化规则引擎部分资源的连接测试
  • 支持为 ExHook 设置执行优先级
  • ExHook 回调接口新增 RequestMeta meta Protobuf 字段用于返回 EMQX 集群名称
  • 为共享订阅添加 local 策略,这将优先向消息流入的节点下的共享订阅者发送消息。在某些场景下会提升共享消息调度的效率,尤其是在 MQTT 桥接配置为共享订阅时
  • 为 TLS 新增对 RSA-PSK-AES256-GCM-SHA384RSA-PSK-AES256-CBC-SHA384RSA-PSK-AES128-GCM-SHA256RSA-PSK-AES128-CBC-SHA256 四个 PSK 加密套件的支持,从默认配置中移除 PSK-3DES-EDE-CBC-SHAPSK-RC4-SHA 这两个不安全的加密套件
  • 打印 Mnesia wait_for_table 诊断日志
    • 打印 Mnesia 内部统计的检查点
    • 打印每个表加载统计的检查点,帮助定位表加载时间长的问题
  • 严格模式下禁止订阅为空的主题
  • loaded_modulesloaded_plugins 文件不存在时生成默认文件

# 修复

  • 修复 TLS 配置项 server_name_indication 设置为 disable 不生效的问题
  • 修复 MongoDB 驱动潜在的进程泄漏问题
  • 修复通过 CLI 命令修改的 Dashboard 默认用户的密码会在节点离开集群后重置的问题
  • 静默 docker-entrypoint.sh 中的 grep 和 sed 命令的运行错误日志
  • 修复 API 路径包含 ISO8859-1 转义字符时,备份文件无法被正确删除和下载
  • 修复 Redis 驱动在 DNS 解析失败等情况下会引发崩溃的问题
  • 修复规则引擎发送数据到 Web 服务动作中 Headers 字段配置不生效的问题
  • 修复 MQTT Bridge 插件仅配置订阅主题但未配置 QoS 时无法启动的问题
  • 创建规则时如果已经有使用相同 ID 的规则存在,现在规则引擎将报错而不是替换已有规则
  • 修复 HTTP 驱动进程池可能无法删除的问题

# v4.4.2

发布日期: 2022-04-01

# 重要变更

  • 对于 Docker 镜像,配置目录 /opt/emqx/etc 已经从 VOLUME 列表中删除,这使用户可以更容易地使用更改后的配置来重建镜像。
  • CentOS 7 Erlang 运行系统在 OpenSSL-1.1.1n(之前是 1.0)上重建,在 v4.3.13 之前,客户端使用某些密码套件时,EMQX 将无法成功握手并触发 malformed_handshake_data 异常。
  • CentOS 8 Erlang 运行时系统在 RockyLinux 8 上重新构建。 centos8 将继续保留在包名中以保持向后兼容。

# 增强

  • Windows 包支持基于 Erlang/OTP 24 构建。
  • 新增命令行接口 emqx_ctl pem_cache clean,允许强制清除 x509 证书缓存,以在证书文件更新后立即重新加载。
  • 重构 ExProto,以便匿名客户端也可以显示在 Dashboard 上。
  • 桥接中的主题配置项现在可以使用 ${node} 占位符。
  • 严格模式下新增对 MQTT 报文中的 UTF-8 字符串有效性检查。设置为 true 时,无效的 UTF-8 字符串将导致客户端连接断开。
  • MQTT-SN 网关支持会话恢复时主动同步注册主题。
  • 将规则引擎浮点型数据的写入精度从为小数点后 10 位提升至 17 位。
  • EMQX 将在启动时提示如何修改 Dashboard 的初始密码。

# 修复

  • 修复 el8 安装包在 Amazon Linux 2022 上无法启动的问题,错误内容为 errno=13 Permission denied
  • 修复某些情况下如果连接进程阻塞,客户端无法重连的问题,现在等待超过 15 秒无响应将强制关闭旧的连接进程。
  • 修复规则引擎资源不可用时查询资源请求超时的问题。
  • 修复热升级运行失败后再次运行出现 {error, eexist} 错误的问题。
  • 修复向不存在的主题别名发布消息会导致连接崩溃的问题。
  • 修复通过 HTTP API 在另一个节点上查询 lwm2m 客户端列表时的 500 错误。
  • 修复主题订阅的 HTTP API 在传入非法的 QoS 参数时崩溃的问题。
  • 修复通过多语言协议扩展功能接入的连接进程异常退出时未释放相关资源导致连接计数不更新的问题。
  • 修复 server_keepalive 配置项的值会被错误应用于 MQTT v3.1.1 客户端的问题。
  • 修复 Stomp 客户端无法触发 $event/client_connection 事件消息的问题。
  • 修复 EMQX 启动时系统内存告警误激活的问题。
  • 修复向 MQTT-SN 客户端成功注册主题时没有重传此前因未注册主题而投递失败的消息的问题。
  • 修复 loaded_plugins 文件中配置了重复的插件时 EMQX 启动输出错误日志的问题。
  • 修复 MongoDB 相关功能在配置不正确时输出过量错误日志的问题。
  • 增加对 Dashboard User 与 AppID 的格式检查,不允许出现 / 等特殊字符。
  • 将踢除客户端时返回的 DISCONNECT 报文中的原因码更正为 0x98
  • 代理订阅将忽略为空的主题。

# v4.4.1

发布日期: 2022-02-21

此补丁版本仅包含 Windows 包的 CI 更改。

# v4.4.0

发布日期: 2022-02-18

注意:

  • 4.4.0 与 4.3.12 保持同步。
  • 当前版本 Windows 包的构建存在一些问题,我们会在下一版本中解决它

此更改集的比较基础是 4.3.12。

# 重要变更

  • 从 4.4 开始,EMQX 的发行包命名将包含 Erlang/OTP 的版本号,例如 emqx-ee-4.4.0-otp24.1.5-3-centos7-arm64.rpm

  • 对于 Debian/Ubuntu 用户,Debian/Ubuntu 包 (deb) 安装的 EMQX 现在可以在 systemd 上运行,这是为了利用 systemd 的监督功能来确保 EMQX 服务在崩溃后重新启动。包安装服务从 init.d 升级到 systemd 已经过验证,但仍建议您在部署到生产环境之前再次验证确认,至少确保 systemd 在您的系统中可用

  • 规则引擎 InfluxDB 集成新增对 InfluxDB v2 API 的支持,规则引擎现已支持 InfluxDB 2.0 与 InfluxDB Cloud

  • 规则引擎新增对 SAP Event Mesh 的支持

  • 规则引擎新增对超融合时空数据库 MatrixDB 的支持

  • MongoDB 集成支持 DNS SRV 和 TXT Records 解析,可以与 MongoDB Altas 无缝对接

  • 新增在线 Trace 功能,用户可以在 Dashboard 上完成对客户端和主题的追踪操作,以及查看或下载追踪日志

  • 新增慢订阅统计功能,用以及时发现生产环境中消息堵塞等异常情况

  • 支持动态修改 MQTT Keep Alive 以适应不同能耗策略

  • 集群从 4.3 到 4.4 支持滚动升级。详情请见升级指南。

  • 节点间的 RPC 链接支持配置 TLS. 详情请见集群文档

  • 新增慢订阅功能,支持统计消息传输过程中花费的时间,并记录和展示耗时较高的客户端和主题。

  • 新增在线日志跟踪功能,支持实时跟踪客户端事件并在 Dashboard 上查看。

# 次要变更

  • Dashboard 支持查看客户端活跃连接数

  • Dashboard 支持相对路径和自定义访问路径

  • Dashboard 移除选项卡导航

  • 支持配置是否将整型数据以浮点类型写入 InfluxDB

  • 支持配置是否转发为 Payload 为空的保留消息,以适应仍在使用 MQTT v3.1 的用户,相关配置项为 retainer.stop_publish_clear_msg

  • 多语言钩子扩展(exhook)支持动态取消客户端消息的后续转发

  • 规则引擎 SQL 支持在 FROM 子句中使用单引号,例如:SELECT * FROM 't/#'

  • 优化内置访问控制文件模块的使用交互

  • max_topic_levels 配置项的默认值更改为 128,以前它没有限制(配置为 0),这可能是潜在的 DoS 威胁

  • 改进了接收到 Proxy Protocol 报文但 proxy_protocol 配置项未开启时的错误日志内容

  • 为网关上报消息添加额外的消息属性。来自 CoAP, LwM2M,Stomp,ExProto 等网关的消息,在转换为 EMQX 的消息时,添加例如协议名称,协议版本,用户名,客户端 IP 等字段,可用于多语言钩子扩展

  • HTTP 性能优化

  • 将 openssl-1.1 添加到 RPM 依赖

# v4.4-beta.1

发布日期: 2021-12-21

EMQX 4.4-beta.1 现已正式发布,主要包含以下改动:

# 重要变更

  • 从 4.4 开始,EMQX 的发行包命名将包含 Erlang/OTP 的版本号,例如 emqx-4.4.0-otp24.1.5-3-centos7-arm64.rpm

  • 对于 Debian/Ubuntu 用户,Debian/Ubuntu 包 (deb) 安装的 EMQX 现在可以在 systemd 上运行,这是为了利用 systemd 的监督功能来确保 EMQX 服务在崩溃后重新启动。包安装服务从 init.d 升级到 systemd 已经过验证,但仍建议您在部署到生产环境之前再次验证确认,至少确保 systemd 在您的系统中可用

  • MongoDB 认证支持 DNS SRV 和 TXT Records 解析,可以与 MongoDB Altas 无缝对接

  • 支持动态修改 MQTT Keep Alive 以适应不同能耗策略

  • 集群从 4.3 到 4.4 支持滚动升级。详情请见升级指南。

  • 节点间到 RPC 链接支持配置 TLS. 详情请见集群文档

# 次要变更

  • Dashboard 支持相对路径和自定义访问路径

  • 支持配置是否转发为 Payload 为空的保留消息,以适应仍在使用 MQTT v3.1 的用户,相关配置项为 retainer.stop_publish_clear_msg

  • 多语言钩子扩展(exhook)支持动态取消客户端消息的后续转发

  • 规则引擎 SQL 支持在 FROM 子句中使用单引号,例如:SELECT * FROM 't/#'

  • max_topic_levels 配置项的默认值更改为 128,以前它没有限制(配置为 0),这可能是潜在的 DoS 威胁

  • 改进了接收到 Proxy Protocol 报文但 proxy_protocol 配置项未开启时的错误日志内容

  • 为网关上报消息添加额外的消息属性。来自 CoAP, LwM2M,Stomp,ExProto 等网关的消息,在转换为 EMQX 的消息时,添加例如协议名称,协议版本,用户名,客户端 IP 等字段,可用于多语言钩子扩展

  • HTTP 性能优化

  • 将 openssl-1.1 添加到 RPM 依赖

# 修复

  • 修复节点间 RPC 调用堵塞导致客户端进程失去响应的问题。详见 Erlang/OTP #5346

  • 修复锁管理进程 ekka_locker 在杀死挂起的锁持有者后 Crash 的问题

  • 修复规则引擎 WebHook Action 中的 Path 参数无法使用规则引擎变量的问题

  • 修复 MongoDB 认证模块无法使用 Replica Set 模式等问题

  • 修复集群间消息转发失序问题,相关配置项为 rpc.tcp_client_num

  • 修复内存占用计算错误的问题

  • 修复远程主机无法访问时的 MQTT Bridge 故障问题(连接挂起)

  • 修复 HTTP Headers 可能重复的问题