v5.8.1
版本发布时间: 2024-10-14 23:34:50
emqx/emqx最新发布版本:v5.8.3(2024-12-05 23:56:16)
5.8.1
Release Date: 2024-10-14
Make sure to check the breaking changes and known issues before upgrading to EMQX 5.8.1.
Important Changes
-
#13956 Updated the
gen_rpc
library to version 3.4.1, which includes a node crash issue. Previously, if a node is force shutdown down while RPC channels are being established, it may cause a cluster peer node to crash.
Enhancements
Core MQTT Functionalities
-
#13525 Added new configuration item
shared_subscription_initial_sticky_pick
to specify the strategy for making the initial pick whenshared_subscription_strategy
is set tosticky
. -
#13942 The HTTP client now automatically reconnects if no activity is detected for 10 seconds after the latest request has expired. Previously, it would wait indefinitely for a server response, causing timeouts if the server dropped requests.
This change impacts below components.
- HTTP authentication
- HTTP authorization
- Webhook (HTTP connector)
Authentication and Authorization
-
#13863 EMQX now supports
${cert_common_name}
placeholder in topic name templates for raw ACL rules. -
#13792 The banned-clients API
GET /banned
supports querying the rules using filters in the query string.The available filters are:
- clientid
- username
- peerhost
- like_clientid
- like_username
- like_peerhost
- like_peerhost_net
When adding a new banned client entry, the default expiration time for entries without the
until
parameter specified has been changed from 1 year toinfinite
.
Rule Engine
-
#13773 Disabled rule actions now do not trigger
out_of_service
warnings.Previously, if an action is disabled, there would be a warning log with
msg: out_of_service
, and theactions.failed
counter was incremented for the rule.After this enhancement, disabled action will result in a
debug
level log withmsg: discarded
, and the newly introduced counteractions.discarded
will be incremented.
MQTT over QUIC
-
#13814 Connection Scope Keepalive for MQTT over QUIC Multi-Stream:
This update introduces a new feature to maintain MQTT connections over QUIC multi-streams, even when the control stream is idle but other data streams are active.
Previously, clients had to send
MQTT.PINGREQ
on idle control streams to keep the connection alive. Now, a shared state is maintained for each connection, monitoring activity across all streams. This shared state helps determine if the connection is still active, reducing the risk of keepalive timeouts caused by Head-of-Line (HOL) blocking and improving overall connection stability.
Bug Fixes
Core MQTT Functions
-
#13702 Clean up the corresponding exclusive subscriptions when a node goes down.
-
#13708 Fixed an issue which may cause shared subscription 'sticky' strategy to degrade to 'random'.
-
#13733 Made
cacertfile
optional when configuring https listener fromemqx ctl conf load
command. -
#13742 Fixed when subscribing with
+
as the first level, or#
as a wildcard, retained messages with topics starting with$
are incorrectly received. -
#13754 Fixed an issue when websocket connection would break consistently on its own.
-
#13756 Introduced more randomness to broker assigned client IDs.
-
#13790 The default heartbeat interval for the MQTT connector has been reduced from 300 seconds to 160 seconds.
This change helps maintain the underlying TCP connection by preventing timeouts due to the idle limits imposed by load balancers or firewalls, which typically range from 3 to 5 minutes depending on the cloud provider.
-
#13832 Fixed that the
Publish
endpoint would have a 500 error when persistent session were enabled. -
#13842 Fixed a UTF-8 string validation exception.
Upgrade and Migration
- #13731 Resolved an issue that prevented clusters running on EMQX 5.4.0 from upgrading to EMQX 5.8.0. This fix introduces a migration procedure to update specific internal database tables created in version 5.4.0 to align with the new schema.
Breaking Changes
-
#13792 The default expiration time for a banned item that is created without an
until
value is nowinfinity
(previsouly capped at 1 year limit). -
#13742 Fixed an issue when a client would receive retained messages for a topic starting with
$
when it subscribed to topic#
or+
.This fix satisfies the requirement of MQTT-4.7.2-1.
1、 emqx-5.8.1-amzn2-amd64.rpm 43.79MB
2、 emqx-5.8.1-amzn2-amd64.rpm.sha256 64B
3、 emqx-5.8.1-amzn2-amd64.tar.gz 67.84MB
4、 emqx-5.8.1-amzn2-amd64.tar.gz.sha256 64B
5、 emqx-5.8.1-amzn2-arm64.rpm 43.36MB
6、 emqx-5.8.1-amzn2-arm64.rpm.sha256 64B
7、 emqx-5.8.1-amzn2-arm64.tar.gz 65.81MB
8、 emqx-5.8.1-amzn2-arm64.tar.gz.sha256 64B
9、 emqx-5.8.1-amzn2023-amd64.rpm 41.62MB
10、 emqx-5.8.1-amzn2023-amd64.rpm.sha256 64B
11、 emqx-5.8.1-amzn2023-amd64.tar.gz 70.01MB
12、 emqx-5.8.1-amzn2023-amd64.tar.gz.sha256 64B
13、 emqx-5.8.1-amzn2023-arm64.rpm 41.28MB
14、 emqx-5.8.1-amzn2023-arm64.rpm.sha256 64B
15、 emqx-5.8.1-amzn2023-arm64.tar.gz 67.59MB
16、 emqx-5.8.1-amzn2023-arm64.tar.gz.sha256 64B
17、 emqx-5.8.1-debian10-amd64.deb 39.4MB
18、 emqx-5.8.1-debian10-amd64.deb.sha256 64B
19、 emqx-5.8.1-debian10-amd64.tar.gz 71.54MB
20、 emqx-5.8.1-debian10-amd64.tar.gz.sha256 64B
21、 emqx-5.8.1-debian10-arm64.deb 38.7MB
22、 emqx-5.8.1-debian10-arm64.deb.sha256 64B
23、 emqx-5.8.1-debian10-arm64.tar.gz 69MB
24、 emqx-5.8.1-debian10-arm64.tar.gz.sha256 64B
25、 emqx-5.8.1-debian11-amd64.deb 39.46MB
26、 emqx-5.8.1-debian11-amd64.deb.sha256 64B
27、 emqx-5.8.1-debian11-amd64.tar.gz 69.97MB
28、 emqx-5.8.1-debian11-amd64.tar.gz.sha256 64B
29、 emqx-5.8.1-debian11-arm64.deb 38.76MB
30、 emqx-5.8.1-debian11-arm64.deb.sha256 64B
31、 emqx-5.8.1-debian11-arm64.tar.gz 67.48MB
32、 emqx-5.8.1-debian11-arm64.tar.gz.sha256 64B
33、 emqx-5.8.1-debian12-amd64.deb 39.5MB
34、 emqx-5.8.1-debian12-amd64.deb.sha256 64B
35、 emqx-5.8.1-debian12-amd64.tar.gz 70.14MB
36、 emqx-5.8.1-debian12-amd64.tar.gz.sha256 64B
37、 emqx-5.8.1-debian12-arm64.deb 38.82MB
38、 emqx-5.8.1-debian12-arm64.deb.sha256 64B
39、 emqx-5.8.1-debian12-arm64.tar.gz 67.54MB
40、 emqx-5.8.1-debian12-arm64.tar.gz.sha256 64B
41、 emqx-5.8.1-docker-amd64.tar.gz 102.15MB
42、 emqx-5.8.1-docker-arm64.tar.gz 201.5MB
43、 emqx-5.8.1-el7-amd64.rpm 54.63MB
44、 emqx-5.8.1-el7-amd64.rpm.sha256 64B
45、 emqx-5.8.1-el7-amd64.tar.gz 74.81MB
46、 emqx-5.8.1-el7-amd64.tar.gz.sha256 64B
47、 emqx-5.8.1-el7-arm64.rpm 53.39MB
48、 emqx-5.8.1-el7-arm64.rpm.sha256 64B
49、 emqx-5.8.1-el7-arm64.tar.gz 73.31MB
50、 emqx-5.8.1-el7-arm64.tar.gz.sha256 64B
51、 emqx-5.8.1-el8-amd64.rpm 42.16MB
52、 emqx-5.8.1-el8-amd64.rpm.sha256 64B
53、 emqx-5.8.1-el8-amd64.tar.gz 71.59MB
54、 emqx-5.8.1-el8-amd64.tar.gz.sha256 64B
55、 emqx-5.8.1-el8-arm64.rpm 41.52MB
56、 emqx-5.8.1-el8-arm64.rpm.sha256 64B
57、 emqx-5.8.1-el8-arm64.tar.gz 69.06MB
58、 emqx-5.8.1-el8-arm64.tar.gz.sha256 64B
59、 emqx-5.8.1-el9-amd64.rpm 41.62MB
60、 emqx-5.8.1-el9-amd64.rpm.sha256 64B
61、 emqx-5.8.1-el9-amd64.tar.gz 69.99MB
62、 emqx-5.8.1-el9-amd64.tar.gz.sha256 64B
63、 emqx-5.8.1-el9-arm64.rpm 41.27MB
64、 emqx-5.8.1-el9-arm64.rpm.sha256 64B
65、 emqx-5.8.1-el9-arm64.tar.gz 67.57MB
66、 emqx-5.8.1-el9-arm64.tar.gz.sha256 64B
67、 emqx-5.8.1-elixir-ubuntu22.04-amd64.tar.gz 82.5MB
68、 emqx-5.8.1-elixir-ubuntu22.04-amd64.tar.gz.sha256 64B
69、 emqx-5.8.1-macos13-amd64.zip 49.89MB
70、 emqx-5.8.1-macos13-amd64.zip.sha256 65B
71、 emqx-5.8.1-macos14-arm64.zip 49.17MB
72、 emqx-5.8.1-macos14-arm64.zip.sha256 65B
73、 emqx-5.8.1-ubuntu20.04-amd64.deb 39.53MB
74、 emqx-5.8.1-ubuntu20.04-amd64.deb.sha256 64B
75、 emqx-5.8.1-ubuntu20.04-amd64.tar.gz 72.42MB
76、 emqx-5.8.1-ubuntu20.04-amd64.tar.gz.sha256 64B
77、 emqx-5.8.1-ubuntu20.04-arm64.deb 38.85MB
78、 emqx-5.8.1-ubuntu20.04-arm64.deb.sha256 64B
79、 emqx-5.8.1-ubuntu20.04-arm64.tar.gz 69.77MB
80、 emqx-5.8.1-ubuntu20.04-arm64.tar.gz.sha256 64B
81、 emqx-5.8.1-ubuntu22.04-amd64.deb 41.18MB
82、 emqx-5.8.1-ubuntu22.04-amd64.deb.sha256 64B
83、 emqx-5.8.1-ubuntu22.04-amd64.tar.gz 70.32MB
84、 emqx-5.8.1-ubuntu22.04-amd64.tar.gz.sha256 64B
85、 emqx-5.8.1-ubuntu22.04-arm64.deb 40.83MB
86、 emqx-5.8.1-ubuntu22.04-arm64.deb.sha256 64B
87、 emqx-5.8.1-ubuntu22.04-arm64.tar.gz 67.81MB
88、 emqx-5.8.1-ubuntu22.04-arm64.tar.gz.sha256 64B
89、 emqx-5.8.1-ubuntu24.04-amd64.deb 41.03MB
90、 emqx-5.8.1-ubuntu24.04-amd64.deb.sha256 64B
91、 emqx-5.8.1-ubuntu24.04-amd64.tar.gz 70.33MB
92、 emqx-5.8.1-ubuntu24.04-amd64.tar.gz.sha256 64B
93、 emqx-5.8.1-ubuntu24.04-arm64.deb 40.67MB
94、 emqx-5.8.1-ubuntu24.04-arm64.deb.sha256 64B
95、 emqx-5.8.1-ubuntu24.04-arm64.tar.gz 67.87MB
96、 emqx-5.8.1-ubuntu24.04-arm64.tar.gz.sha256 64B
97、 emqx-docker-5.8.1.tar.gz 102.15MB
98、 emqx-elixir-5.8.1-docker-amd64.tar.gz 114.36MB
99、 emqx-elixir-5.8.1-docker-arm64.tar.gz 225.87MB
100、 emqx-elixir-docker-5.8.1.tar.gz 114.35MB
101、 emqx-enterprise.zip 229.62MB
102、 env.sh 477B