EMQX 企业版 v4 版本

4.4.25

发布日期: 2024-09-13

增强

• 增加用户名配额限制模块，限制单个 MQTT 用户名允许登录的会话数。

  此功能可以在 Dashboard 上，通过模块 -> 用户名配额限制进行配置。 在参数设置标签页，可以添加用户名白名单，白名单内的用户名将不受配额的限制。

  注意若开启此功能，需要使用白名单来规避 MQTT 桥接的用户名配额限制。

• 优化了使用 MQTT 3.1.1 协议时，CONNECT 报文携带了非法 Will QoS 值时的错误日志输出。

• 改进了发送消息到 Redis 的性能。

  改进之前，由于 gen_tcp:send/2 的实现限制，随着 Redis Client 进程发送队列中积压的消息增多，发送性能会逐渐下降。因此，在高消息流量的情况下，Redis Client 进程可能成为系统瓶颈。

  此优化将同时提升 Redis 认证/ACL、Redis 插件以及 Redis 规则引擎资源的发送性能。对于 Redis 认证功能来说，将改善服务中断后设备大规模集中重连时的压力。

• 改进了发送消息到 SysKeeper 的性能。

  改进之前，由于 gen_tcp:send/2 的实现限制，随着 emqx_bridge_sysk_forward 进程发送队列中积压的消息增多，发送性能会逐渐下降。因此，在高消息流量的情况下，emqx_bridge_sysk_forward 进程可能成为系统瓶颈。

• 将单个日志追踪的文件大小上限从 512MB 提升到 1GB。

• 改进 “内置数据库 认证/访问控制” 模块的 ACL 功能。

  • 现在可以设置单个客户端的内置 ACL 模块中 ACL 条目的上限了。

    在发布或订阅主题时校验 ACL 需要遍历客户端的 ACL 条目，所以对于单个客户端来说，添加太多 ACL 条目会导致发布或订阅的性能下降。 现在可以通过 auth.mnesia.max_acls_for_each_login 配置项，或者 “内置数据库 认证/访问控制” 模块的 最大 ACL 数量 参数来限制为单个客户端添加的 ACL 条目数量。

  • 改进了内置 ACL 模块的匹配性能。

    通过优化 ACL 表的存储结构和主题匹配逻辑，提升了从内置 ACL 模块查找和匹配 ACL 条目的性能。单个客户端的 ACL 条目数量越多，性能提升越明显。

  • 内置 ACL 模块中，添加/删除 ACL 条目之后将重置 ACL 缓存。

• 规则引擎的批量发送进程支持过载保护。

  在启用批量发送选项后，规则引擎将会为动作创建一组进程用于缓冲和批量发送消息。如果使用异步发送模式，当外部数据库响应过慢时，消息会积压在批量进程的消息队列里，导致内存超出系统限制的风险。现在，规则引擎的批量发送功能将会受到过载保护的限制，当消息队列的大小超过 "最大批量数" * 10 (如果“最大批量数”*10 的值小于 1000，消息队列大小最小值则为 1000) 时，动作将会被 “卸载” 一段时间（默认 60s）。这段时间内发往动作的后续消息会被丢弃，同时会触发 action_olp_blocked/<RuleID>/<ActionID> 告警。

  受过载保护限制的动作：

  • 保存数据到 Cassandra
  • 保存数据到 ClickHouse
  • 保存数据到 DolphinDB
  • 保存数据到 InfluxDB
  • 保存数据到 IoTDB
  • 保存数据到 Lindorm
  • 保存数据到 MySQL
  • 保存数据到 Oracle Database
  • 保存数据到 PostgreSQL
  • 保存数据到 SQLServer
  • 保存数据到 Tablestore
  • 保存数据到 TDengine
  • 桥接数据到 GCP Pubsub

• 支持将未定义值作为 NULL 写入到数据库。

  规则引擎的多种数据库动作都支持使用 ${var} 格式的占位符来构建插入语句。改进前，当占位符变量未定义时，规则引擎可能会插入 undefined 字符串到数据库中。现在，规则引擎的数据库相关动作新增了一个 "未定义值作为 NULL 插入" 选项，当变量未定义时，使用 NULL 写入到数据库。

  支持此选项的动作：

  • 保存数据到 Cassandra
  • 保存数据到 ClickHouse
  • 保存数据到 DolphinDB
  • 保存数据到 MySQL
  • 保存数据到 Oracle Database
  • 保存数据到 PostgreSQL
  • 保存数据到 SQLServer
  • 保存数据到 TDengine

• 支持日志限流功能。

  当某些异常的情况发生时，可能会出现大量重复（内容类似）的日志打印的情况，一方面增加了系统的压力，另一方面也会冲刷掉其他有用的日志信息。 现在可通过 etc/logger.conf 文件中的 log.throttling 配置一个时间窗口以及时间窗口内日志打印的最高频率。

  注意为了提高限流功能的执行效率，EMQX 会启动 N 个限流器，其中 N 为 CPU 核心数。这意味着当设置 log.throttling = 50,60s 时，每个限流器将会限制每分钟最多打印 50 条相同（按日志的代码模块名+行号判断）的日志，假设 CPU 核心数为 8，视 Erlang 虚拟机对进程的调度情况不同，总共每分钟最多打印 50 ~ 400 条日志。若有日志被限流器丢弃，EMQX 会打印一条日志提示被丢弃的日志条数：

  log throttled during last 60s, dropped_msg: #{{emqx_channel,1400} => #{msg => "Client ~s (Username: '~s') login failed for ~0p", count => 33}}

  该日志表示在最近 60 秒内，emqx_channel 模块的第 1400 行代码打印了许多日志，总共有 33 条日志被 EMQX 丢弃了。

  此功能默认对 warning 及以上日志级别启用，默认值为 50,60s。

• 支持配置 HTTP/HTTPs 管理接口的超时时间。

  在 etc/plugins/emqx_management.conf 配置文件新增了两个超时相关的配置：

  • management.listener.<Proto>.request_timeout：指定 TCP 连接建立后若没有收到任何 HTTP 请求，服务端将在指定时间后关闭连接，默认值为 5 秒。
  • management.listener.<Proto>.idle_timeout：指定空闲超时时间。即该连接上曾经收到过至少一个 HTTP 请求后，如果没有更多请求，服务端将在指定时间后关闭连接，默认值为 60 秒。

  其中，<Proto> 为 http 或 https。

• 为 “消息重新发布” 动作增加对目标主题的合法性校验。

  改进后，“消息重新发布” 动作会在发送消息前校验目标主题的合法性，若主题为非 UTF-8 编码的二进制，动作将会失败。

• 优化了 Redis-Cluster 驱动的性能。

  降低了访问 Cluster 模式的 Redis 时 EMQX 的内存占用，受益于此优化的功能包括：

  • Redis 认证/ACL
  • Redis 插件
  • 规则引擎的 Redis 相关动作

修复

• 修复发送超过 Kafka 服务端最大报文限制的消息导致 Kafka Producer 被堵塞的问题。

  当发送的单个消息大小超过 Kafka 服务端配置的 message.max.bytes 时，规则引擎的 Kafka Producer 发送队列会被堵塞，后续消息将被缓存直至 Max Cache Bytes 配置的最大缓存上限。现在，如果单条消息大小超过规则引擎 Kafka 资源中的 Max Batch Bytes 限制，Kafka Producer 会将消息丢弃，避免队列阻塞。

• 修复了某些情况下 "resource down" 告警无法清除的问题。

• 修复了由遗嘱消息触发的规则中，获取的 timestamp 字段的值不正确的问题。该字段值应该是规则触发的时间而不是客户端上线时间。

• 修复当 Kafka 动作使用 username 作为 Message Key 发送数据失败的问题。

  此前，当配置了 Kafka Message Key 为 username 但 MQTT 客户端在登录时没有携带用户名时，Kafka Producer 发送消息失败。 修复后对于未携带用户名的消息，Kafka Producer 会使用 undefined 字符串作为 Message Key。

• 修复当进程异常终止时，规则引擎 $events/client_disconnected 事件无法触发的问题。

• 修复了当设置 clientid 作为 Hash Key 时，DynamoDB 动作发送数据失败的问题。

• 修复了节点重启导致共享订阅 sticky 派发策略可能退化成 random 的问题。

4.4.24

发布日期: 2024-04-16

增强

• 开放 /load_rebalance/availability_check 接口，即不需要身份验证，这将会简化负载均衡器的搭建。同时改进该接口，使其尽可能轻量，以避免 Broker 过载。

• 改进重平衡/节点疏散功能，更优雅地处理 “等待健康检查” 阶段的业务逻辑，不再阻止新的客户端与即将被疏散的节点建立连接。

  在此阶段，我们不知道负载均衡器是否已认定这些节点 “不健康”，因此禁止到它们的连接可能会导致多次重连失败。

• 改进 HTTP API 的 Idle Timeout 过短的问题。

  此前，HTTP API 的 idle_timeout 为 5 秒。如果 HTTP API 在 5 秒内没有收到任何请求，HTTP 的 TCP 连接就会被 EMQX 关闭。此改动将 HTTP API 的 idle_timeout 改为 60 秒。

• 改进某些配置字段和选项的描述。

  • 改进 Webhook 资源和动作中，关于 Base URL 和 Path 两个参数详情的描述。
  • 改进热配置中 WS/WSS 监听器的 idle_timeout 配置的描述。
  • 改进离线消息相关动作中，关于 Max Returned Count 参数的详细描述。
  • 将 ClickHouse 资源的英文参数 Key 改名为 Password。
  • 将 HStreamDB 动作中的 PartitionKey 参数改名为 Partition Key。
  • 将 Retainer 模块的 最大保留消息大小 参数的详细描述中的 0B 改为 0。
  • 将 Retainer 模块中的 拦截清理消息 改名为 拦截空消息，并改进其描述。

• 检查某些配置项的取值范围和合法性。

  • 检查 mqtt.max_topic_levels，mqtt.max_packet_size，keepalive_backoff 配置项，须为非负值。
  • 在启动 SSL 监听器时，检查 verify_peer，fail_if_no_peer_cert 以及 cacertfile 参数的依赖关系。此前只会在 SSL 客户端尝试建立连接时检查。
  • 检查监听器配置的 acceptors，max_connections，max_conn_rate，active_n 参数，须为非负值。
  • 检查 RabbitMQ 资源的 心跳间隔 和 自动重连间隔 参数，须为正确的时间长度字符串。
  • 修复 GB/T 32960、JT/T808 监听器未校验重复端口的问题。
  • 修复 GB/T 32960、JT/T808 网关配置中，对某些参数的取值未作校验的问题。

• 优化日志格式和 Dashboard 上的一些展示问题。

  • Dashboard 上规则引擎的速率值偶尔出现非常长的浮点数，改进后精确到小数点后两位。
  • 系统资源使用率的告警信息中，CPU 使用率的值精确到小数点后两位。
  • 从日志中去掉 mfa 等调试字段。

• 规则引擎支持用户自定义的 SQL 函数。

  假设用户定制的插件里包含一个名为 emqx_rule_funcs1 的模块，且该模块包含一个名为 func 的函数，那么规则引擎中，用户可以这样使用它：

  SELECT emqx_rule_funcs1.func() FROM "t/#"

  请注意模块名必须以 emqx_rule_funcs 或者 EmqxRuleFuncs 为前缀。

• Kafka 消费组模块支持更多的认证方式。

  现在 Kafka 消费组模块跟 Kafka 资源一样，也支持 PLAIN，SCRAM_SHA_256，KERBEROS 多种认证方式了。

