# EMQX 版本生命周期与终止支持（EOL）说明

EMQX 服务于各类用户，从快速迭代的 SaaS 平台到大型企业部署。为满足这些多样化的需求，EMQX 采用了一种多层级的版本发布与支持策略，在创新速度、系统稳定性和长期维护之间取得平衡。

本生命周期策略旨在：

- 支持通过频繁的内部版本更新在 [EMQX Cloud](../faq/concept.md#EMQX-有哪些产品) 中实现快速创新；
- 按季度向本地部署用户交付新功能，保持功能更新节奏；
- 通过指定的长期支持版本，为企业客户提供长期稳定性保障；
- 提供清晰、可预测的版本支持与终止支持时间表。

通过划分为内部版本、功能版本和长期支持版本三个发布层级，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 年生命周期内将持续接收适用于该分支的关键缺陷修复和安全补丁。

## 版本维护策略

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，仅包含缺陷修复和安全补丁，不引入新功能。
  - 在少数情况下，为支持版本迁移，维护团队可根据实际情况酌情在处于维护状态的版本中引入极少量、必要且不破坏兼容性的更改。

## 商业源代码许可证（BSL）与版本支持

::: tip 提示

自 EMQX 5.9.0 起，EMQX 遵循商业源代码许可证（BSL）1.1 协议发布。如需了解更多信息，请参阅[官方公告](https://www.emqx.com/zh/news/emqx-adopts-business-source-license)。

:::

### 社区用户

- 社区用户可根据 BSL 条款使用所有 EMQX 版本，包括来自 LTS 分支的版本。
- 软件按“原样”提供，不附带任何形式的保证。您需自行承担使用风险，EMQX 不对因使用该软件可能引发的任何问题或损失承担责任。
- 根据 BSL 许可，EMQX 源码将在指定的变更日期之后转换为完全开源的许可证（如 Apache 2.0）。这意味着社区用户最终将获得一个完整开源版本，并受益于其长期维护成果。
- 在变更日期到来之前，社区用户仍可获得适用于 BSL 版本的补丁发布（主要包括缺陷修复和安全更新）。

### 商业客户

- 购买了商业许可证与订阅服务的客户可访问高级功能和官方技术支持，其中包括合同中约定的服务保障。
- LTS 版本提供 5 年支持期，作为企业版服务的一部分。这可确保关键业务系统在代码分支转为开源后，依然能获得持续维护与技术支持。

## 公开发布版本维护时间表

以下为 EMQX 各公开版本的发布时间、支持周期与终止支持日期。该表不包括内部版本，内容将定期更新以反映最新状态：

| 版本   | 发布时间   | 版本类型     | 支持周期                                                     | 终止支持日期 | 备注             |
| ------ | ---------- | ------------ | ------------------------------------------------------------ | ------------ | ---------------- |
| **3.4** | 2019-12-02 | 功能版本     | 18 个月                                                      | 2021-06-30   | 已停止维护       |
| **4.0** | 2020-01-18 | 功能版本     | 18 个月                                                      | 2021-07-17   | 已停止维护       |
| **4.1** | 2020-07-18 | 功能版本     | 18 个月                                                      | 2022-01-17   | 已停止维护       |
| **4.2** | 2020-10-13 | 功能版本     | 18 个月                                                      | 2022-04-12   | 已停止维护       |
| **4.3** | 2021-05-19 | 功能版本     | 18 个月                                                      | 2022-11-18   | 已停止维护       |
| **4.4** | 2021-12-21 | 长期支持版本 | **3 年**（对于 4.4.x 长期支持版本，作为过渡期的特殊情况，其终止支持日期设定为发布后 5 年）。 | 2026-12-21   | 当前长期支持版本 |
| **5.0** | 2023-02-03 | 功能版本     | 18 个月                                                      | 2024-08-02   |                  |
| **5.1** | 2023-06-21 | 功能版本     | 18 个月                                                      | 2024-12-20   |                  |
| **5.2** | 2023-09-07 | 功能版本     | 18 个月                                                      | 2025-03-06   |                  |
| **5.3** | 2023-09-29 | 功能版本     | 18 个月                                                      | 2025-03-28   |                  |
| **5.4** | 2023-12-23 | 功能版本     | 18 个月                                                      | 2025-06-22   |                  |
| **5.5** | 2024-02-01 | 功能版本     | 18 个月                                                      | 2025-07-31   |                  |
| **5.6** | 2024-03-28 | 功能版本     | 18 个月                                                      | 2025-09-27   |                  |
| **5.7** | 2024-05-27 | 功能版本     | 18 个月                                                      | 2025-11-26   |                  |
| **5.8** | **2024-08-28** | **长期支持版本** | **3 年**                                                     | **2027-08-27** | **最新长期支持版本** |
| **5.9** | 2025-05-02 | 功能版本     | 18 个月                                                      | 2026-11-01   |  |
| **5.10** | 2025-06-09 | 功能版本     | 18 个月                                                      | 2026-12-08   |    |
| **6.0** | 2025-09-30 | 主版本       | 18 个月                                              | 2027-03-30          |        |
| **6.1** | 2025-12-30 | 功能版本 | 18 个月 | 2027-06-30 |  |
| **6.2** | 2026-03-31 | 功能版本 | 18 个月 | 2027-09-30 | 当前最新功能版本 |

## 升级路径建议

为了持续获取最新功能、性能优化和安全更新，我们建议用户根据其部署方式制定定期的升级策略：

- **EMQX Cloud：** 由 EMQX 团队全权托管，用户可无缝享受每月更新，无需手动操作。
- **本地部署的功能版本用户：** 可按季度从一个功能版本升级至下一个，以获取最新功能。建议始终使用处于支持周期内（18 个月）的版本。
- **本地部署的长期支持版本用户：** 企业用户可规划从当前长期支持版本迁移至下一个版本，建议在支持周期重叠期间进行，以确保长期支持不中断。也支持从功能版本迁移至长期支持版本。

每个版本都会提供详细的升级指南和兼容性说明，帮助用户更好地进行升级规划与执行。