EMQX 版本生命周期与终止支持（EOL）说明
EMQX 服务于各类用户，从快速迭代的 SaaS 平台到大型企业部署。为满足这些多样化的需求，EMQX 采用了一种多层级的版本发布与支持策略，在创新速度、系统稳定性和长期维护之间取得平衡。
本生命周期策略旨在：
- 支持通过频繁的内部版本更新在 EMQX Cloud 中实现快速创新；
- 按季度向本地部署用户交付新功能，保持功能更新节奏；
- 通过指定的长期支持版本，为企业客户提供长期稳定性保障；
- 提供清晰、可预测的版本支持与终止支持时间表。
通过划分为内部版本、功能版本和长期支持版本三个发布层级，EMQX 使用户可以根据实际需求选择适合自己的升级节奏，无论是追求最新功能，还是强调系统稳定性。
发布层级与节奏
为了兼顾快速创新与企业级稳定性，EMQX 采用以下三种版本类型：
内部版本
- 发布频率： 每月
- 适用对象： EMQX 内部团队、EMQX Cloud 用户及部分潜在客户
- 版本目的： 在 EMQX 可控环境（如 Cloud、内部测试环境或部分公开集群）中快速交付并验证新功能，同时为特定客户提供特性预览，为后续公开版本奠定基础。
- 质量保障： 虽然不对外发布，但作为 EMQX Cloud 的运行基础，这些版本必须通过完整的质量验证，达到生产可用标准，并非试验性或不稳定版本。
- 支持方式： 由 EMQX 团队内部维护，不面向本地部署用户。
功能版本
- 发布频率： 每季度发布（通常为 3 月、6 月、9 月和 12 月）
- 适用对象： 需要定期获取新功能的本地部署用户
- 版本目的： 汇集并发布已在内部版本中验证的稳定功能，面向所有本地部署环境。
- 支持周期： 自版本发布之日起提供 18 个月 支持。
长期支持版本
- 发布频率： 每年发布一次（通常基于当年 6 月的功能版本）
- 适用对象： 对系统稳定性和长期可维护性有高要求的企业用户
- 版本目的： 提供经过充分验证、面向生产环境的高稳定版本，并提供较长支持周期。
- 支持周期： 自首次发布之日起 3 年；其中 4.4.x 为过渡期的特殊版本，支持 5 年。
通过这种多层次的版本发布策略，EMQX 能够在内部阶段对新特性进行充分验证与优化，再逐步推广至公开版本，从而确保最终交付给用户的版本具备更高的稳定性和可靠性。
当前长期支持版本
- 4.4.x（首次发布时间：2021 年 12 月 21 日，终止支持日期：2026 年 12 月 20 日）
- 5.8.x（首次发布时间：2024 年 8 月 28 日，终止支持日期：2027 年 8 月 27 日）
版本号与命名规范
EMQX 遵循语义化版本控制（Semantic Versioning）规范，格式为：
主版本.次版本.修订版本 （例如：5.8.1）不同版本类型采用以下命名约定：
主版本（如 4.0.0、5.0.0、6.0.0）
- 包含重大更新，可能不兼容旧版本；
- 通常不支持直接原地升级，需全新部署；
- 详细升级方式请参考各主版本迁移指南。
内部版本（如 5.9.0-M3.202506）
- 格式：
X.Y.Z-M[n].YYYYMM（如：5.9.0-M2.202505，5.9.1-M3.202506） X.Y通常对应当前或即将发布的公开功能版本的次版本号Z表示内部迭代次数，可根据需要递增，亦可能用于临时修复版本（Ad-hoc fix）
功能版本（如5.7.0、5.9.0、5.10.0）
- 每季度发布一次，作为公开的小版本，包含新功能、改进和缺陷修复。
- 与同一主版本（例如
5.x）下的早期小版本保持向后兼容（包括 API 和功能），并支持滚动升级集群。 - 格式：
X.Y.0 Y（次版本号）会随着每个季度的发布递增。- 命名方式： EMQX 企业版 X.Y.0
长期支持版本（如 5.8.0）
- 由每年指定的功能版本升级为长期支持版本。初始长期支持版本（
X.Y.0）包含截至发布时所有稳定且已充分验证的功能集。 - 格式：
X.Y.0 - 命名方式：
EMQX 企业版 X.Y.0 - 长期支持版本的标识会在官方文档和下载页面中明确标注。
修订版本（如 5.8.1、5.9.2）
- 仅包含关键缺陷修复和安全补丁。
- 不引入任何新功能或破坏性变更。
- 适用于以下版本类型：
- 功能版本： 处于 18 个月支持周期内的小版本分支（从对应的
X.Y.0版本发布之日开始计算）将接收适用于该分支的关键缺陷修复和安全补丁。 - 长期支持版本： 每个处于支持期内的长期支持版本分支，在 3 年生命周期内将持续接收适用于该分支的关键缺陷修复和安全补丁。
- 功能版本： 处于 18 个月支持周期内的小版本分支（从对应的
版本维护策略
EMQX 根据版本类型及其生命周期阶段，提供不同的维护策略：
- 内部版本：
- 维护方式： 由 EMQX 团队负责。发现的问题通常会在后续内部版本中修复，或通过 Cloud 环境中的热修补完成。这些修复会合并到开发分支中，以便后续包含在公开版本中发布。
- 功能版本（公开发布）：
- 支持范围： 每个季度发布一个新的功能版本（如 5.9.0、5.10.0），引入新功能和改进。在其 18 个月的生命周期内，该版本分支（如 5.9.x 系列）将通过修订版本（如 5.9.1、5.9.2）持续接收关键缺陷修复和安全补丁，前提是这些问题适用于该分支。
- 适用用户： 需要快速获取新功能，且能够接受较短支持周期的用户和客户。
- 长期支持版本（公开发布）：
- 初始版本（如 5.8.0）： 发布时包含当前所有稳定的功能集。
- 后续修订版本（如 5.8.1、5.8.2）： 在 3 年的生命周期内，长期支持版本将通过修订发布以下更新：
- 关键缺陷修复
- 安全漏洞修复
- 重要说明： 为确保最大稳定性，长期支持版本的修订版本（X.Y.Z）不会引入任何新功能。
- 适用用户： 对系统稳定性、可预测性和长期支持有严格要求的企业用户，或在部署后希望尽可能减少变更的使用场景。
- 修订版本：
- 如 5.10.1、5.10.2，仅包含缺陷修复和安全补丁，不引入新功能。
- 在少数情况下，为支持版本迁移，维护团队可根据实际情况酌情在处于维护状态的版本中引入极少量、必要且不破坏兼容性的更改。
公开发布版本维护时间表
以下为 EMQX 各公开版本的发布时间、支持周期与终止支持日期。该表不包括内部版本，内容将定期更新以反映最新状态：
| 版本 | 发布时间 | 版本类型 | 支持周期 | 终止支持日期 | 备注 |
|---|---|---|---|---|---|
| 3.4.x | 2019-12-02 | 功能版本 | 18 个月 | 2021-06-30 | 已停止维护 |
| 4.0.x | 2020-01-18 | 功能版本 | 18 个月 | 2021-07-17 | 已停止维护 |
| 4.1.x | 2020-07-18 | 功能版本 | 18 个月 | 2022-01-17 | 已停止维护 |
| 4.2.x | 2020-10-13 | 功能版本 | 18 个月 | 2022-04-12 | 已停止维护 |
| 4.3.x | 2021-05-19 | 功能版本 | 18 个月 | 2022-11-18 | 已停止维护 |
| 4.4.x | 2021-12-21 | 长期支持版本 | 3 年（对于 4.4.x 长期支持版本，作为过渡期的特殊情况，其终止支持日期设定为发布后 5 年）。 | 2026-12-21 | 当前长期支持版本 |
| 5.0.x | 2023-02-03 | 功能版本 | 18 个月 | 2024-08-02 | |
| 5.1.x | 2023-06-21 | 功能版本 | 18 个月 | 2024-12-20 | |
| 5.2.x | 2023-09-07 | 功能版本 | 18 个月 | 2025-03-06 | |
| 5.3.x | 2023-09-29 | 功能版本 | 18 个月 | 2025-03-28 | |
| 5.4.x | 2023-12-23 | 功能版本 | 18 个月 | 2025-06-22 | |
| 5.5.x | 2024-02-01 | 功能版本 | 18 个月 | 2025-07-31 | |
| 5.6.x | 2024-03-28 | 功能版本 | 18 个月 | 2025-09-27 | |
| 5.7.x | 2024-05-27 | 功能版本 | 18 个月 | 2025-11-26 | |
| 5.8.x | 2024-08-28 | 长期支持版本 | 3 年 | 2027-08-27 | 最新长期支持版本 |
| 5.9.x | 2025-05-02 | 功能版本 | 18 个月 | 2026-11-01 | 当前最新功能版本 |
| 5.10.x | 2025-06-09 | 功能版本 | 18 个月 | 2026-12-08 | 下一个功能版本 |
| 6.0.0 | 2025-TBD | 主版本 | 18 个月（预计） | TBD | 下一主版本 |
升级路径建议
为了持续获取最新功能、性能优化和安全更新，我们建议用户根据其部署方式制定定期的升级策略：
- EMQX Cloud： 由 EMQX 团队全权托管，用户可无缝享受每月更新，无需手动操作。
- 本地部署的功能版本用户： 可按季度从一个功能版本升级至下一个，以获取最新功能。建议始终使用处于支持周期内（18 个月）的版本。
- 本地部署的长期支持版本用户： 企业用户可规划从当前长期支持版本迁移至下一个版本，建议在支持周期重叠期间进行，以确保长期支持不中断。也支持从功能版本迁移至长期支持版本。
每个版本都会提供详细的升级指南和兼容性说明，帮助用户更好地进行升级规划与执行。