• 为某些较为消耗系统资源的 HTTP API 增加了过载保护。

  • GET /api/v4/clients/* 相关接口
  • GET /api/v4/routes 接口
  • GET /api/v4/subscriptions 接口
  • GET /api/v4/rules 接口
  • GET /api/v4/banned 接口
  • GET /api/v4/audits 接口
  • 内置认证模块里用于搜索用户名和客户端 ID 的接口。

修复

• 修复规则引擎 date_to_unix_ts() SQL 函数在输入日期为闰年时将返回错误数值的问题。

• 在节点疏散期间，疏散所有连接已断开的会话，而不仅仅是那些以 clean_start = false 启动的会话。

  修复前，如果客户端设置了 clean_start = true 和非零的 Session-Expiry-Interval，那么该会话不会被疏散，这将导致会话在节点关闭之后丢失。

• 修复从 Redis 中找不到对应的认证信息时，Redis 认证异常的问题。

• 修复在 EMQX 节点启动过程中访问 HTTP API 时，ETS 表为初始化导致的异常。

• 修复某些情况下加载扩展插件失败的问题。

  plugins.expand_plugins_dir 配置可以指定一个目录，EMQX 在启动时会查找并加载该目录下的插件。 在某些情况下，插件文件可能会被重复加载，导致 EMQX 无法启动。

• 修复无法使用命令行清除单个客户端的 ACL 缓存的问题。

  此前这个命令不起作用：emqx ctl acl cache-clean 'mqttx_458d5222'。

• 修复在规则列表、内置认证/鉴权列表页面执行模糊搜索时，无法展示更多分页，导致数据展示不全的问题。

• 修复尝试下载处于 “等待开始” 状态的追踪日志文件时，EMQX 打印的错误日志不准确的问题。

• 修复首次使用热配置功能更新 SSL 监听器的配置时，backlog 配置项显示为空且为必选字段，导致无法表单提交的问题。

  修复后，将 backlog 配置改为可选，默认值为 1024。

• 修复配置的 emqx.schema 文件中，与 zone 相关的 validators 不生效的问题。

• 修复审计日志查询 API 的返回中，即使所查信息的 HTTP Status Code 为 500 时，operation_result 字段仍是 success 的问题。

• 修复 Dashboard 上 GB/T 32960 客户端 ID 重复的问题。

4.4.23

发布日期: 2023-11-24

增强

• 提升 EMQX 节点间消息发送的性能。

  gen_rpc 是 EMQX 内部用于节点间发送 MQTT 消息的 RPC 通道。此次改进中我们优化了 gen_rpc 对通道中积压消息的处理能力，从而使系统更快地从流量高峰中恢复。

修复

• 修复规则引擎无法连接到 upstash Redis 的问题。

  修复前，在与 Redis 服务建立 TCP 连接之后，emqx 的 redis 驱动程序使用 Inline Commands 来发送 AUTH 和 SELECT 命令。但 upstash Redis 服务不支持 Inline Commands，导致规则引擎无法连接到 upstash Redis 服务。 修复后，emqx 的 redis 驱动程序使用 RESP (REdis Serialization Protocol) 来发送 AUTH 和 SELECT 命令。

• 为 "离线消息保存到 Redis" 动作和 Redis 资源的某些参数增加了合法性校验。

  • 校验 "离线消息保存到 Redis" 动作的 "Redis Key 超期时间" 参数。
  • 校验 Redis 资源的 "Redis 数据库" 参数。

4.4.22

发布日期: 2023-11-01

增强

• 新增 Dashboard 的审计日志（Audit Log）功能，用以追踪重要的变更性操作。

  • 要启用审计日志功能，在 Dashboard 中点击 通用 -> 审计日志 -> 启用，修改参数并点击添加。
  • 开启后会记录所有除 GET 之外的 HTTP API 请求以及命令行（CLI）的执行情况。
  • 在 Dashboard 审计日志界面上默认可查看到最近的 5000 条审计日志，完全的日志文件则储存在 data/audit 目录中。

• 在 Dashboard 中增加了对 RBAC 角色的支持。实现了基于角色的访问控制(RBAC)的功能，用于访问管理 Dashboard。

  这使得能够在管理员和查看者角色类型之间进行区分，以实施适当的权限。 管理员能通过 Dashboard 查看和修改所有功能，而查看者只能查询，无法对功能进行修改。

• LwM2M 网关支持使用块传输协议（Block Wise Transfer）发送下行数据。

• 新增一些 SQL 函数。

  新增的函数有：map_keys(), map_values(), map_to_entries(), join_to_string(), join_to_string(), join_to_sql_values_string(), is_null_var(), is_not_null_var().

  函数的作用和使用方法详见文档。

• 为 MQTT 桥接动作增加 QoS 配置项，用于指定桥接消息的 QoS 等级。

• 支持通过配置文件指定 MQTT 消息的过期时间。

  详见 emqx.conf 文件中对 mqtt.message_expiry_interval 配置的描述。

• 更新 Erlang/OTP 的版本到 OTP-24.3.4.2-4。

• 新增 Schema 验证，以便更好地配置 OCSP Stapling 和 CRL 检查一致性。

修复

• 解决了导致 Kafka 客户端（wolff）生产者崩溃的问题。

  这个问题是在初始化某些规则时删除了 Kafka 资源，从而导致依赖规则失败。 这个错误随后传播，触发了错误升级机制，导致所有规则崩溃。

• 修复了 GBT32960 网关模块无法解析 retry_interval 参数的问题。

• 修复了 GBT32960 客户端无法在通过 HTTP API 获取的问题。

• 修复了 OCPP 客户端在认证失败时的异常日志。

• 修复了 OCPP 网关未对 ClientID 为空的校验问题。

• 升级了 RabbitMQ 驱动程序，并修复了一些安全漏洞。

• 修复规则引擎的 GCP PubSub 动作在异步发送模式下，统计计数不增长的问题。

• 修复手动重连资源时，只有当前节点的资源会执行重连的问题。

• 修复删除规则重新导入后，动作的统计计数没有清零的问题。

• 修复集群模式下重启规则失败导致的动作资源泄露的问题。

  修复前，停止并启动规则时，如果某些节点上的动作创建失败，会导致动作资源（该动作关联的一些进程）泄露。

• 修复了多 CPU 场景下，某些带批量模式的数据集成动作，批量发送数据的性能比 4.4.5 之前的版本有所下降的问题。

  4.4.5 版本将批量进程池的工作进程数目修改为 CPU 核心数 * 4，在 CPU 核心数比较多的机器上运行时，会导致工作进程数过多，所以每个进程在指定批量时间内累积的消息比较少，从而使得批量发送数据的性能下降。修复后不再硬编码批量进程池的工作进程数目，而是提供了一个新的配置项 batch_pool_size，默认值为 8。

  受影响的数据集成动作: data_to_cassa, data_to_clickhouse, data_to_influxdb, data_to_iotdb, data_to_lindorm, data_to_mysql, data_to_oracle, data_to_pgsql, data_to_sqlserver, data_to_tablestore, data_to_tdengine, data_to_gcp_pubsub。

• 修复 MQTT 桥接使用 MQTT 5.0 协议发送 QoS2 消息失败的问题。

• 修复当配置文件中某个监听器的配置缺失时，热配置更新失败的问题。

• 修复 LwM2M 网关插件启动失败的问题。

  修复前，若先关闭 LwM2M 模块然后启动 LwM2M 插件，会导致插件启动失败，日志如下：

  {emqx_lwm2m,{bad_return,{{emqx_lwm2m_app,start,[normal,[]]},{'EXIT',{{already_started,<0.3895.177>},[...]}}}}}

• 修复 Dashboard 上共享订阅主题的前缀无法正常展示的问题。

  修复前，$share/g//t 这样的主题会在 Dashboard 的客户端详情页面上展示为 /t，共享订阅前缀丢失。 修复后，将正常展示为 $share/g//t。

• 在配置文件中，为 peer_cert_as_username 和 peer_cert_as_clientid 增加一个 none 选项。这两个配置项用于将（客户端）证书内容作为用户名/ ClientID。

• 修复启用热配置功能，会偶现监听器被重启的问题。

• 修复停止正在运行中的规则时出错的问题。

  修复前，若手动停止正在运行中的规则，会偶尔出现如下错误日志，提示动作没有正常初始化或者已经被清除：

  foo@x.x.x.x:54663 Rule: <<"rule:ba48182b">>; Action: data_to_kafka; Resource: <<"resource:7bacacdc">>. Continue next action, reason: {error,{badmatch,not_found}, ...

  修复后这种情况下不再打印错误日志，并且优化了其他情况下出现动作未初始化时的错误日志。

• 修复 LwM2M 网关 DTLS PSK 握手失败的问题。

• 检查 Retainer 模块配置的非法字段。

  添加了对 “最大保留消息数” 和 “最大保留消息大小“ 两个字段的检查，确保为非负值。

• 修复热更新之后发送消息到 TDEngine 失败的问题。

• 修复热更新之后 RabbitMQ 资源不可用的问题。

• 当禁用 OCSP Stapling 或停止 TLS 监听器时，一并取消 OCSP 的 HTTP 定时刷新。

• 当禁用 CRL 检查或停止 TLS 监听器时，一并取消 CRL 的定时刷新。

4.4.21

发布日期: 2023-10-16

增强

• 添加了对 Confluent 数据桥的支持。

• 现在 Kafka 消费组里的 MQTT 主题字段支持包含占位符的模板。

  比如 Kafka 消费到消息里 key 为 "a"，配置的 MQTT 主题为 "topic/${key}"，那么在消息转发的时，MQTT 主题会被替换为 "topic/a"。

• 现在 “消息重发布” 动作支持添加 “MQTT 属性” 和 “用户属性”。

  “消息重发布” 动作支持两个新的字段："MQTT 属性" 和 "用户属性"，都是键值对的格式，并且键和值都支持占位符。

修复

• 修复 Kafka 动作无法将数字类型的值作为 Kafka Headers 发送的问题。

  修复之前，当 “Kafka Headers 值的编码类型” 设置为 "NONE" 的情况下，如果 "Kafka Headers" 字段里包含了带有数字类型的 JSON 对象（比如 {"a": 1, "b": "str"}），数字类型的值（"a":1）将会被忽略，不会被发送到 Kafka。修复之后 JSON 中的数字类型会先转换为字符串再发送到 Kafka。

4.4.20

发布日期: 2023-08-01

增强

• 提升发送数据到 Kafka 和 HStreamDB 的性能。

  此改进在驱动进程的前面增加了一个 Erlang 消息缓冲区，虽然以增加消息时延为代价，但减少了 EMQX 内部的消息传递频率、提升了发送数据到 Kafka 和 HStreamDB 的吞吐能力。

  现在，EMQX 发送到 Kafka 或 HStreamDB 驱动的消息会先进入到缓冲区，当缓存的消息数量达到 message_accumulation_size 或时间间隔达到 message_accumulation_interval 时，才会批量地将缓冲区中的消息发送到 Kafka 或 HStreamDB 驱动，然后再由驱动发送到 Kafka 或 HStreamDB 服务。设置 message_accumulation_size = 0 (默认值) 将关闭这个消息缓冲功能。

• 为 SQL Server 资源增加 auto_reconnect 选项。

  改进前，当 EMQX 与 SQL Server 数据库之间的连接断开时，EMQX 无法自动重连。改进后 EMQX 将会自动重连，用户可以通过设置 auto_reconnect = false 来关闭自动重连功能。

• 为 RabbitMQ 资源添加了 TLS 连接支持。

• 为 GCP PubSub 动作添加属性和排序键的支持。

修复

• 修复了无法在 Dashboard 上测试规则引擎的 mongo_date() 函数的问题。

  改进之前，mongo_date() 可以正常使用，但在 Dashboard 的 SQL 测试页面进行测试时会出现错误。

• 修复了热升级到 4.4.19 之后，规则引擎通过 RabbitMQ 动作发送消息失败的问题。

4.4.19

发布日期: 2023-06-27

增强

• 为 MQTT/TCP 和 MQTT/SSL 监听器增加 TCP Keep Alive 的支持 #10854。

  现在增加了一个配置项：zone.<zone-name>.tcp_keepalive = Idle,Interval,Probes，用户可以通过此配置来启用 TCP 层的 Keep Alive 功能并指定时间参数。此配置仅在 Linux 和 MacOS 系统上生效。

• 改进 Proxy Protocol 相关的错误日志 emqx/esockd#177。

  改进之前的日志样例:

  2023-04-20T14:56:51.671735+08:00 [error] supervisor: 'esockd_connection_sup - <0.2537.0>', errorContext: connection_shutdown, reason: {invalid_proxy_info,<<"f\n">>}, offender: [{pid,<0.3192.0>},{name,connection},{mfargs,{...}}]
  
  2023-04-20T14:57:01.348275+08:00 [error] supervisor: 'esockd_connection_sup - <0.2537.0>', errorContext: connection_shutdown, reason: {proxy_proto_timeout,5000}, offender: [{pid,<0.3194.0>},{name,connection},{mfargs,{...}}]

  改进之后:

  2023-04-20T18:07:06.180134+08:00 [error] [esockd_proxy_protocol] The listener 127.0.0.1:8883 is working in proxy protocol mode, but received invalid proxy_protocol header, raw_bytes=<<"f\n">>
  
  2023-04-20T18:10:17.205436+08:00 [error] [esockd_proxy_protocol] The listener 127.0.0.1:8883 is working in proxy protocol mode, but timed out while waiting for proxy_protocol header

• 增加了一个新功能，用户可以在 TLS 监听器中启用“部分证书链验证” #10553。

  详情请查看 listeners.conf 配置文件中的 listener.ssl.external.partial_chain 配置项。

• 增加了一个新功能，用户可以在 TLS 监听器中启用“客户端证书扩展密钥用途验证” #10669。

  详情请查看 listeners.conf 配置文件中的 listener.ssl.external.verify_peer_ext_key_usage 配置项。

• 在 HTTP API /api/v4/nodes 的返回中增加 live_connections 字段 #10859。

  此前该接口中有一个 connections 字段，它代表当前节点上会话未过期的连接数量。这意味着即使 MQTT 连接已经断开，只要客户端保持了会话，它仍然会被统计在 connections 中。新增的 live_connections 字段则仅仅统计 MQTT 连接未断开的客户端数量。

• 规则引擎新增了三个随机函数 #11113。

  • random()：生成 0 到 1 之间的随机数 (0.0 =< X < 1.0)。
  • uuid_v4()：生成随机的 UUID (version4) 字符串。
  • uuid_v4_no_hyphen()：生成随机的不带连词符的 UUID (version4) 字符串。

• 为 mqtt.max_clientid_len 配置项增加数值范围校验 (23-65535) #11096。

• 新增插件 emqx_gcp_device。该插件简化了从 Google IoT Core 的迁移过程：

  • 允许导入 Google IoT Core 设备配置和认证数据。
  • 实现了与 Google IoT Core 兼容的 MQTT 认证。
  • 提供了用于管理设备配置和认证数据的 API 接口。

• 支持使用动态的 Routing Key 创建 RabbitMQ 动作。

  现在 RabbitMQ 动作的 "RabbitMQ Routing Key" 参数可以使用 ${key} 格式的动态变量。

• DynamoDB 资源支持默认端口。

  此前 DynamoDB 资源的 “DynamoDB 服务器” 参数中必须填写带端口号的 URL，否则会资源会创建失败。 现在如果 URL 不带端口号，缺省值为 80 (HTTP) 或者 443 (HTTPS)。

修复

• 修复规则引擎无法在 DO 子句中访问 FOREACH 导出的变量的问题 #10620。

  给定消息：{"date": "2023-05-06", "array": ["a"]}，以及如下 SQL 语句：

  FOREACH payload.date as date, payload.array as elem
  DO date, elem
  FROM "t/#"

  修复前，以上 SQL 语句中 FOREACH 导出的 date 变量无法在 DO 子句中访问，导致以上 SQL 的输出为： [{"elem": "a","date": "undefined"}]。 修复后，SQL 的输出为：[{"elem": "a","date": "2023-05-06"}]

• 修复在某些情况下规则的缓存没有更新到某些节点上的问题 #11072。

  修复前，手动更新规则之后，可能会出现缓存的更新没能同步到某些节点上的情况，这会导致规则在不同的节点上运行状态不一致。

• 修复 WebHook 插件执行 on_client_connack 钩子失败的问题 #10710。

  详见 https://github.com/emqx/emqx/issues/10628

• 修复认证模块断线重连相关的问题。

  在启动 EMQX 的时候，如果认证模块与数据库之间的连接处于断开状态，认证模块会周期性发起重连。 修复前，即使手动禁用该模块，EMQX 仍然会周期性重连数据库。修复后仅仅当模块启用的时候尝试重连。

• 修复 PgSQL 认证模块重连后 Prepared Statement 丢失的问题。

  修复前，如果 PgSQL 认证模块与数据库之间的连接发生过断开并重连，会因为 Prepared Statement 丢失而导致认证失败，并打印如下错误日志：

  2023-03-30T20:50:48.088416+08:00 [error] abc@124.79.220.151:58561 [Postgres] query '"auth_query"' failed: {error,error,<<"26000">>,invalid_sql_statement_name,<<"prepared statement \"auth_query\" does not exist">>,[...]}

• 修复从 4.4.9 版本导入 Kafka 资源后连接失败的问题。

  修复前，从 4.4.9 版本导入数据到 4.4.18，如果导入之前 Kafka 资源未配置用户名密码（即认证模式是 NONE），导入后 EMQX 可能会错误地使用 PLAIN 认证模式连接 Kafka，从而导认证失败。

• 修复 EMQX docker 容器无法使用 Kerberos 认证方式集成 Kafka 的问题。

  修复前，EMQX 的 docker (alpine) 镜像缺失了 libsasl 和 cyrus-sasl-gssapiv2 两个软件包，导致 Kerberos 功能无法正常使用，错误日志：

  2023-06-15T05:30:31.148811+00:00 [warning] ...,{connect_kafka_server_fail,[{<<"kafka-a:9092">>,{{not_loaded,[{module,sasl_auth},{line,212},{on_load_error_info,{error,{load_failed,"Failed to load NIF library: 'Error loading shared library libsasl2.so.3: No such file or directory (needed by /opt/emqx/lib/sasl_auth-2.0.1/priv/sasl_auth.so)'"}

• 修复规则引擎 RocketMQ 动作的数据分发逻辑。

  修复前，在 EMQX 发送数据到主从模式的 RocketMQ 集群的场景中，如果 RocketMQ 集群有多个主节点，那么无论使用 roundrobin 还是 key_dispatch 策略，消息总是会被分发到第一个 RocketMQ 主节点上。

• 修复重启或加入集群后模块顺序改变的问题。

  修复前，在节点重启或者加入集群之后，模块的顺序可能会发生改变，如果启用了多个认证模块，会导致认证链的顺序发生改变。

• 修复从 4.4.7 导入监听器配置失败的问题。

  修复前，如果 JSON 文件中包含 "wss" 或 "wss" 监听器的配置，导入可能会由于 fail_if_no_subprotocol 配置项的类型不兼容而导入失败，但没有任何错误提示和日志。

• 修复新节点加入集群后热配置不生效的问题。

  修复前，当节点加入一个已启用热配置的集群时，可以成功从集群复制热配置，但配置没有在运行时生效。

• 修复 OCPP 网关的 WebSocket 下行消息类型错误的问题。

  OCPP 网管的 WebSocket 下行消息应该为 text，而不是修复前的 binary。

• 修复当配置了监听器仅使用 TLS v1.3 协议的情况下，MQTT 客户端无法连接的问题。

  之前的问题是 EMQX 监听器在建立 TLS 连接时，使用了与 TLS v1.3 不兼容的参数项。

• 修复热升级后 retainer 模块报错的问题。

  从旧版本版本 (e4.4.0 ~ e4.4.16) 升级到 e4.4.17 或 e4.4.18 之后，retainer 模块可能会报错，导致 retain 消息无法正常发送，错误日志如下：

  2023-05-17T01:48:44.515012+00:00 [error] mqtt_conti@62.93.210.184:54851 [Hooks] Failed to execute {fun emqx_retainer:on_session_subscribed/3,[]}: {error,badarg,[...]}

• 修复 RabbitMQ 测试连接可用性时出现错误日志的问题。

  修复前，在点击 RabbitMQ 资源的测试按钮时，会打印如下错误日志 (仅出现错误日志，功能未受影响)：

  2023-06-02T05:59:16.025229+00:00 [error] Destroy Resource bridge_rabbit failed, ResId: <<"_probe_:6edc3a76">>, not_found

• 修复连续点击 Dashboard 设置页面上的启用按钮时，会导致创建出多个重复的热配置模块的问题。

4.4.18

发布日期: 2023-04-28

增强

• 新增 emqx_ocpp 插件，支持 OCPP 1.6-J 协议连接 。

  OCPP（Open Charge Point Protocol）是用于电动汽车充电站和中央管理系统之间的通信协议。该插件作为 EMQX 的 OCPP 协议网关，使充电桩能够通过 OCPP over Websocket 方式接入 EMQX，并进行 OCPP 和 MQTT 协议的相互转换。

  您可以通过 emqx_ctl plugins load emqx_ocpp 命令或者 EMQX Dashboard 启动该插件，并使用 ocpp-go 等工具模拟充电桩进行消息收发测试。

• 改进规则引擎的占位符语法。

  规则引擎的动作支持通过占位符语法来动态的填充字符串的内容，占位符语法的格式为 ${key}。 优化前，${key} 中的 key 只能包含字母、数字和下划线。优化后支持任意 UTF8 字符。

修复

• 修复 data/load_plugins 里必选插件缺失的问题。

  修复前，如果手动删除了 data/load_plugins 文件并重启 EMQX，有三个必选的插件没有自动开启：emqx_schema_registry，emqx_eviction_agent，emqx_node_rebalance，并且这三个插件也没有记录到新生成的 data/load_plugins 文件里。

4.4.17

发布日期: 2023-04-13

增强

• 启用了 Proxy Protocol 的监听器在收到 TCP 端口探测时，不再打印错误日志 emqx/esockd#172。

  修复前，如果监听器已启用了代理协议（listener.tcp.external.proxy_protocol=on），但连接在 TCP 握手完成后、接收到代理信息之前断开，则会打印以下错误日志：

  [error] supervisor: 'esockd_connection_sup - <0.3265.0>', errorContext: connection_shutdown, reason: {recv_proxy_info_error,tcp_closed}, offender:

  修复后不再打印任何日志，但仍然可以通过 emqx_ctl listeners 命令来查看错误原因的统计。

• 改进监听器针对文件描述符耗尽的错误日志 emqx/esockd#173。

  改进前的日志：

  [error] Accept error on 0.0.0.0:1883: emfile

  改进后的日志：

  [error] Accept error on 0.0.0.0:1883: EMFILE (Too many open files)

• 提升规则引擎在规则数量较多时的性能 #10283

  改进前，当规则数量较多时，规则引擎将需要耗费大量 CPU 在规则的查询和匹配上，并成为性能瓶颈。 本次优化中，通过简单地给规则列表添加一个缓存，大幅提升了此场景下的规则执行效率。 在我们的测试中，在一个 32 核 32G 的虚拟机上，我们创建了 700 条不执行任何动作的规则（绑定了 "do_nothing" 调试动作）， 并以 1000 条每秒的速度向 EMQX 发送 MQTT 消息（即，规则触发频率为 700 * 1000 次每秒）， 在上述场景下，优化后的规则引擎 CPU 使用率下降到了之前的 55% ~ 60%。

• 改进从旧版本（4.2或更早）导入数据时的告警日志。

  改进前，如果从旧版本（4.2及之前）导入到4.4版本，由于缺少认证类型，内置认证部分的数据将会被丢弃，日志对失败原因的描述不够清楚。 改进后，导入将会失败，并且 EMQX 日志会提示用户改用命令行工具进行数据导入，并指定认证类型：

  $ emqx_ctl data import <filename> --env '{"auth.mnesia.as":"username"}'

修复

• 修复 Erlang distribution 无法使用 TLS 的问题 #9981。

  关于 Erlang distribution, 详见 这里。

• 修复 MQTT 桥接无法验证对端带通配符的 TLS 证书的问题 #10094。

• 修复当 retainer 中积压的消息过多时，EMQX 无法及时清除已掉线的 MQTT 连接信息的问题。#10189。

  修复前，emqx_retainer 插件和 EMQX 连接信息清理任务共用一个进程池，因此， 如果该进程池被大量的 retain 消息下发任务阻塞时，许多已经掉线的 MQTT 连接信息将得不到及时清理。 详见 #9409。 修复后，emqx_retainer 插件使用单独的进程池，从而避免了该问题。

• 修复了 Helm Chart 中模板文件 service-monitor.yaml 路径不正确的问题。#10229

• 当 EMQX 从 4.3 升级至 4.4 版本时，EMQX 会在重启时迁移“内置认证”模块中的 ACL 表。

  修复前，如通过拷贝 data/mnesia/<node-name> 目录的方式将数据从 4.3 版本迁移到 4.4 版本，迁移完成后， 当通过 Dashboard 查看“内置认证”模块时，由于 ACL 表未迁移到新版格式，将出现 500 错误。 注意：此问题仅在模块处于禁用状态时才会出现，用户可通过手动启用模块来解决。 修复后，EMQX 将在升级后重启时尝试迁移 ACL 表，从而避免此问题。

• 修复 IoTDB 动作的计数统计错误的问题。

  修复前，如果所有物理量（Measurement）都为 null，IoTDB 会将其忽略，不插入任何数据但会返回 200 OK，造成递增发送成功计数错误。 修复后，当所有物理量都为 null 时，IoTDB 动作将丢弃此请求，并按照发送失败计数。

• 修复当 TDEngine SQL 语句中带有换行符时，创建规则会失败的问题。

  修复前，TDEngine SQL 语句不能包含换行符，例如，当使用如下语句作为 TDEngine 动作的 SQL 模板 参数时，创建规则将会失败：

  INSERT INTO ${devid}
  USING
    tsdb.profit
  TAGS
    ('${custid}', '${devid}')
  VALUES (${ts}, ${value})

• 修复 HTTP API /load_rebalance/:node/start 返回的错误信息没有被正确编码的问题。

• 修复 EMQX 中 RocketMQ 客户端的进程泄漏问题 rocketmq-client-erl#24。

  EMQX 的 RocketMQ 客户端会周期性获取 RocketMQ 的节点信息，并检查节点信息是否有更新，并根据返回结果更新或者添加生产者进程。 修复前，由于对比节点信息的方法有问题，某些情况下会造成进程泄漏问题。

4.4.16

发布日期: 2023-03-10

本次版本更新包含了 4 个增强和 7 个修复。

增强

• 改进 IoTDB 资源的日志输出。 之前如果配置的 iotdb_version 字段跟安装的 IoTDB 版本不一样，发送消息到 IoTDB 会出错，但从日志很难看出原因。 在这个改动之后，会打印更加易读的日志提示用户他可能配置了错误的 iotdb_version。

• 在离线消息动作收到 QoS0 的消息时，不再打印错误日志。

• 从命令行的输出里和插件的名字中，把 "EMQX" 改成 "EMQX"。

修复

• 在版本热升级的时候自动开启 emqx_schema_registry 插件。 当使用规则解码序列化的二进制数据（比如 protobuf 或 avro）的时候，emqx_schema_registry 插件是必须的。 在 EMQX 企业版里，我们需要保证这个插件是启动的。

• 修复 RocketMQ 动作的 message_key 参数不起作用的问题。

• 修复规则在处理解码后的 protobuf 消息时失败的问题。 在此修复之前，如果 protobuf schema 包含 oneof 定义，则在尝试将解码消息解析为 JSON 字符串时，规则可能会失败。

• 修复将 JSON 对象作为 Kafka Headers 发送失败的问题。

• 清除资源或模块产生的临时文件目录。 在此修复之前，有时在删除资源或模块后，data/rules 和 data/modules 下面的子目录无法自动清除。

• 修复 HStreamDB 资源字段描述中的一些问题。

• 避免打印 debug 日志的时候改动 MQTT 消息的 Payload 的内容 #10091。 在这个修复之前，如果 EMQX 收到一个 Payload 为 "e\ne\nc\nc\n2\n\n\n" 的消息，日志打印会变成这样：

  2023-03-08T13:28:04.320622+08:00 [debug] mqttx_e34bd582@127.0.0.1:54020 [MQTT] RECV PUBLISH(Q1, R0, D0, Topic=t/1, PacketId=39467, Payload=e, e, c, c, 2, , , )

  这是此修复之后的样子：

  2023-03-08T14:26:50.935575+08:00 [debug] mqttx_e34bd582@127.0.0.1:54020 [MQTT] RECV PUBLISH(Q1, R0, D0, Topic=t/1, PacketId=39467, Payload=<<"e\ne\nc\nc\n2\n\n\n">>)

4.4.15

发布日期: 2023-03-03

本次版本更新包含了 16 个增强和 20 个修复。比较重要的功能增强有：

• 升级 EMQX 的 MongoDB 客户端库，支持 MongoDB 5.1 及以上版本。
• Dashboard 支持 HAProxy 的 Proxy Protocol。
• 发布 Ubuntu 22.04 安装包。
• 规则引擎支持 Kafka headers。
• 支持使用规则引擎写入数据到 IoTDB。

增强

• 规则引擎支持 Kafka headers。

• 支持使用规则引擎写入数据到 IoTDB。

• JT/T 808 兼容非标准的位置上报报文。在用户使用保留 ID 来上报位置时 EMQX 会将其按 Base64 的格式透传，而不是断开客户端连接。

• 在 emqx_modules 应用程序启动时，仅仅在本地创建 EMQX 模块。 在此之前，当 emqx_modules 应用程序启动时，我们向所有节点发送 RPC 以创建或重新创建模块，因此最终我们在所有节点上创建了 N^2 次模块（每个节点上创建N次）。

• 改进当 DynamoDB 动作找不到 hash_key 或者 range_key 时的错误日志打印。

• HStreamDB 驱动程序更新以支持 HStreamDB ~> 0.12.0。

• 编解码插件将作为规则引擎的可选功能默认启用。

• 添加了 TLS 连接 HStreamDB 支持。

• MongoDB 库已升级至支持 MongoDB 5.1 及以上版本 #9707。

• 现在 Dashboard 支持 HAProxy 的 Proxy Protocol 了 9803。

• 发布 Ubuntu 22.04 安装包 #9831。

• 增强 封禁 和 延迟消息 这两个功能的集成性 #9790。 现在发送延迟消息前，会先检查消息的来源客户端是否被封禁了，如果是，这条延迟消息将会被忽略。

• 增强 保留消息 的安全性 #9790。 现在投递保留消息前，会先过滤掉来源客户端被封禁了的那些消息。

• 现在客户端通过 clientid 被封禁时将会踢掉对应的会话 #9904。

• 为认证和授权添加了更多调试日志 #9943。

• 将统计数据 live_connections.count 和 live_connections.max 公开给 Prometheus #9929。

修复

• 修复 tlsv1.3 在模块（Stomp 网关、GB/T 32960 网关、JT/T808 网关、扩展协议、TCP 网关、MQTT 订阅者）的 tls_versions 标签中缺失的问题。

• 修复使用 Redis 离线消息功能时，EMQX 以相反顺序向客户端发送离线消息的问题。

• 修复 EMQX 重启之后，初始化失败的模块被禁用的问题。

• 修复资源和动作里的一些描述错误。

• 修复热升级后，Oracle 资源没有办法自动重连的问题。

• 修复通过规则引擎发送消息到 RocketMQ 集群失败的问题。

• 在集群中使用 API 创建已存在的监听器时返回失败。

• 在 资源/模块/编解码 删除时清理其文件目录以防止文件泄露。

• 修复使用 消息重发布 动作转发带 User-Property 的 MQTT 消息时出错的问题 #9942。

• 修复资源、动作以及模块里的一些描述错误 #9931。

• 修复请求 JWKS 服务失败的时候，没有日志打印的问题 #9931。

• 使用 HTTP API GET /api/v4/clients?_page=2&_limit=20 请求客户端列表时，请求发送到不同的 EMQX 节点，返回的客户端列表可能不一致 #9926。

• 修复版本热升级之后，新的 MQTT TLS 连接建立失败的问题 #9810。 详情见：emqx/esockd#170

• 修复 MQTT 报文的日志打印格式的问题 #9858。 在此修复之前，固定报文头的标志位（DUP）和后面的可变报文头的字段（ClientId）之间漏掉了一个逗号做分隔：

  2023-01-29T13:40:36.567692+08:00 [debug] 127.0.0.1:50393 [MQTT] RECV CONNECT(Q0, R0, D0ClientId=test_client, ... Password=undefined)

• 修复 CoAP 网关在收到负载均衡的心跳检查报文时产生的崩溃日志 #9869。

• 修复会话关闭后，其持有的排他订阅主题没有被释放的问题 #9868。

• 修复 WebSocket 连接中断时日志报 {case_clause,{error,closed}} 错误的问题 emqx/cowboy#8。

• 修复某些情况下，重启 EMQX 后规则无法自动启用的问题 #9911。

• 修复停止 EMQX 的时候，日志出现 {badarg,[{ets,lookup,[gproc,{shared, ... 错误的问题 #9919。

• 修复当客户端连接禁用 keepalive 时, 通过 HTTP API 更新其 keepalive 会崩溃的问题 #9933。

4.4.14

发布日期: 2023-01-06

增强

• 通过 API 添加、修改 Dashboard 用户时，增加对密码复杂度的要求。现在密码必须包含字母、数字以及特殊字符中的至少 2 种，并且长度范围必须是 8~64 个字符。

修复

• 修复通过 API 添加或者导入 Dashboard 用户时，对密码进行了错误的校验，导致复杂密码添加失败的问题。

• 修复 boostrap_apps_file 文件更新后没有同步更新至数据库,导致文件中新加 apps 未生效。

4.4.13

发布日期: 2023-01-03

修复

• 修复了测试 GCP PubSub 可能泄露内存的问题，以及其 JWT 令牌第二次刷新失败的问题。 #9640

4.4.12

发布日期: 2022-12-29

该版本包含了一个振奋人心的新功能：集群负载重平衡。 新增的 emqx_ctl rebalance 命令可以很好的支持如下两个通用场景：

• 如果大多数客户端都保持长连接，新加入集群，或新启重过的节点在很长一段时间内都会处于低负载状态。
• 因为维护需要重启节点的话，直接关闭服务会导致所有连接到该节点的客户端在短时间内重连，在重连过程中这会增加集群负载，影响稳定性。而且在该节点的持久会话也会丢失。

有了这个新功能之后，可以使用 rebalance 命令来触发客户端重连以达到负载均衡的目的。使用 --evacuation 选项时，则可以确保在重启服务前所有的客户端都已经迁移到了其他节点。

增强

• 为主题重写模块增加主题合法性检查，带有通配符的目标主题不允许被发布。

• TDEngine 资源同时支持 TDEngine 2.x 和 3.x 两个版本的 API 返回格式 emqx/tdengine-client-erl#7。 在 HTTP 的返回中，TDEngine 2.x 使用 status 字段来代表请求成功或者失败，而 TDEngine 3.x 改为使用 code 字段。

• TDEngine 资源支持批量发送数据到 TDEngine 子表。

• 在启用规则的时候，Clickhouse 离线消息动作打印了一行 info 级别的日志：Destroyed .. Successfully。

• 现在即使对应的资源没有就绪的情况下，我们也能创建规则。 在此改动之前，如果资源没有连接好，我们就没办法创建规则。在此改动之后可以创建了，但是新创建的规则将处于 禁用 状态。

• 避免离线消息被重复删除。 当订阅者回复消息 PUBACK(Qos1) 或消息 PUBREC(Qos2) 时，EMQX 会将外部数据库中的这条离线消息删除。 但当离线消息和保留消息功能同时启用时，一条 retain = true 的消息会被冗余存储两次 (Retainer 与外部数据库)。 那么重复的 PUBACK 或 PUBREC 将触发两次删除外部数据库中离线消息的行为，并且会使 Rule-SQL 执行成功而使 action-metrics 增加。 在多数情况下这不会产生任何异常或错误，仅有个别数据库在第二次删除时会报告要删除的消息不存在。 此更改后，将避免冗余的离线消息删除操作。

• 用户可以在 EMQX Enterprise Helm Chart 中自定义 service 资源的 externalTrafficPolicy。

• 当控制台创建新用户时，密码格式为 ^[A-Za-z0-9]+[A-Za-z0-9-_]*$。

修复

• 持久会话的 MQTT 客户端重新连接 emqx 之后，未被确认过的 QoS1/QoS2 消息不再周期性重发。 zone.<zone-name>.retry_interval 配置指定了没有被确认过的 QoS1/QoS2 消息的重发间隔，(默认为 30s)。在这个修复之前， 当持久会话的 MQTT 客户端重新连接 emqx 之后，emqx 会将队列中缓存的未被确认过的消息重发一次，但是不会按配置的时间间隔重试。

• 持久会话的 MQTT 客户端断连之后，已经过期的 'awaiting_rel' 队列没有清除。 在这个改动之前，在客户端重连并且发布 QoS2 消息的时候，如果 'awaiting_rel' 队列已满，此客户端会被服务器以 RC_RECEIVE_MAXIMUM_EXCEEDED(0x93) 错误码断开连接，即使这时候 'awaiting_rel' 队列里面的报文 ID 已经过期了。

• RocketMQ 资源的认证功能不能正常工作。 在这个改动里，我们把 access_key, secret_key 以及 security_token 三个配置项字段 从 data_to_rocket 动作挪到了 bridge_rocket 资源的配置中。并且我们为阿里云的 RocketMQ 服务新加了一个 namespace 字段。

• 为 Kafka 动作参数增加检查，确保 Segment Bytes 不会超过 Max Bytes。

• 为 Pulsar 动作参数增加检查，确保 Segment Bytes 不会超过 Max Bytes。

• 解决通过 emqx oracle 资源发送数据时，报 "ORA-01000: maximum open cursors exceeded" 错误的问题。

• 修复了 EMQX Enterprise Helm Chart 部署的一些问题。

  • 修复了 EMQX Enterprise Helm Chart 部署时出现 Discovery error: no such service 错误，导致集群节点发现异常。
  • 修复了 EMQX Enterprise Helm Chart 无法配置 value 为 JSON 类型的 EMQX Enterprise 配置项。

• 修正了一个问题，即导入备份配置后，配置不会在集群的所有节点上重新加载。

• 修正了一个问题，即当从一个不在其中的节点下载备份配置文件时，HTTP API将无法下载该文件。

• 为 Kafka 资源的 SSL 连接配置增加 SNI 字段。

• 修复了 MongoDB 资源在启用认证的情况下，连接过程很慢的问题。

• 修复了在版本热升级之后，EMQX 偶尔会出现资源已断开的告警，并且告警无法自动清除的问题。

• 修复仪表盘中的连接统计：将疏散后的客户端标记为断开连接。

4.4.11

发布日期: 2022-11-26

本次版本更新包含了 23 个增强和 21 个修复。 在这些增强中，下面几个新功能值得重点介绍：

• 规则引擎的数据桥接新增 Google PubSub 的集成。
• 新增 OCSP (Online Certificate Status Protocol) Stapling。
• 新增 CRL (Certificate Revocation List) cache。
• 规则引擎的 Pulsar 数据桥接支持缓存。
• OTP 从 24.1.5-3 升级到了 24.3.4.2-1。
• 新增了 客户端别名的支持，使得定制化认证和授权更加容易实现。

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

增强

• 升级了 Pulsar 客户端到 0.7.0。 升级后，Pulsar 可以配置支持消息缓存，当 Pulsar 服务器暂时下线时 ，EMQX 可以把消息缓存一段（可以配置）时间，等恢复之后继续发送。

  同时也修复了 Pulsar 客户端连接发生异常后的日志，连接参数中的密码和 JWT 等敏感 信息会在日志中进行隐藏。

  注意: 如果 EMQX 从原先的版本升级上来，然后再降级回去，可能会导致一些向 Pulsar 发送消息的飞行窗口中的同步请求超时，导致影响这部分客户端异常下线。

• 为 GCP PubSub 添加了新的规则引擎桥和相应的规则操作。

• 增加了对 OCSP Stapling 和 CRL 检查/缓存的热配置支持。

• 支持在规则引擎的 MongoDB 动作的 Collection 字段里使用 ${var} 格式的占位符。

• 添加针对规则引擎中的 InfluxDB 资源的 host 字段的格式检查；主机字段应该是不包括 scheme 和端口的 IP/域名。 相关的文档更新请查看 emqx/emqx-docs#1368。

• OTP 升级: 从 24.1.5-3 至 24.3.4.2-1 #9265。 重要更新:

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

• 增加了 OCSP stapling 和 CRL 缓存 #9297。

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

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

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

• 检查监听器的 tls_versions 配置值是 tlsv1，tlsv1.1，tlsv1.2，tlsv1.3 中的一个或多个组合 #9260。

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

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

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

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

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

• 基于 JWT 的 ACL 支持 all 动作，指定同时适用于 pub 和 sub 两个动作的规则列表 #9044。

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

• 增强 ACL 模块中的日志安全性，敏感数据将被模糊化 #9242。

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

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

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

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

修复

• 解决从 e4.4.5 以及更早的版本升级 emqx 的时候，Kafka 资源的认证类型从 PLAIN 变成了 NONE 的错误。

• 修复 JWT 认证插件的一个热升级问题。 当从 e4.4.3 或更早的热升级上来时，EMQX 内部一个 Key 管理进程会需要重启，在重启过程中的 JWT 认证请求可能会失败。

• 修正了在 Kafka Consumer 中选择 reset_by_subscriber 偏移重置策略的选项。

• 修复了热配置中的 tls_versions 配置项遗漏了 tlsv1.3 选项的问题。

• 修复了 SQL Server 资源中，无法在 server 字段里使用除 1433 之外的端口的问题。

• Schema-Registry 的 API 在 HTTP 请求 URI 中支持百分号编码的 name。 注意在创建 Schema 时，POST /api/v4/schemas 请求中的 name 字段不应使用百分号编码，因为这是一个 JSON 字段。

• 修复 JWT 认证插件的一个热升级问题。 当从 e4.3.9 或更早的热升级上来时，EMQX 内部一个 Key 管理进程会需要重启，在重启过程中的 JWT 认证请求可能会失败。

• 修复日志追踪模块没开启时，GET Trace 列表接口报错的问题。#9156

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

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

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

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

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

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

• 保留老的 emqx_auth_jwt 模块的接口函数，保障热升级之前添加的回调函数在热升级之后也不会失效 #9144。

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

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

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

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

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

• 关闭管理端口（默认为8081）上对 HTTP API api/v4/emqx_prometheus 的认证，Prometheus 对时序数据抓取不在需要配置认证 #9294。

4.4.10

发布日期: 2022-10-14

增强

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

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

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

• 更严格的 flapping 检测，认证失败等原因也会进行计数 #9045。

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

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

修复

• 修复了 load_modules 被新加入集群的节点重置的问题。 在之前的版本，如果 load_modules 中的默认模块状态改变了，例如从控制台停用， 如果一个带默认配置的节点新加入集群，会导致其他节点同步默认节点的状态，导致原先停用的模块 又被开启。修复后，新节点会尝试从现有集群中最老的那个节点复制一份 loaded_modules 文件 然后再加入集群。

• 自动订阅数据源是外部数据库的情况下，例如 redis，在本次修复前，如果 QoS 不在有效值范围内, 订阅仍然会成功，例如订阅了 QoS = -1，但后续消息发布到这个客户端时，会发生错误。 本次修复尝试将合法范围之外的 QoS 值强制转换到 [0-2] 范围内。

• 修复订阅成功的计数问题。本次修复前，自动订阅数据源是 Redis 时，查询超时后订阅失败仍然被计数为成功。

• 修复规则引擎对 QoS 0 离线消息保存的计数问题。 QoS 0 的消息不会被保存到后端数据库中而是会被丢弃。 在此次修复前，消息虽然被丢弃了，但是保存成功的计数器仍然计数，已修复为失败计数。

• 规则引擎增加 SSL 连接 redis 时的 “是否校验服务器证书” 选项。

• 修复 Redis 资源探活逻辑。本次修复前，Redis 资源连接成功即被认为可用。 本次修复方法是尝试做一个 PING 查询来检查资源是否可用。

• 修复 Redis 集群资源不可用产生大量日志的问题。

• 修复 Redis 集群资源内部 ID 冲突的问题。该冲突可能导致正在使用的资源被删除。

• 所有的密码字段都使用敏感信息遮盖输入框。

• 修复慢订阅追踪模块在 stats_type 为 internal 或 response 时，计算单位使用错误 #8981。

• 修复 HTTP 客户端库启用 SSL 后 Socket 可能会进入 passive 状态 #9145。

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

  • 修复一些其他可能导致密码泄漏的隐患 eredis#19。
  • 修复了 eredis_cluster 中连接池命名冲突的问题 eredis_cluster#22 同时对这个库也进行了密码泄漏隐患对修复。

• 修复共享订阅消息转发逻辑 #9094。

  • QoS2 飞行窗口消息丢弃的日志过度打印问题
  • 对于通配符订阅的消息，会话中缓存的消息重发时，因为使用了发布主题（而非通配符主题）来进行重发， 导致无法匹配到 共享订阅组内的其他成员。

• 修复共享订阅 sticky 策略下，客户端取消订阅后仍然可以收到消息的问题 #9119。 这之前的版本中，仅处理了客户端会话终结，而没有处理取消订阅。

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

• 修复规则引擎的备选（fallback）动作的计数重置失败的问题 #9125。

4.4.9

发布日期: 2022-09-17

增强

• JWT 认证中的 exp、nbf 和 iat 声明支持非整数时间戳

修复

• 修复规则引擎的更新行为，此前会尝试初始化已禁用的规则
• 修复操作系统时间更改导致延迟发布不准确的问题
• 修复 Dashboard 监听器绑定 IP 地址不生效的问题
• 修复 shared_dispatch_ack_enabled 配置为 true 时共享订阅可能陷入死循环的问题
• 修复规则引擎 SQL 对空值进行主题匹配时崩溃的问题

4.4.8

发布日期: 2022-08-29

增强

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

修复

• 修复 client.disconnected 在某些情况下不会触发的问题
• 修复 JWKS 服务未及时就绪时可能导致 JWK 认证模块后续后无法启动的问题
• 修复通过环境变量设置监听器端口将导致无法停止任一监听器的问题
• 修复内置数据库认证未区分客户端 ID 和用户名的认证数据的分页统计的问题
• 修复热升级后模块状态会在 EMQX 重启后重置的问题
• 修复 Redis 驱动进程泄漏的问题
• 修复规则引擎 MQTT 桥接至 AWS IOT 连接超时的问题
• 修复监听器未就绪时 GET /listener 请求崩溃的问题
• 修复 e4.4.1 版本后规则引擎 SQL 中任意变量与空值比较总是返回 false 的问题
• 修复 ExHook 的执行优先级高于规则引擎时，被 ExHook Message Hook 过滤的主题将无法触发规则引擎的问题
• 修复 TDEngine 的写入请求可能因为对端关闭网络连接而失败的问题
• 修复 MQTT-SN 模块除监听器以外的配置都不会生效的问题
• 修复 ExHook 管理进程因 supervisor 关闭超时而被强制杀死的问题
• 修复 ExProto client.connect 钩子中 Client ID 参数未定义的问题
• 修复客户端被踢除时 ExProto 不会触发断开连接事件的问题

4.4.7

发布日期: 2022-08-11

重要变更

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

增强

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

修复

• 修复 ConfigMap 中取消挂载 loaded_modules 文件后，通过 Helm Chart 部署时 EMQX 无法启动的问题

4.4.6

发布日期: 2022-07-29

增强

• 规则引擎支持启用了 ACL 的 RocketMQ
• 支持对规则引擎中的规则进行搜索和分页
• 规则引擎中的 Kafka 现已支持 SASL/SCRAM 认证和 SASL/GSSAPI 认证，注意使用 SASL/GSSAPI 认证前需要安装 cyrus-sasl-gssapi 依赖
• 提供 CLI ./bin/emqx check_conf 以主动检查配置是否正确
• 优化规则引擎中 TDEngine 的写入性能
• 支持在 Dashboard 上清除历史告警
• 优化共享订阅性能
• 规则引擎写入数据到 TDEngine 的动作中新增 db_name 字段以改善对超级表的支持

修复

• 修复规则引擎写入 TDEngine 时动作计数错误的问题
• 修复规则引擎写入 HStreamDB 时进程池大小设置不生效的问题
• 修复启用 GB/T 32960 插件后查询订阅列表报错的问题
• 修复启用热配置的情况下将 4.2 的备份恢复到 4.4 上时配置项不兼容的问题
• 修复热升级后一旦卸载了老版本 EMQX 将无法再次启动的问题
• 修复多语言协议扩展中对 UDP 客户端的保活检查错误导致客户端不会过期的问题
• 修复多语言协议扩展中客户端信息没有及时更新的问题
• 修复热升级到 e4.4.4 及更高版本以后运行时更新 License 不生效的问题
• 修复客户端指定 Clean Session 为 false 重连时，飞行窗口中的共享订阅消息会被尝试重新派发给旧会话进程的问题
• 修复新节点加入集群后没有使用集群 License 的问题
• 修复 emqx_lua_hook 插件无法取消消息发布的问题

4.4.5

发布日期: 2022-06-30

增强

• 规则引擎支持将数据持久化到 HStreamDB
• 规则引擎消息重发布动作中的 QoS 和保留消息标识现在可以使用占位符
• 支持排他订阅，即一个主题只允许存在一个订阅者
• 支持通过 CLI 一键更新集群 License
• 现在 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 在客户端重连时旧的断开连接事件会晚于新的连接事件触发的问题
• 改进 JWT 认证模块在集群环境下对启动状态的判断逻辑
• 延长规则引擎 DynamoDB 资源状态查询超时时间，以避免部分海外资源可能无法使用的问题
• 修复 PostgreSQL 数据存储插件持久化消息和更新消息消费情况时未更新时间戳的问题
• 修复规则引擎没有在创建 Tablestore、Lindorm 和 InfluxDB 资源时检查连接状态的问题
• 修复规则引擎在写入 TDEngine 资源失败时未正确更新计数的问题
• 修复 Cassandra 消息存储插件将保留消息持久化到多个表中导致消息重复的问题
• 修复从 4.3.0 版本之前的版本导出的 Kafka 资源（仅当 Produce 策略设置为 first_key_dispatch 时）无法导入 4.3.0 及以后版本的问题
• 修复主题重写与延迟发布执行顺序不固定的问题，现在固定为优先执行主题重写
• 改进规则引擎持久化数据到 InfluxDB 和 Tablestore 时的空值处理，现在空值将不会被写入
• 修复规则引擎无法编码 MQTT 5.0 用户属性的问题
• 修复客户端使用 MQTT v5.0 以下的协议版本接入时 connack.auth_error 计数不准确的问题
• 修复 LwM2M 和 CoAP 网关的 UDP 监听器无法绑定指定网络接口的问题
• 修复在配置文件中移除默认的 Dashboard 用户后 Dashboard 无法启动的问题
• 修复 client.subscribe 钩子无法拒绝订阅的问题
• 如果 ACL 规则中的占位符没有被替换，则客户端的发布或订阅操作将被拒绝
• 修复启用了 TLS 但实际并没有与 Pulsar 建立 TLS 连接的问题

4.4.4

发布日期: 2022-06-01

增强

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

修复

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

4.4.3

发布日期: 2022-04-18

增强

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

修复

• 修复 TLS 配置项 server_name_indication 设置为 disable 不生效的问题
• 修复 MongoDB 驱动潜在的进程泄漏问题
• 修复通过 CLI 命令修改的 Dashboard 默认用户的密码会在节点离开集群后重置的问题
• 静默 docker-entrypoint.sh 中的 grep 和 sed 命令的运行错误日志
• 修复 API 路径包含 ISO8859-1 转义字符时，备份文件无法被正确删除和下载
• 修复 Redis 驱动在 DNS 解析失败等情况下会引发崩溃的问题
• 修复 MQTT Bridge 插件仅配置订阅主题但未配置 QoS 时无法启动的问题
• 创建规则时如果已经有使用相同 ID 的规则存在，现在规则引擎将报错而不是替换已有规则
• 修复 HTTP 驱动进程池可能无法删除的问题
• 修复模块参数更改报错后无法再次更新的问题
• 修复 Dashboard 中 GB/T 32960 接入网关模块部分字段类型错误问题
• 修复 Kafka、Pulsar 等 Bridge 资源的配置无法更新的问题
• 修复启用匿名认证时 JT/T 808 客户端认证失败的问题

4.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 将继续保留在包名中以保持向后兼容。

增强

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

修复

• 修复 MQTT Subscriber 模块无法使用双向 SSL 连接的问题。
• 修复 PSKFile 模块启动失败的问题。
• 修复 Kafka 消费组 模块无法处理二进制数据的问题。
• 修复日志追踪功能无法停止的问题。
• 修复规则引擎持久化数据到 Oracle 和 Lindorm 的动作（仅限同步操作）执行失败时无法触发备选动作的问题。
• 修复规则引擎数据持久化到 Oracle 失败但成功计数仍然增加的问题。
• 修复部分 zone 配置无法清除的问题。
• 修复部分监控告警配置的修改在重启后失效的问题。
• 修复编解码功能在集群环境下不可用的问题。
• 修复集群环境下 LwM2M 客户端列表查询 API 返回数据错误导致无法访问 LwM2M 网关模块管理页面的问题。
• 修复 JT/T 808 位置报告报文解析错误的问题。
• 修复 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。
• 代理订阅将忽略为空的主题。

4.4.1

发布日期: 2022-02-18

注意: 4.4.1 与 4.3.7 保持同步。

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

重要变更

• 我们在 4.4.1 中修复了 License 总连接数计算的 Bug，License 将正确地检查集群的总连接数，而非错误地仅检查每个节点上的连接数。请计划升级的用户注意此变化可能导致的客户端达到 License 限制而无法连接的可能性。
• 慢订阅功能改进，支持统计消息传输过程中花费的时间，并记录和展示耗时较高的客户端和主题。
• 规则引擎支持 Lindorm 数据库
• 支持客户端级别的消息丢弃统计指标
• 优化 Dashboard 上在线 Trace 日志显示，支持语法高亮

次要变更

• license 连接数预警，默认连接数达到证书允许的 80% 则告警，小于 75% 时解除告警。用户也可在 emqx.conf 中进行自定义：license.connection_high_watermark_alarm , license.connection_low_watermark_alarm
• license 过期预警，当有效期小于 30 天时，会告警提示
• 规则引擎支持为客户端消息异常丢失事件配置规则与动作，以增强用户在这一场景的自定义处理能力
• 改进规则引擎 SQL 匹配执行过程中的相关统计指标
• 客户端模糊搜索支持 *， (，) 等特殊字符
• 改进 ACL 相关统计指标，解决命中 ACL 缓存导致计数不增加的问题
• Webhook 事件通知中新增 connected_at 字段
• 在因持有锁太久而终止客户端状态之前记录客户端状态

修复

• 修复数据导入导出在某些情况下不可用的问题
• Module 更新机制改进，解决更新失败后 Module 不可用的问题
• 修复规则引擎在执行比较大小的语句时候未进行类型检查的问题
• 修复更新规则引擎动作后相关计数清零的问题
• 修复 Metrics 接口默认情况下不返回 client.acl.deny 等认证鉴权指标的问题
• 修复订阅查询接口未返回分页数据的问题
• 修复 STOMP 处理 TCP 粘包时解析失败的问题
• 修复客户端过滤查询时会话创建时间选项不可用的问题
• 修复重启后内存告警可能不会触发的问题
• 修复 emqx_auth_mnesia 插件中存在用户数据时导入数据崩溃的问题

4.4.0

发布日期: 2021-12-21

EMQX 4.4.0 现已正式发布，主要包含以下改动:

重要变更

• 从 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 移除选项卡导航

• 支持配置是否将整型数据以浮点类型写入 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 依赖

修复

• 修复节点间 RPC 调用堵塞导致客户端进程失去响应的问题

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

• 修复 RocketMQ 异步写入时数据乱码问题

• 修复 RocketMQ 统计指标不准的问题

• 修复集群节点数量超过七个时 Dashboard 监控页面的显示错误

• 修复规则引擎保存数据到 MySQL 时可能出现较高失败率的问题

• 修复规则引擎 Clickhouse 离线消息功能不可用的问题

• 修复规则引擎 MongoDB 离线消息功能中 Max Returned Count 选项无法使用的问题

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

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

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

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

• 修复部分热配置失效的问题

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

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

4.3.19

发布日期: 2023-03-03

增强

• 为 Kafka 客户端增加 TCP 保活配置。

• 将用户添加到内部身份验证数据库时改进仪表板中的错误消息。

• 编解码插件将作为规则引擎的可选功能默认启用。

修复

• 修复版本热升级之后，新的 MQTT TLS 连接建立失败的问题。 详情见：emqx/esockd#170

• 修复通过规则引擎发送消息到 RocketMQ 集群失败的问题。

• 修复资源、动作以及模块里的一些描述错误。

• 修复请求 JWKS 服务失败的时候，没有日志打印的问题。

• 修复使用 消息重发布 动作转发带 User-Property 的 MQTT 消息时出错的问题。

• 修复使用 Redis 离线消息功能时，EMQX 以相反顺序向客户端发送离线消息的问题。

• 修复以分页的方式获取 HTPT API 获取客户端列表时，同样的请求发送到不同的 EMQX 节点返回的结果不一致的问题。 在此修改之前，发送 'GET http://localhost:8081/api/v4/clients?_page=1&_limit=1000' 请求 到集群里的不同的 EMQX 节点，将返回不同的客户端列表。

• 当上传许可证时，现在EMQX将总是重新加载许可证，以避免用户用新的内容替换当前的许可证文件的情况。

• 在 emqx_modules 应用程序启动时，仅仅在本地创建 EMQX 模块。 在此之前，当 emqx_modules 应用程序启动时，我们向所有节点发送 RPC 以创建或重新创建模块，因此最终我们在所有节点上创建了 N^2 次模块（每个节点上创建N次）。

• Dashboard 新用户密码格式不再限制为 ^[A-Za-z0-9]+[A-Za-z0-9-_]*$。

• 在集群中使用 API 创建已存在的监听器时返回失败。

• 在 资源/模块/编解码 删除时清理其文件目录以防止文件泄露。

4.3.18

发布日期: 2022-12-29

增强

• 解决通过 emqx oracle 资源发送数据时，报 "ORA-01000: maximum open cursors exceeded" 错误的问题 #1560。

• 支持更多的 PSK 密码套件#1619。

• Erlang/OTP 从 23.3.4.9-3 升级到 23.3.4.18-1 #1660。

修复

• 修正了一个问题，即导入备份配置后，配置不会在集群的所有节点上重新加载。#1486

• 修正了一个问题，即当从一个不在其中的节点下载备份配置文件时，HTTP API将无法下载该文件。 #1486

• 增加对 Kafka 资源配置字段的合法性检查 #1511。 在这个改动之前，创建 Kafka 资源的时候，我们没有对时长、字节大小等类型的字段做合法性检查，即使给这些 字段传入任意的字符串也能创建成功，但在运行时出现错误。

• 避免离线消息被重复删除 #1522。 当订阅者回复消息 PUBACK(Qos1) 或消息 PUBREC(Qos2) 时，EMQX 会将外部数据库中的这条离线消息删除。 但当离线消息和保留消息功能同时启用时，一条 retain = true 的消息会被冗余存储两次 (Retainer 与外部数据库)。 那么重复的 PUBACK 或 PUBREC 将触发两次删除外部数据库中离线消息的行为，并且会使 Rule-SQL 执行成功而使 action-metrics 增加。 在多数情况下这不会产生任何异常或错误，仅有个别数据库在第二次删除时会报告要删除的消息不存在。 此更改后，将避免冗余的离线消息删除操作。

• HTTP 客户端库 ehttpc 从 0.2.1 升级到 0.4.2 #1587。

• 为主题重写模块增加主题合法性检查，带有通配符的目标主题不允许被发布 #1589。

• 在启用规则的时候，Clickhouse 离线消息动作打印了一行 info 级别的日志：Destroyed .. Successfully #1594.

• 现在即使对应的资源没有就绪的情况下，我们也能创建规则 #1620。 在此改动之前，如果资源没有连接好，我们就没办法创建规则。在此改动之后可以创建了，但是新创建的规则将处于 禁用 状态。

• 修复 cluster/invite_node API 缺少节点名时返回 500 的错误 #1531。

• 修正了/load_rebalance/{node}/evacuation/start中错误的rpc错误信息 #1572。

• 修复 mqtt_app 表内没有 boostrap user 里未导入用户的问题 #1600。

• 修正了 /load_rebalance/{node}/evacuation/start 中错误的rpc错误信息 #1572。

• 持久会话的 MQTT 客户端断连之后，已经过期的 'awaiting_rel' 队列没有清除 #1574。 在这个改动之前，在客户端重连并且发布 QoS2 消息的时候，如果 'awaiting_rel' 队列已满，此客户端会被服务器以 RC_RECEIVE_MAXIMUM_EXCEEDED(0x93) 错误码断开连接，即使这时候 'awaiting_rel' 队列里面的报文 ID 已经过期了。

• 当 QoS2 消息被重发(使用相同 Packet ID)，或当 'awaiting_rel' 队列已满时，触发消息丢弃钩子(message.dropped)及计数器 #1605。

• 修复热升级自 e4.3.0..e4.3.10 至 e4.3.11..e4.3.17 导致的规则引擎动作 Data to InfluxDB 无法执行的问题 #1601。

• 为 Kafka 动作参数增加检查，确保 Segment Bytes 不会超过 Max Bytes #1608。

• 为 Pulsar 动作的 duration 和 bytesize 类型的参数增加检查 #1631。

• 持久会话的 MQTT 客户端重新连接 emqx 之后，未被确认过的 QoS1/QoS2 消息不再周期性重发 #1617。 zone.<zone-name>.retry_interval 配置指定了没有被确认过的 QoS1/QoS2 消息的重发间隔，(默认为 30s)。在这个修复之前， 当持久会话的 MQTT 客户端重新连接 emqx 之后，emqx 会将队列中缓存的未被确认过的消息重发一次，但是不会按配置的时间间隔重试。

• RocketMQ 资源的认证功能不能正常工作 #1561。 在这个改动里，我们把 access_key, secret_key 以及 security_token 三个配置项字段 从 data_to_rocket 动作挪到了 bridge_rocket 资源的配置中。并且我们为阿里云的 RocketMQ 服务新加了一个 namespace 字段。

• 当控制台创建新用户时，密码长度必须在 3-32 之间，且格式为 ^[A-Za-z0-9]+[A-Za-z0-9-_]*$ #1599。

• 当创建资源过慢的情况下，有可能会残留一些用来探活的临时的连接 #1641。

• 为 Kafka 资源的 SSL 连接配置增加 SNI 字段 #1647。

• 修复了 MongoDB 资源在启用认证的情况下，连接过程很慢的问题 #1669。

• 修复了在版本热升级之后，EMQX 偶尔会出现资源已断开的告警，并且告警无法自动清除的问题 #1668。

4.3.17

发布日期: 2022-11-26

增强

• 支持在规则引擎的 MongoDB 动作的 Collection 字段里使用 ${var} 格式的占位符 #1503。

• 添加针对规则引擎中的 InfluxDB 资源的 host 字段的格式检查；主机字段应该是不包括 scheme 和端口的 IP/域名 #1426。 相关的文档更新请查看 emqx/emqx-docs#1368。

• 检查监听器的 tls_versions 配置值是 tlsv1，tlsv1.1，tlsv1.2，tlsv1.3 中的一个或多个组合 #9260。

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

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

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

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

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

• 基于 JWT 的 ACL 支持 all 动作，指定同时适用于 pub 和 sub 两个动作的规则列表 #9044。

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

• 增强 ACL 模块中的日志安全性，敏感数据将被模糊化 #9242。

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

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

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

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

修复

• 修正了在 Kafka Consumer 中选择 reset_by_subscriber 偏移重置策略的选项 #1463。

• 修复了热配置中的 tls_versions 配置项遗漏了 tlsv1.3 选项的问题 #1532。

• 修复了 SQL Server 资源中，无法在 server 字段里使用除 1433 之外的端口的问题 #1464。

• Schema-Registry 的 API 在 HTTP 请求 URI 中支持百分号编码的 name #1497。 注意在创建 Schema 时，POST /api/v4/schemas 请求中的 name 字段不应使用百分号编码，因为这是一个 JSON 字段。

• 修复 JWT 认证插件的一个热升级问题 #1554。 当从 e4.3.9 或更早的热升级上来时，EMQX 内部一个 Key 管理进程会需要重启，在重启过程中的 JWT 认证请求可能会失败。

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

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

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

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

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

• 保留老的 emqx_auth_jwt 模块的接口函数，保障热升级之前添加的回调函数在热升级之后也不会失效 #9144。

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

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

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

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

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

• 关闭管理端口（默认为8081）上对 HTTP API api/v4/emqx_prometheus 的认证，Prometheus 对时序数据抓取不在需要配置认证 #9294。

4.3.16

发布日期: 2022-10-14

增强

• 规则引擎增加了更多 Kafka 动作参数的检查。

  • TCP 发送缓存配置不再允许使用空值。
  • 转发策略是 'key_dispatch' 同时 "Key" 设置为 "none" 这个配置组合不再被允许。 如果使用该组合，保存修改时会得到一个修改错误的提示。

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

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

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

• 更严格的 flapping 检测，认证失败等也会进行计数 #9045。

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

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

修复

• 修复了 load_modules 被新加入集群的节点重置的问题。 在之前的版本，如果 load_modules 中的默认模块状态改变了，例如从控制台停用， 如果一个带默认配置的节点新加入集群，会导致其他节点同步默认节点的状态，导致原先停用的模块 又被开启。修复后，新节点会尝试从现有集群中最老的那个节点复制一份 loaded_modules 文件 然后再加入集群。

• 自动订阅数据源是外部数据库的情况下，例如 redis，在本次修复前，如果 QoS 不在有效值范围内, 订阅仍然会成功，例如订阅了 QoS = -1，但后续消息发布到这个客户端时，会发生错误。 本次修复尝试将合法范围之外的 QoS 值强制转换到 [0-2] 范围内。

• 修复订阅成功的计数问题。本次修复前，自动订阅数据源是 Redis 时，查询超时后订阅失败仍然被计数为成功。

• 修复规则引擎对 QoS 0 离线消息保存的计数问题。 QoS 0 的消息不会被保存到后端数据库中而是会被丢弃。 在此次修复前，消息虽然被丢弃了，但是保存成功的计数器仍然计数，已修复为失败计数。

• 规则引擎增加 SSL 连接 Redis 时的 “是否校验服务器证书” 选项。

• 修复 Redis 资源探活逻辑。本次修复前，Redis 资源连接成功即被认为可用。 本次修复方法是尝试做一个 PING 查询来检查资源是否可用。

• 修复 Redis 集群资源不可用产生大量日志的问题。

• 修复 Redis 集群资源内部 ID 冲突的问题。该冲突可能导致正在使用的资源被删除。

• 所有的密码字段都使用敏感信息遮盖输入框。

• 修复 HTTP 客户端库启用 SSL 后 Socket 可能会进入 passive 状态 #9145。

• 隐藏 Redis 客户端错误日志中的密码参数 #9071。 也包含了如下一些改进：

  • 修复一些其他可能导致密码泄漏的隐患 eredis#19。
  • 修复了 eredis_cluster 中连接池命名冲突的问题 eredis_cluster#22 同时对这个库也进行了密码泄漏隐患对修复。

• 修复共享订阅消息转发逻辑 #9094。

  • QoS2 飞行窗口消息丢弃的日志过度打印问题
  • 对于通配符订阅的消息，会话中缓存的消息重发时，因为使用了发布主题（而非通配符主题）来进行重发， 导致无法匹配到 共享订阅组内的其他成员。

• 修复共享订阅 sticky 策略下，客户端取消订阅后仍然可以收到消息的问题 #9119。 这之前的版本中，仅处理了客户端会话终结，而没有处理取消订阅。

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

• 修复规则引擎的备选（fallback）动作的计数重置失败的问题 #9125。

4.3.15

发布日期: 2022-09-17

功能增强

• JWT 认证中的 exp、nbf 和 iat 声明支持非整数时间戳

错误修复

• 修复规则引擎的更新行为，此前会尝试初始化已禁用的规则
• 修复操作系统时间更改导致延迟发布不准确的问题
• 修复 Dashboard 监听器绑定 IP 地址不生效的问题
• 修复 shared_dispatch_ack_enabled 配置为 true 时共享订阅可能陷入死循环的问题
• 修复规则引擎 SQL 对空值进行主题匹配时崩溃的问题

4.3.14

发布日期: 2022-08-29

增强

• 改进 LwM2M 报文解析失败时的日志
• 改进规则引擎错误日志，动作执行失败时的日志中将包含规则 ID
• 改进 loaded_modules 和 loaded_plugins 文件不存在时的提醒日志
• Dashboard 新增修改默认密码的引导
• 改进 Protobuf Schema 文件的导入性能

修复

• 修复 client.disconnected 在某些情况下不会触发的问题
• 修复 JWKS 服务未及时就绪时可能导致 JWK 认证模块后续后无法启动的问题
• 修复通过环境变量设置监听器端口将导致无法停止任一监听器的问题
• 修复内置数据库认证未区分客户端 ID 和用户名的认证数据的分页统计的问题
• 修复热升级后模块状态会在 EMQX 重启后重置的问题
• 修复 Redis 驱动进程泄漏的问题
• 修复规则引擎 MQTT 桥接至 AWS IOT 连接超时的问题
• 修复监听器未就绪时 GET /listener 请求崩溃的问题
• 修复 e4.3.7 版本后规则引擎 SQL 中任意变量与空值比较总是返回 false 的问题
• 修复 ExHook 的执行优先级高于规则引擎时，被 ExHook Message Hook 过滤的主题将无法触发规则引擎的问题
• 修复 TDEngine 的写入请求可能因为对端关闭网络连接而失败的问题
• 修复 MQTT-SN 模块除监听器以外的配置都不会生效的问题
• 修复 ExHook 管理进程因 supervisor 关闭超时而被强制杀死的问题
• 修复 ExProto client.connect 钩子中 Client ID 参数未定义的问题
• 修复客户端被踢除时 ExProto 不会触发断开连接事件的问题

4.3.13

发布日期: 2022-08-11

重要变更

• 升级了使用的 OTP 版本，以解决 OTP Bug 导致的低概率出现随机进程失去响应的问题，建议仍在使用 4.3 的用户升级到此版本
• 从下一版本起，我们将停止对 macOS 10 的支持，转为提供 macOS 11 的安装包

增强

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

修复

• 修复 ConfigMap 中取消挂载 loaded_modules 文件后，通过 Helm Chart 部署时 EMQX 无法启动的问题

4.3.12

发布日期: 2022-07-29

增强

• 规则引擎支持启用了 ACL 的 RocketMQ
• 支持对规则引擎中的规则进行搜索和分页
• 提供 CLI ./bin/emqx check_conf 以主动检查配置是否正确
• 优化规则引擎中 TDEngine 的写入性能
• 优化共享订阅性能
• 规则引擎写入数据到 TDEngine 的动作中新增 db_name 字段以改善对超级表的支持

修复

• 修复规则引擎写入 TDEngine 时动作计数错误的问题
• 修复规则引擎写入 HStreamDB 时进程池大小设置不生效的问题
• 修复启用 GB/T 32960 插件后查询订阅列表报错的问题
• 修复启用热配置的情况下将 4.2 的备份恢复到 4.3 上时配置项不兼容的问题
• 修复热升级后一旦卸载了老版本 EMQX 将无法再次启动的问题
• 修复多语言协议扩展中对 UDP 客户端的保活检查错误导致客户端不会过期的问题
• 修复多语言协议扩展中客户端信息没有及时更新的问题
• 修复热升级到 e4.3.10 及更高版本以后运行时更新 License 不生效的问题
• 修复客户端指定 Clean Session 为 false 重连时，飞行窗口中的共享订阅消息会被尝试重新派发给旧会话进程的问题
• 修复新节点加入集群后没有使用集群 License 的问题
• 修复 emqx_lua_hook 插件无法取消消息发布的问题

4.3.11

发布日期: 2022-06-30

增强

• 规则引擎支持将数据持久化到 HStreamDB
• 规则引擎消息重发布动作中的 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 在客户端重连时旧的断开连接事件会晚于新的连接事件触发的问题
• 改进 JWT 认证模块在集群环境下对启动状态的判断逻辑
• 延长规则引擎 DynamoDB 资源状态查询超时时间，以避免部分海外资源可能无法使用的问题
• 修复 PostgreSQL 数据存储插件持久化消息和更新消息消费情况时未更新时间戳的问题
• 修复规则引擎没有在创建 Tablestore、Lindorm 和 InfluxDB 资源时检查连接状态的问题
• 修复规则引擎在写入 TDEngine 资源失败时未正确更新计数的问题
• 修复 Cassandra 消息存储插件将保留消息持久化到多个表中导致消息重复的问题
• 修复从 4.3.0 版本之前的版本导出的 Kafka 资源（仅当 Produce 策略设置为 first_key_dispatch 时）无法导入 4.3.0 及以后版本的问题
• 修复主题重写与延迟发布执行顺序不固定的问题，现在固定为优先执行主题重写
• 改进规则引擎持久化数据到 InfluxDB 和 Tablestore 时的空值处理，现在空值将不会被写入
• 修复规则引擎无法编码 MQTT 5.0 用户属性的问题
• 修复客户端使用 MQTT v5.0 以下的协议版本接入时 connack.auth_error 计数不准确的问题
• 修复 LwM2M 和 CoAP 网关的 UDP 监听器无法绑定指定网络接口的问题
• 修复在配置文件中移除默认的 Dashboard 用户后 Dashboard 无法启动的问题
• 修复 client.subscribe 钩子无法拒绝订阅的问题
• 如果 ACL 规则中的占位符没有被替换，则客户端的发布或订阅操作将被拒绝
• 修复启用了 TLS 但实际并没有与 Pulsar 建立 TLS 连接的问题

4.3.10

发布日期: 2022-06-01

增强

• 为规则引擎 SQL 增加更多的时间转换函数
• 为规则引擎 SQL 增加 float2str/2 函数，支持指定浮点输出精度
• 规则引擎支持使用 Basic 和 JWT 认证连接 Pulsar
• 规则引擎 Oracle 资源新增 service_name 选项以支持 Oracle Database RAC
• 支持将 JWT 用于鉴权，现在 MQTT 客户端可以使用包含发布订阅白名单的特定声明进行授权
• 改进认证相关指标使更易理解，现在 client.authenticate = client.auth.success + client.auth.failure
• 支持 REST API 的监听器绑定到指定的网络接口上
• 上传 License 将自动同步至整个集群，无需每个节点单独上传，提供 HTTP API
• 支持对使用内置数据库作为数据源的认证鉴权中的用户数据进行多条件查询和模糊查询
• 支持将消息队列长度以及丢弃消息数量作为条件查询客户端
• 支持配置日志时间格式以兼容旧版本中的时间格式
• 当 use_username_as_clientid 配置为 true 且客户端连接时未指定 username，现在将拒绝连接并返回 0x85 原因码
• App secret 从部分随机改为完全随机
• 现在不兼容版本之间的热升级将被拒绝
• 允许 EMQX 的安装路径中有空格
• 引导脚本将在遇到无效的节点名称时快速失败，并提高错误消息的可读性

修复

• 修复使用 PostgreSQL 离线消息插件时客户端上线后获取不到消息的问题
• 修复某些情况下规则引擎无法与 Pulsar 成功建立 TLS 连接的问题
• 修复规则引擎 SQL 函数 hexstr_to_bin/1 无法处理半字节的问题
• 修复规则引擎资源删除时告警未被清除的问题
• 修复 Dashboard HTTPS 监听器的 verify 选项未生效的问题
• 修复共享订阅投递 QoS 1 消息过程中对端会话关闭导致消息丢失的问题
• 修复日志跟踪功能跟踪大报文时堆大小增长过快而触发连接进程强制关闭策略的问题
• 修复模块禁用时未正确卸载相关钩子导致功能异常的问题
• 修复 MQTT-SN 客户端重传 QoS 2 消息时会被断开连接的问题
• 修复备份文件中关闭的模块会在恢复备份后自动启用的问题
• 修复对订阅进行多条件查询时返回结果与查询条件不符的问题
• 修复规则引擎资源连接测试不工作的问题
• 修复多项 Dashboard 显示问题

4.3.9

发布日期: 2022-04-18

增强

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

修复

• 修复 TLS 配置项 server_name_indication 设置为 disable 不生效的问题
• 修复 MongoDB 驱动潜在的进程泄漏问题
• 修复通过 CLI 命令修改的 Dashboard 默认用户的密码会在节点离开集群后重置的问题
• 静默 docker-entrypoint.sh 中的 grep 和 sed 命令的运行错误日志
• 修复 API 路径包含 ISO8859-1 转义字符时，备份文件无法被正确删除和下载
• 修复 Redis 驱动在 DNS 解析失败等情况下会引发崩溃的问题
• 修复 MQTT Bridge 插件仅配置订阅主题但未配置 QoS 时无法启动的问题
• 创建规则时如果已经有使用相同 ID 的规则存在，现在规则引擎将报错而不是替换已有规则
• 修复 HTTP 驱动进程池可能无法删除的问题
• 修复模块参数更改报错后无法再次更新的问题
• 修复 Dashboard 中 GB/T 32960 接入网关模块部分字段类型错误问题
• 修复 Kafka、Pulsar 等 Bridge 资源的配置无法更新的问题
• 修复启用匿名认证时 JT/T 808 客户端认证失败的问题

4.3.8

发布日期: 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 将继续保留在包名中以保持向后兼容。

增强

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

修复

• 修复 MQTT Subscriber 模块无法使用双向 SSL 连接的问题。
• 修复 PSKFile 模块启动失败的问题。
• 修复 Kafka 消费组 模块无法处理二进制数据的问题。
• 修复日志追踪功能无法停止的问题。
• 修复规则引擎持久化数据到 Oracle 和 Lindorm 的动作（仅限同步操作）执行失败时无法触发备选动作的问题。
• 修复规则引擎数据持久化到 Oracle 失败但成功计数仍然增加的问题。
• 修复部分 zone 配置无法清除的问题。
• 修复部分监控告警配置的修改在重启后失效的问题。
• 修复编解码功能在集群环境下不可用的问题。
• 修复集群环境下 LwM2M 客户端列表查询 API 返回数据错误导致无法访问 LwM2M 网关模块管理页面的问题。
• 修复 JT/T 808 位置报告报文解析错误的问题。
• 修复 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。
• 代理订阅将忽略为空的主题。

4.3.7

发布日期: 2022-02-11

重要变更

我们在 4.3.7 中修复了 License 总连接数计算的 Bug，License 将正确地检查集群的总连接数，而非错误地仅检查每个节点上的连接数。

请计划升级的用户注意此变化可能导致的客户端达到 License 限制而无法连接的可能性。

增强

• license 连接数预警，默认连接数达到证书允许的 80% 则告警，小于 75% 时解除告警。用户也可在 emqx.conf 中进行自定义：license.connection_high_watermark_alarm , license.connection_low_watermark_alarm
• license 过期预警，当有效期小于 30 天时，会告警提示
• 规则引擎支持为客户端消息异常丢失事件配置规则与动作，以增强用户在这一场景的自定义处理能力
• 改进规则引擎 SQL 匹配执行过程中的相关统计指标
• 客户端模糊搜索支持 *， (，) 等特殊字符
• 改进 ACL 相关统计指标，解决命中 ACL 缓存导致计数不增加的问题
• Webhook 事件通知中新增 connected_at 字段
• 在因持有锁太久而终止客户端状态之前记录客户端状态

修复

• 修复数据导入导出在某些情况下不可用的问题
• Module 更新机制改进，解决更新失败后 Module 不可用的问题
• 修复规则引擎在执行比较大小的语句时候未进行类型检查的问题
• 修复更新规则引擎动作后相关计数清零的问题
• 修复 Metrics 接口默认情况下不返回 client.acl.deny 等认证鉴权指标的问题
• 修复订阅查询接口未返回分页数据的问题
• 修复 STOMP 处理 TCP 粘包时解析失败的问题
• 修复客户端过滤查询时会话创建时间选项不可用的问题
• 修复重启后内存告警可能不会触发的问题
• 修复 emqx_auth_mnesia 插件中存在用户数据时导入数据崩溃的问题

4.3.6

发布日期: 2021-12-17

增强

• 规则引擎现已支持 Ali Lindorm 数据库
• 支持配置是否继续投递空的保留消息，以适应仍在使用 MQTT v3.1 协议的用户
• 优化内置访问控制文件模块的使用交互

修复

• 修复内存占用计算错误的问题
• 修复规则引擎 Webhook Action 的 Path 参数不支持使用 ${Variable} 的问题
• 修复 RocketMQ 异步写入时数据乱码的问题
• 修复 RocketMQ 统计指标不准的问题
• 修复某些情况下更新或删除 MQTT Bridge 和 MQTT Subscribe 资源，会持续打印连接失败日志的问题
• 修复规则引擎保存数据到 MySQL 时可能出现较高失败率的问题
• 修复规则引擎 Clickhouse 离线消息功能不可用的问题
• 修复规则引擎 MongoDB 离线消息功能中 Max Returned Count 选项无法使用的问题
• 修复部分热配置失效的问题

4.3.5

发布日期: 2021-11-05

增强

• 改进客户端踢除机制
• 为 LwM2M 网关添加新加密套件的支持
• 支持优先级队列的交错（以避免低优先级队列枯竭）
• 默认为 HTTP 认证插件关闭超级用户请求
• 优化 InfluxDB 写入性能
• InfluxDB 的 Tag Name 与 Field Name 支持使用占位符

修复

• 修复集群间调用可能导致客户端进程失去响应的问题
• 修复 WebHook TLS 不可用的问题
• 修复 MongoDB 资源不支持域名的问题
• 修复基于内置数据库的 ACL 的性能问题
• 修复基于内置数据库的认证错误转码 HTTP 请求参数的问题
• 修复 MySQL 认证模块可能启动失败的问题
• 修复 STOMP 网关若干问题
• 修复规则引擎 Kafka 和 MongoDB 资源状态不准确的问题
• 修复包含 “\” 字符的 Client ID 无法进行模糊搜索的问题
• 修复可变字节整数可能大于 4 字节的问题
• 修复可能添加重复模块的问题
• 修复无法在 Dashboard 上重启 Listener 的问题

4.3.4

发布日期: 2021-09-18

增强

• 规则引擎 数据桥接到pulsar 支持数据压缩
• 延长创建规则的超时间隔

修复

• 规则引擎 数据保存到InfluxDB 性能问题
• WebHook 无法配置 sni 导致某些情况下无法使用 HTTPS 的问题
• 规则引擎 关闭规则后资源无法释放的问题
• 规则引擎 离线消息 在某些情况下接收后无法删除的问题

4.3.3

发布日期: 2021-08-16

增强

• 离线消息保存到Redis 支持清除残留数据
• ExHook 增加自动重连机制，超时参数 和 备选动作

修复

• 规则引擎无法使用HTTPS 连接到 InfluxDB
• 规则引擎 数据保存到InfluxDB 动作无法使用占位符
• 规则引擎 数据桥接到WebServer 无法使用Path
• grpc-client 超时处理逻辑
• ExProto bug，增加重试逻辑，减少一些不必要的打印

4.3.2

发布日期: 2021-07-17

增强

• 增强 客户端上/下线消息增加更多的字段

修复

• LwM2M网关 管理页面无法打开的问题
• JT/T808网关 解析位置上报中自定义字段无法解析的问题
• acl.conf 文件格式错误导致ACL规则失效的问题
• 创建 auth_ldap 认证模块失败的问题
• 多语言协议解析 异常情况下无法停止的问题
• 规则引擎 无法创建Oracle 资源的问题
• 规则引擎 同步批量写入到SQL Server失败的问题

4.3.1

发布日期: 2021-06-05

增强

• 规则引擎 离线消息保存中 TimeRange 字段的说明

修复

• 规则引擎 数据保存到 OpenTSDB 异常情况下无法写入的问题
• 热升级后版本显示错误的问题
• MQTT-SN 协议 cleansession=false 的客户端在恢复 session 时 topicid 丢失的问题
• 预置模块在重启后修改配置丢失的问题
• Dashboard 规则引擎编辑显示错误问题
• Dashboard 导航面包屑显示问题

4.3.0

发布日期: 2021-05-19

增强

• 规则引擎消息桥接到 Kafka 分区支持动态扩容
• 规则引擎支持 ClickHouse 离线消息与代理订阅
• 规则引擎中支持批量操作动作默认启用批量异步模式
• 规则引擎数据保存到 InfluxDB 重构以增强性能
• 模块 消息下发 Kafka 消费组支持配置 Payload 格式

修复

• 规则引擎动作编辑数据不一致问题
• Dashboard 模块翻译问题
• 规则引擎 SQL语句支持 null 函数，undefined 转成 null

4.2.13

发布日期: 2022-08-10

功能增强

• 现在不兼容版本之间的热升级将被拒绝
• 支持 HTTP API 的监听器绑定到指定的网络接口上
• 引导脚本将在遇到无效的节点名称时快速失败，并提高错误消息的可读性

错误修复

• 修复从备份恢复后热配置项未生效的问题
• 修复规则引擎的数据在集群中没有进行磁盘复制，导致唯一将数据写入磁盘的节点离开集群后，重启集群将丢失规则引擎数据的问题
• 修复规则引擎对不可用资源进行连接测试时报 500 的问题
• 修复在规则引擎中创建 MongoDB 资源时连接测试永远通过的问题
• 修复规则引擎在写入 TDEngine 资源失败时未正确更新计数的问题
• 延长规则引擎 DynamoDB 资源状态查询超时时间，以避免部分海外资源可能无法使用的问题
• 如果 ACL 规则中的占位符没有被替换，则客户端的发布或订阅操作将被拒绝
• 修复主题重写与延迟发布执行顺序不固定的问题，现在固定为优先执行主题重写
• 修复备份文件中关闭的模块会在恢复备份后自动启用的问题
• 修复 MQTT-SN 客户端重传 QoS 2 消息时会被断开连接的问题
• 修复 Dashboard HTTPS 监听器的 verify 选项未生效的问题
• 修复多项 Dashboard 显示问题

4.2.12

发布日期: 2022-07-11

错误修复

• 修复热配置功能在热升级后无法继续使用的问题

4.2.11

发布日期: 2022-04-26

重要变更

我们在 4.2.11 中修复了 License 总连接数计算的 Bug，License 将正确地检查集群的总连接数，而非错误地仅检查每个节点上的连接数。请计划升级的用户注意此变化可能导致的客户端达到 License 限制而无法连接的可能性。

注意：e4.2.0 与 e4.2.1 在热升级到更高版本时 WebSocket 监听器会重启，因此 WebSocket 连接会短暂断开，请广大用户升级时注意。

功能增强

• MQTT-SN 网关支持会话恢复时主动同步注册主题
• 改进规则引擎 SQL 匹配执行过程中的相关统计指标
• 改进规则引擎在解析 Payload 失败时的错误提示

错误修复

规则引擎

• 修复规则引擎数据持久化到 Oracle 失败但成功计数仍然增加的问题
• 修复规则引擎持久化数据到 Oracle 的动作（仅限同步操作）执行失败时无法触发备选动作的问题
• 修复启用系统消息会导致规则引擎的 Kakfa 动作崩溃的问题
• 修复规则引擎资源不可用时查询资源请求超时的问题
• 创建规则时如果已经有使用相同 ID 的规则存在，现在规则引擎将报错而不是替换已有规则

协议

• 修复 server_keepalive 配置项的值会被错误应用于 MQTT v3.1.1 客户端的问题
• 修复 JT/T 808 位置报告报文解析错误的问题
• 修复向 MQTT-SN 客户端成功注册主题时没有重传此前因未注册主题而投递失败的消息的问题

REST API & CLI

• 修复使用多个条件查询订阅时返回的查询结果错误的问题
• 修复订阅查询接口未返回分页数据的问题
• 增加对 Dashboard User 与 AppID 的格式检查，避免包含某些特殊字符的 User 和 AppID 无法被删除
• 修复 Metrics 接口默认情况下不返回 client.acl.deny 等认证鉴权指标的问题
• 修复集群环境下 LwM2M 客户端列表查询 API 返回数据错误导致无法访问 LwM2M 网关模块管理页面的问题

Dashboard

• 修复筛选客户端时会话创建时间选项不可用的问题
• 修复各项显示问题

其他

• 修复热配置的各项问题，如配置无法清除、更新后的配置在重启后失效等
• 修复 MQTT Bridge 插件仅配置订阅主题但未配置 QoS 时无法启动的问题
• 修复插件默认启动列表的一个问题，现在 loaded_plugins 文件中重复的插件启动项将被忽略
• 修复代理订阅可能订阅为空的主题的问题
• 修复部分日志中 Message ID 显示乱码的问题

4.2.10

发布日期: 2022-01-13

增强

• 更新规则引擎 Action 时不再会清空 Action 的统计指标
• 支持配置是否转发为 Payload 为空的保留消息，以适应仍在使用 MQTT v3.1 的用户，相关配置项为 retainer.stop_publish_clear_msg
• 优化内置访问控制文件模块的使用交互
• 将 max_topic_levels 配置项的默认值更改为 128，以前它没有限制（配置为 0），这可能是潜在的 DoS 威胁
• 改进了接收到 Proxy Protocol 报文但 proxy_protocol 配置项未开启时的错误日志内容

重要修复

• 修复规则引擎保存数据到 MySQL 时可能出现较高失败率的问题
• 修复 RocketMQ 异步写入时数据乱码问题
• 修复 RocketMQ 统计指标不准的问题
• 修复规则引擎 MongoDB 离线消息功能中 Max Returned Count 选项无法使用的问题
• 修复资源健康检查可能堵塞创建过程的问题

次要修复

• 修复代理订阅模块中的 Retain Handling 订阅选项无法配置为 2 的问题
• 修复使用会话创建时间筛选得到的客户端列表不准确的问题
• 修复 Dashboard 节点详情页中的 Erlang VM 内存计算错误的问题
• 移除已经失效的运行时可配置项，支持更多的运行时可配置项

4.2.9

发布日期: 2021-11-17

增强

• 改进客户端踢除机制

重要修复

• 修复集群间调用可能导致客户端进程失去响应的问题
• 修复 Modules 多次启停后报错的问题
• 修复锁释放可能在某些情况下导致客户端进程崩溃的问题

次要修复

• 修复 MongoDB 资源不支持域名的问题
• 修复 MongoDB 认证模块的一些问题
• 修复包含 "\" 字符的 Client ID 无法进行模糊搜索的问题
• 修复可变字节整数可能大于 4 字节的问题
• 修复可能重复添加相同 Module 的问题
• 修复 Dashboard 修改 Action 相关配置后，实际已生效，但前端未刷新显示的问题

4.2.8

发布日期: 2021-09-29

• 修复 规则引擎 同步批量写入到 SQL Server 失败的问题
• 修复 规则引擎 无法创建 Oracle 资源的问题
• 修复 多语言协议解析 异常情况下无法停止的问题
• 修复 创建 LDAP Auth 认证模块失败的问题
• 修复 JT/T808 网关 解析位置上报中自定义字段无法解析的问题
• 修复 规则引擎 离线消息 在某些情况下接收后无法删除的问题
• 修复 规则引擎 关闭规则后资源无法释放的问题
• 增强 离线消息保存到 Redis 支持清除残留数据
• 修复客户端搜索时，输入错误的数据格式时，后端返回的错误码不清晰的问题
• 修复 MQTT-SN 客户端连接后，客户端的协议名称显示不正确的问题
• 修复有几率出现的客户端进程卡死，导致某些客户端无法连接的问题
• 修复 proxy-protocol 开启后客户端无法接入的问题。
• 修复 proxy-protocol 开启后客户端页面显示 Socket 类型不正确的问题
• 修复集群下，跨节点调用 exproto 的 ConnectionAdapter 内方法，报告 "Connection process is not alive" 的问题
• 修复了 Kafka 客户端在网络波动中导致僵死的 Bug
• Webhook 支持 Pipelining 开关，默认关闭
• 新增 acl.conf 对 ipaddrs 的支持
• 优化 exproto 客户端连接断开，大量无用日志的打印问题

4.2.7

发布日期: 2021-06-17

• 修复 规则引擎 数据保存到 OpenTSDB 异常情况下无法写入的问题
• 修复 特殊情况下无法在 Dashboard 进行热配置问题
• 修复 MQTT-SN 协议 Clean Session 为 false 的客户端在恢复 session 时 topicid 丢失的问题
• 修复 MQTT-SN 在异常情况下客户端卡死问题
• 修复 规则引擎 数据转发到 WebServer SSL 配置无法生效的问题
• 修复 模块 Kafka 消费组 SSL 配置无法生效的问题
• 修复 规则引擎 编辑资源导致资源列表无法显示的问题
• 增强 导入 license 失败的异常处理

4.2.6

发布日期: 2021-04-29

• 修复 特殊情况下模块停止后无法启动的问题
• 修复 告警列表时间格式问题
• 修复 MQTT-SN客户端异常下线Will message没有发送的问题
• 修复 MQTT-SN 客户端重连且cleansession=false情况下PUBLISH和REGACK的顺序错乱问题
• 修复 Dashboard 中部分显示错误的问题
• 更新 Log 默认输出在 File中

4.2.5

发布日期: 2021-03-10

• 修复 Pulsar 消费组解析批量消息错误的问题
• 修复 MQTT 协议 异常情况下无法解析的问题
• 修复 Dashboard 订阅列表异常情况下显示错误的问题
• 修复 规则引擎 处理单进程的批量消息性能问题

4.2.4

发布日期: 2021-02-18

• 新增 规则引擎 更新资源逻辑
• 新增 规则引擎 数据桥接到kafka支持配置缓存大小
• 修复 AUTH_HTTP 长连接在达到 Keepalive 超时时长或最大请求数时被断开导致请求丢失的情况
• 修复 WebHook SSL 证书配置问题
• 修复 AuthRedis 重连失败的问题
• 修复 创建kafka消费组时检查 MQTT Topic格式问题
• 优化 主题统计页面移动到模块管理页面中

4.2.3

发布日期: 2020-12-25

• 新增 GT/T32960 协议接入
• 新增 规则引擎 SQL语句支持二进制数据操作函数
• 调整 规则引擎/模块 界面参数统一
• 优化 LWM2M接入流程
• 优化 WebHook 插件性能
• 修复 规则引擎 redis sentinel 模式创建资源失败

4.2.2

发布日期: 2020-12-10

• 优化 AuthHttp 性能问题
• 新增 规则引擎 数据保存到 Oracle
• 新增 规则引擎 数据保存到 DolphinDB
• 新增 规则引擎 数据保存到 MS SQL server
• 增强 规则引擎 数据保存 支持 同步和异步方式
• 修复 规则引擎 动作异步模式计数不准的问题
• 新增 SSL 支持配置CA证书的 depth
• 修复 在热升级中的异常问题

4.2.1

发布日期: 2020-11-16

• 新增 Dashboard 模块页面支持管理mqtt增强认证
• 新增 Dashboard 模块页面支持管理lwm2m客户端
• 新增 redis资源支持配置SSL参数
• 新增 auth_jwt支持JWKs
• 新增 订阅者TCP繁忙时触发告警消息
• 新增 规则引擎 数据桥接到kafka 支持ACK策略配置
• 优化 Dashboard监控页面
• 优化 emqx_exporto性能
• 优化 emqx_exhook性能
• 修复 dashboard中，编辑动作，动作类型不对
• 修复 规则引擎-资源错字
• 修复 集群情况下导入导出恢复失败问题
• 修复 规则引擎 MySQL资源无法使用域名问题
• 修复 数据桥接到kafka 出现message too large的问题

4.2.0

发布日期: 2020-10-13

• 规则引擎 Mysql/MongoDB/Cassandra/PGsql 资源支持IPV6和SSL连接
• 规则引擎 "资源" 支持上传证书
• 规则引擎 "动作" 分组
• 修复 InfluxDB 不支持有下划线字符
• 支持更多的插件通过 Dashboard 模块进行配置和启动
• 支持更多的参数热配置
• 支持小版本号之间的热升级
• 移除emqx_auth_username和emqx_auth_clientid插件
• 重构emqx_auth_mnesia,兼容老版本emqx_auth_username和emqx_auth_clientid的数据导入
• emqx主配置文件拆分,并且支持 include 配置文件

4.1.5

发布日期: 2020-08-30

EMQX 4.1.5 is released now, it fixes a bug in MQTT message parser.

4.1.4

发布日期: 2020-08-29

EMQX 4.1.4 is released now, it mainly includes the following changes:

emqx

Bug fixes:

• Fix the issue of abnormal memory growth caused by the topic metrics feature

  Github PR: emqx#3680

emqx-bridge-mqtt

Enhancements:

• The clientid configuration item supports ${node} placeholders to optimize the user experience under the cluster

  Github PR: emqx-bridge-mqtt#99

emqx-management

Bug fixes:

• Fix the issue that the data migration function is not available under Windows

  Github PR: emqx-management#262

emqx-lua-hook

Bug fixes:

• Fix the issue that the Username field cannot be obtained

  Github PR: emqx-lua-hook#115

4.1.3

发布日期: 2020-07-24

EMQX 4.1.3 is released now, it mainly includes the following changes:

emqx-management

Bug fixes:

• Add type checking for the payload field in PUBLISH API

  Github PR: emqx/emqx-management#250

emqx-retainer

Bug fixes:

• Fix the issue that the retained message will not be sent when the subscription topic contains both '+' and '#'

  Github PR: emqx/emqx-retainer#146

4.1.2

发布日期: 2020-08-08

• 修复了一些已知问题

4.1.2

发布日期: 2020-07-23

EMQX 4.1.2 is released now, it mainly includes the following changes:

emqx

Bug fixes:

• Fix the issue that the topic alias is not used to replace the topic

  Github PR: emqx/emqx#3616

• Fix the issue that some operations take up too much CPU

  Github PR: emqx/emqx#3581

emqx-rel

Bug fixes:

• Fix the issue that the console no longer outputs the log after the log is filled with all log files when running emqx by docker

  Github PR: emqx/emqx-rel#559

4.1.1

发布日期: 2020-08-07

1. 规则引擎 添加 Pulsar 消费组资源
2. 规则引擎 添加 Kafka 消费组资源
3. 规则引擎 添加数据保存到 TDengine 数据库
4. 规则引擎 添加离线消息保存到 MySQL 动作
5. 规则引擎 添加离线消息保存到 PostgreSQL 动作
6. 规则引擎 添加离线消息保存到 Cassandra 动作
7. 规则引擎 添加离线消息保存到 MongoDB 动作
8. 规则引擎 添加从 MySQL 中获取订阅关系
9. 规则引擎 添加从 PostgreSQL 中获取订阅关系
10. 规则引擎 添加从 Cassandra 中获取订阅关系
11. 规则引擎 添加从 MongoDB 中获取订阅关系
12. 规则引擎 保存数据到 MongoDB 动作支持消息模板
13. 修复 HTTP Publish API 无法支持 payload 为 json 格式的问题

4.1.1

发布日期: 2020-07-09

EMQX 4.1.1 is released now, it mainly includes the following changes:

emqx-retainer

Bug fixes:

• Fix performance issues

  Github PR: emqx/emqx-retainer#141

emqx-bridge-mqtt

Bug fixes:

• Change mount point to optional configuration

  Github PR: emqx/emqx-bridge-mqtt#84

emqx-rel

Bug fixes:

• Hiding sensitive env from docker's logging out

  Github Issue: emqx/emqx-rel#524

  Github PR: emqx/emqx-rel#542

  Thanks: emqx/emqx-rel#525 - daadu

emqx-lua-hook

Bug fixes:

• Fix the issue that there is no unload script and CLI when the plugin is unloaded

  Github PR: emqx/emqx-lua-hook#106

4.1.0

发布日期: 2020-07-18

1. 内置预览版 license，无需在官网注册获取 licese 可以直接启动 emqx
2. 修改 license 过期策略，emqx 服务不停，但是新连接无法登录
3. 规则引擎 添加 MQTT 订阅资源
4. 规则引擎 MQTT 消息桥接支持 pool
5. 规则引擎 MQTT 消息桥接修复集群无法使用 BUG
6. 规则引擎 添加数据保存到 ClickHouse 数据库
7. InfluxDB 支持 http/https 方式连接
8. 企业版多语言开发支持北向消息处理
9. 规则引擎 添加离线消息保存到 redis 动作
10. 规则引擎 添加从 redis 中获取订阅关系

4.1.0

发布日期: 2020-06-04

EMQX 4.1.0 is released now, it mainly includes the following changes:

Enhancements:

• Support multi-language extension and provide SDK, supported languages: Python, Java
• Support topic based metrics
• Supports loading the latest configuration when the plugin starts
• Support for topic aliases when messages are forwarded
• Add subscription option configuration for proxy subscriptions
• Support fuzzy query and multi condition query of client list
• Support fuzzy query of subscription list
• Support to add simple authentication information on Dashboard
• Support data migration between versions
• MQTT AUTH Packet is supported. At present, only SCRAM-SHA-1 authentication mechanism is supported and users can expand it by themselves
• Support for obtaining network addresses and ports when using the proxy protocol
• Add authentication plugin based on Mnesia database (completely replace emqx-auth-clientid and emqx-auth-username plugins in subsequent versions)
• Support for editing rules in rule engine
• Support comment configuration items when running EMQX through Docker
• LwM2M gateway plugin supports IPv6 and listens to multiple ports at the same time
• CoAP gateway plugin supports IPv6
• JWT authentication plugin supports configuration of jwerl signature format

Bug fixes:

• Fix the issue that EMQX could not start when etc/emqx.conf was read-only
• Fix the issue that the connection process crashes in some cases
• Fix the issue that the browser doesn't support the current SSL/TLS certificates
• Fix the issue that the MQTT bridge plugin doesn't send heartbeat packets by default
• Fix the issue that the abnormal login detection function does not delete the expired data, resulting in memory growth
• Fix the issue that the built-in ACL module did not clear the ACL cache when reloading
• Fix the issue that client.disconnected event in WebHook plugin goes wrong in some cases
• Fix the issue that MQTT-SN gateway plugin doesn't support specifying listening IP address and supports IPv6

4.0.5

发布日期: 2020-03-17

EMQX 4.0.5 现已发布。此版本主要进行了错误修复。

错误修复:

• 修复 GC 策略

  Github PR: emqx/emqx#3317

• 修复了 Maximum-QoS 属性的值设置错误的问题

  Github issue: emqx/emqx#3304, emqx/emqx#3315 Github PR: emqx/emqx#3321

• 修复了 EMQX 运行在 Docker 环境中时 CPU 占用率每隔 15 秒异常升高的问题

Github issue: emqx/emqx#3274 Github PR: emqx/emqx-rel#462

• 修复配置文件中 node.* 配置项不生效的问题

  Github issue: emqx/emqx#3302 Github PR: emqx/emqx-rel#463

错误修复:

• 修复规则引擎不支持 Payload 为 utf-8 字符串的问题

  Github issue: emqx/emqx#3287 Github PR: emqx/emqx#3299

emqx-sn (plugin)

错误修复:

• 修复 MQTT-SN 订阅丢失的问题

  Github issue: emqx/emqx#3275 Github PR: emqx/emqx-sn#156

4.0.4

发布日期: 2019-03-06

EMQX 4.0.4 现已发布。此版本主要进行了错误修复。

emqx

错误修复:

• 修复 acl_deny_action 配置项不生效的问题

  Github issue: emqx/emqx#3266

  Github PR: emqx/emqx#3286

• 修复 mountpoint 配置项的错误类型

  Github issue: emqx/emqx#3271

  Github PR: emqx/emqx#3272

• 修复 peer_cert_as_username 配置项不生效的问题

  Github issue: emqx/emqx#3281

  Github PR: emqx/emqx#3291

• 修复连接正常关闭后仍打印错误日志的问题

  Github PR: emqx/emqx#3290

emqx-dashboard (plugin)

错误修复:

• 修复 Dashboard 节点下拉列表中显示空白的问题

  Github issue: emqx/emqx#3278

  Github PR: emqx/emqx-dashboard#206

emqx-retainer (plugin)

错误修复:

• 保留消息达到最大存储数量后的行为由无法存储任何保留消息更正为可以替换已存在主题的保留消息

  Github PR: emqx/emqx-retainer#136

4.0.3

发布日期: 2019-02-21

EMQX 4.0.3 现已发布。此版本主要进行了错误修复。

emqx

功能增强:

• 添加允许客户端绕过认证插件登录的选项

  Github PR: emqx/emqx#3253

错误修复:

• 修复某些竞争条件下会打印不必要的错误日志的问题

  Github PR: emqx/emqx#3246

emqx-management (plugin)

错误修复:

• 移除不再使用的字段和函数以及修复字段值异常的问题

  Github PR: emqx/emqx-management#176

• 修复集群环境下无法获取客户端列表的问题

  Github PR: emqx/emqx-management#173

• 修复 HTTPS 监听选项

  Github PR: emqx/emqx-management#172

• 修复应用列表的返回格式

  Github PR: emqx/emqx-management#169

4.0.2

发布日期: 2019-02-07

EMQX 4.0.2 现已发布。此版本主要进行了错误修复和性能优化。

emqx

功能增强:

• 提升 Json 编解码性能

  Github PR: emqx/emqx#3213, emqx/emqx#3230, emqx/emqx#3235

• 压缩生成的项目大小

  Github PR: emqx/emqx#3214

错误修复:

• 修复某些情况下没有发送 DISCONNECT 报文的问题

  Github PR: emqx/emqx#3208

• 修复收到相同 PacketID 的 PUBLISH 报文时会断开连接的问题

  Github PR: emqx/emqx#3233

emqx-stomp (plugin)

错误修复:

• 修复最大连接数限制不生效的问题

  Github PR: emqx/emqx-stomp#93

emqx-auth-redis (plugin)

错误修复:

• 修复内部模块启动失败的问题

  Github PR: emqx/emqx-auth-redis#151

cowboy (dependency)

错误修复:

• 修复 Websocket 连接某些情况下不会发送遗嘱消息的问题

  Github Commit: emqx/cowboy#3b6bda

4.0.1

发布日期: 2019-01-17

EMQX 4.0.1 现已发布。此版本主要进行了错误修复和性能优化。

emqx

功能增强:

• force_shutdown_policy 默认关闭

  Github PR: emqx/emqx#3184

• 支持定时全局 GC 并提供配置项

  Github PR: emqx/emqx#3190

• 优化 force_gc_policy 的默认配置

  Github PR: emqx/emqx#3192, emqx/emqx#3201

• 优化 Erlang VM 参数配置

  Github PR: emqx/emqx#3195, emqx/emqx#3197

错误修复:

• 修复使用错误的单位导致黑名单功能异常的问题

  Github PR: emqx/emqx#3188

• 修复对 Retain As Publish 标志位的处理并且在桥接模式下保持 Retain 标识位的值

  Github PR: emqx/emqx#3189

• 修复无法使用多个 Websocket 监听端口的问题

  Github PR: emqx/emqx#3196

• 修复会话 takeover 时 EMQX 可能不发送 DISCONNECT 报文的问题

  Github PR: emqx/emqx#3208

emqx-rule-engine

功能增强:

• 提供更多操作数组的 SQL 函数

  Github PR: emqx/emqx-rule-engine#136

• 减少未配置任何规则时对性能的影响

  Github PR: emqx/emqx-rule-engine#138

emqx-web-hook

错误修复:

• 修复参数不匹配导致的崩溃问题

  Github PR: emqx/emqx-web-hook#167

4.0.0

发布日期: 2019-01-10

EMQX 4.0.0 正式版现已发布。在这个版本中，我们通过重构 channel 和 session 显著地改进了吞吐性能，通过添加更多的钩子和统计指标增强了可扩展性，重新设计了规则引擎的 SQL，并优化 Edge 版本的性能表现。

常规

功能增强:

• 架构优化，大幅提高消息吞吐性能，降低了 CPU 与内存占用
• 改进 MQTT 5.0 报文处理流程
• 规则引擎支持全新的 SQL 语句
• 调整 metrics 命名并增加更多的 metrics
• 调整钩子参数并增加更多的钩子
• emqtt 提供发布与订阅的命令行接口

错误修复:

• 修复了 SSL 握手失败导致崩溃的问题
• 修复 max_subscriptions 配置不生效的问题
• 修复跨集群转发消息失序的问题
• 修复命令行接口无法获取单个主题的多条路由信息的问题

REST API

功能增强:

• 支持 IPv6
• REST API 默认监听端口由 8080 改为 8081，减少被其他应用占用的情况
• 移除所有 sessions 相关的接口
• connections 调整为 clients，并提供原先 sessions 的功能
• 支持订阅查询接口返回共享订阅的真实主题
• 支持配置默认的 AppID 与 AppSecret
• 发布消息的 REST API 支持使用 base64 编码的 payload

错误修复:

• 修复转码后的 URI 没有被正确处理的问题

认证

功能增强:

• HTTP 认证插件支持用户配置自定义的 HTTP 请求头部
• clientid 与 username 认证插件重新支持用户通过配置文件配置默认的 clientid 与 username