Nacos客户端版本与服务端版本兼容性列表
以下是根据知识库资料整理的Nacos客户端版本与服务端版本的兼容性信息,供您参考:
1. 客户端版本支持范围
- 微服务引擎(MSE)Nacos支持从 0.8 ~ 2.X 最新版本 的客户端。
- 推荐使用 2.1.1及以上版本 的客户端以确保更好的兼容性和稳定性。
2. 服务端版本与客户端版本兼容性
2.1 基础版
- 基础版已停止新购,建议尽快升级至专业版或开发版。
- 基础版支持的客户端版本:
- 配置中心:兼容 Nacos Client 1.0.0及之后的所有版本。
- 服务发现:兼容 Nacos Client 1.2.0及之后的所有版本。
2.2 开发版/专业版
- 开发版/专业版 支持的客户端版本:
- 配置中心:兼容 Nacos Client 1.0.0及之后的所有版本。
- 服务发现:兼容 Nacos Client 1.2.0及之后的所有版本。
- 推荐使用 Nacos Client 2.0.0及以上版本,因为 Nacos Client 1.x.x 不具备长连接能力,可能影响性能和功能。
3. 特定场景下的兼容性说明
3.1 TLS传输加密
- 当服务端开启TLS时,旧版本客户端(未升级到支持TLS的版本)仍然可以通过兼容模式正常访问,但不会进行数据传输加密。
- 注意:如果需要启用TLS加密,客户端版本也需要同步升级到支持TLS的版本。
3.2 Spring Cloud Alibaba 和 Dubbo 框架
- Spring Cloud Alibaba:
- 不推荐使用 2.2.4以下版本,因为会覆盖Nacos Client的日志配置,影响问题排查。
- 推荐升级至 2.2.6.RELEASE及以上版本,并确保Nacos Client版本为 1.4.2及以上。
- Dubbo:
- 不推荐使用 2.7.5及以下版本,可能导致无法获取Provider地址列表变化。
- 推荐升级至 2.7.6及以上版本,并确保Nacos Client版本为 1.4.2及以上。
4. 已知不推荐的客户端版本
以下版本存在已知问题,建议避免使用或升级到推荐版本:
不推荐版本 | 问题描述 | 解决方案 |
1.0.1 ~ 1.1.3 | 客户端版本显示错误,可能导致频繁通知变更或心跳中断等问题。 | 升级至 1.1.4及以上版本。 |
2.0.0 ~ 2.1.0 | 连接重连后实例不会自动重新注册和订阅服务,导致服务掉线且无法自愈。 | 升级至 2.1.1及以上版本。 |
5. SAE 内置 Nacos 支持的客户端版本
- SAE(Serverless Application Engine)内置Nacos支持 1.X 和 2.X 的客户端版本。
- 推荐使用 2.1.1及以上版本,以避免已知问题并提升服务可靠性和性能。
6. MSE Nacos 引擎版本优化
- MSE 提供了基于开源核心版本的优化版本,修复了多个已知问题并提升了性能。
- 示例优化版本:
- 开源核心版本 2.0.3 → MSE优化版本 2.0.3.1:修复了配置修改导致查询历史时间不对的问题等。
- 开源核心版本 2.0.1 → MSE优化版本 2.0.1.1:优化了数据库查询逻辑,降低了数据库抖动的影响等。
7. 推空保护功能的版本要求
- 客户端推空保护:
- 要求 Nacos Java Client 1.4.1及以上版本。
- 服务端推空保护:
- 要求 Nacos引擎版本升级至 2.1.0.0及以上。
重要提醒
- 基础版已停止维护,建议尽快升级至专业版或开发版。
- 推荐使用最新稳定版本的客户端和服务端,以获得最佳性能和安全性。
- 如果您使用的是特定框架(如Spring Cloud Alibaba或Dubbo),请确保框架版本和Nacos Client版本均符合推荐要求。
希望以上信息对您有所帮助!如有其他疑问,请随时咨询。