All Products
Search
Document Center

Microservices Engine:Nacos engine versions

Last Updated:Aug 24, 2026

Lists the Nacos engine versions available for each Microservices Engine (MSE) edition and describes the changes introduced in each version. Nacos engine versions are released in two lines: open source core versions and MSE-optimized versions.

Version overview

Nacos engine versions are released in two lines:

  • Open source core version — Updated in sync with the Nacos open source community.

  • MSE-optimized version — Builds on an open source core version and adds MSE features, enhancements, and bug fixes.

Each MSE-optimized version is based on one open source core version. For example, MSE-optimized versions 3.1.1.0 and 3.1.1.1 are both based on open source core version 3.1.1. The following sections list the versions available for each edition, from the latest to the earliest.

Enterprise Edition

MSE-optimized version 3.1.2.0

Open source core version: 3.1.2

Enhancements

  • Optimized the mutual discovery mechanism between Eureka clients and Nacos 2.0 clients.

  • Optimized the error messages of some clients.

  • Improved the accuracy of source IP retrieval in some scenarios.

MSE-optimized version 3.1.1.1

Open source core version: 3.1.1

New features

  • Supports QPS throttling for the Eureka full query API /apps.

Bug fixes

  • Fixed an issue where the Eureka statusUpdate API may cause a large number of calls to the full query API /apps.

  • Fixed an issue where an XML content-type is returned when a Eureka heartbeat fails with a 404 error.

  • Fixed an issue where a lowercase Eureka instance ID may cause spikes in the call volume of the full query API /apps.

  • Fixed an MCP Server cache inconsistency issue.

MSE-optimized version 3.1.1.0

Open source core version: 3.1.1

New features

  • Supports AI guardrails when you update an MCP service definition.

Bug fixes

  • Fixed an issue where the source IP of a Nacos 2.x client request over the public network is read as a private IP address when the AK whitelist for authentication is enabled.

  • Fixed an issue where some APIs remain accessible after the Eureka feature is disabled.

  • Fixed an issue where incorrect return codes are returned for some requests that have invalid parameters.

MSE-optimized version 3.1.0.0

Open source core version: 3.1.0

New features

MSE-optimized version 3.0.1.0

Open source core version: 3.0.1

New features

  • Supports data source management, which automatically rotates the key information that applications use to access data sources.

  • Supports MCP Registry, which converts existing APIs into MCP APIs.

  • Authentication is enabled by default in the open source console. You can reset the administrator password of the open source console.

MSE-optimized version 2.3.2.1

Open source core version: 2.3.2

New features

  • Includes all Professional Edition features and capabilities.

  • Supports data source management.

  • Supports runtime disk encryption.

Enhancements

  • Provides higher performance and a higher SLA guarantee.

Professional Edition / Developer Edition

MSE-optimized version 2.3.2.1

Open source core version: 2.3.2

New features

  • Supports dynamic changes to the number of namespaces based on quota limits. You can dynamically adjust the upper limit of the namespace quota in Quota Center.

  • Supports local disaster recovery for authentication when Alibaba Cloud RAM authentication is enabled, which prevents RAM service instability from affecting Nacos access.

  • Supports the metadata label field of Prometheus HTTP SD.

Bug fixes

  • Fixed an issue where a service instance on a down ECS instance or pod may be removed from Nacos with a delay when the number of cluster connections exceeds the recommended value.

  • Fixed an issue where data inconsistency between nodes occurs with a very small probability when the Nacos 1.x client is used.

  • Fixed an issue where the size limit of a single configuration in the configuration center cannot be dynamically changed together with Quota Center.

  • Fixed an issue where a "file not found" error is reported when you import configurations.

  • Fixed an issue where incorrect error codes are returned for some requests.

  • Fixed an issue where gRPC TPS and QPS statistics are counted twice.

  • Fixed an issue where Eureka is incompatible with earlier client versions.

  • Fixed an issue where configurations cannot be retrieved when the configuration center uses the default namespace and the configuration namespace ID is public.

  • Fixed an issue where no data is returned when you query the registry service list through OpenAPI and the page size is too large.

  • Fixed an issue where a 403 error is returned when you access the client healthCheck API.

  • Fixed an issue where the appName of a subscriber is -.

  • Fixed an issue where an instance restart unexpectedly deletes some metadata. For details, see ISSUE#11890.

  • Fixed an issue where the console may retrieve other configurations when the dataId or group of a configuration contains an underscore (_).

MSE-optimized version 2.3.2.0

Open source core version: 2.3.2

New features

  • Supports Alibaba Cloud RAM V4 signatures.

  • Supports ActionTrail. For more information, see What is ActionTrail?.

  • Supports adjusting the retention period of the configuration history as needed.

  • Supports recording operator information when a configuration is changed.

  • Supports Alibaba Cloud RAM authentication for the Prometheus SD API.

Enhancements

  • Optimized performance, including gRPC push for service discovery and login API performance. Core capabilities are more than twice as fast as self-managed open source deployments.

  • Enhanced throttling for internal APIs.

  • Optimized the tag-based canary release logic. The upper limit on the number of canary versions is configurable.

  • Optimized the configuration listening chain to eliminate frequent queries.

  • Optimized the startup logic of the Eureka module. Read services are provided after data synchronization is complete.

Security

  • Fixed and hardened some potential security risks.

MSE-optimized version 2.2.3.3

Open source core version: 2.2.3

New features

  • Supports tag-based canary release for configurations.

Enhancements

  • Optimized the data push logic so that a push failure on one connection has less impact on the data push latency of other connections.

  • Raised the default length limit of service provider metadata to 4,096 characters.

Bug fixes

  • Fixed an issue where the cluster CPU usage spikes because some Nacos 2.x clients frequently call the login API.

  • Fixed a namespace capacity display issue.

  • Fixed a service registration failure caused by an excessively short Eureka heartbeat interval.

MSE-optimized version 2.2.3.1

Open source core version: 2.2.3

New features

  • Supports the RAM-AK whitelist feature.

  • Supports the Eureka incremental data protocol.

Enhancements

  • The open source console is disabled by default.

  • Optimized the verification logic for engine upgrades and restarts to support lossless engine changes and improve stability.

  • Optimized the logic for obtaining the source IP to improve accuracy.

  • Optimized cluster throttling. More throttling features are supported to improve engine stability.

  • Optimized the verification logic of request parameters to make parameter error messages clearer.

  • Optimized the performance of the Eureka module. Performance is significantly higher than in earlier versions.

Bug fixes

  • Fixed an issue where clients later than 2.2 cannot receive an update in which the service list changes to empty when forced empty list protection is disabled.

  • Fixed an issue where the service provider count is incorrect during highly concurrent batch service registration.

  • Fixed an issue where the configuration count limit does not take effect in version 2.2.3.0.

  • Fixed an issue where data is not pushed when a problem occurs on a single xDS or MCP protocol connection.

MSE-optimized version 2.2.3.0

Open source core version: 2.2.3

New features

  • Supports viewing the services registered, the services subscribed to, and the configurations listened to by risky client versions.

Enhancements

  • Synchronized with the open source 2.2.3 kernel, including the change that removes the logon page of the open source console when authentication is disabled.

  • Optimized the authentication-related prompts in the open source console.

  • Optimized the push success rate monitoring logic. Expected empty list protection events are ignored so that the push success rate does not drop when empty list protection is triggered.

MSE-optimized version 2.1.2.2

Open source core version: 2.1.2

Enhancements

  • Optimized the cleanup logic of expired metadata in the registry. Metadata modified when a service instance does not exist is cleaned up promptly.

  • Reduced the duration of intermediate states and data inconsistency by optimizing automatic running mode switchover and automatic double-write stopping.

  • Compatible with the underscore character (_) in the clusterName parameter of the registry.

Bug fixes

  • Fixed an issue where the push track cannot be viewed after a push to nacos-go-sdk succeeds.

  • Fixed an issue where data cannot be queried with a small probability when a client connection disconnects and a service is registered at the same time.

  • Fixed an issue where the client receives a 403 permission error when it listens to a configuration after authentication resources are configured at the dataId level.

MSE-optimized version 2.1.2.1

Open source core version: 2.1.2

New features

  • Java applications that use service administration can use Nacos service registration and discovery without code changes.

  • Supports encryption for data communication between the Nacos server and clients.

MSE-optimized version 2.1.2.0

Open source core version: 2.1.2

New features

  • Supports gzip-compressed push for registry addresses.

  • Supports anti-fragility capabilities:

    • Connection throttling

    • TPS throttling for configuration publishing

    • QPS throttling for configuration reading

    • TPS throttling for service data push

MSE-optimized version 2.1.0.2

Open source core version: 2.1.0

Enhancements

  • Optimized the empty list protection logic and narrowed its trigger scope. Empty list protection is triggered only when necessary.

Bug fixes

  • Fixed an issue where the status code returned by the engine OpenAPI is always 500.

  • Fixed an issue where horizontal notifications and Distro notifications fail during scale-in.

  • Fixed an issue where the configuration obtained by the Cipher-256 algorithm is ciphertext when a 2.x client reads an encrypted configuration.

  • Fixed an issue where incorrect data is published with a small probability during a push to Istio.

  • Fixed an issue where Chinese characters in configurations obtained through ACM-Node.js-SDK are garbled.

MSE-optimized version 2.1.0.1

Open source core version: 2.1.0

Enhancements

  • Optimized empty list protection decisions for Dubbo multi-subscription scenarios to prevent clients from printing large volumes of invalid empty list protection logs.

  • Optimized the push task model for greater stability during large-scale pushes.

Bug fixes

  • Fixed an issue where clients frequently print out-date logs.

MSE-optimized version 2.1.0.0

Open source core version: 2.1.0

New features

  • Supports empty list protection to improve high availability (HA). This feature is available only in the Professional Edition.

Enhancements

  • Optimized long polling for configuration listening, which improves performance by about 100%.

MSE-optimized version 2.0.4.0

Open source core version: 2.0.4

New features

  • Supports Dragonwell for higher performance. This feature is available only in the Professional Edition.

  • Supports registry authentication.

  • Supports the RAM control policy feature.

Bug fixes

  • Fixed an issue where connections between nodes may disconnect and not reconnect during concurrent startup.

  • Fixed an issue where the encryption algorithm may be incorrect when you import an encrypted configuration.

MSE-optimized version 2.0.3.2

Open source core version: 2.0.3

Bug fixes

  • Fixed an issue where the address server occasionally fails to initialize.

  • Fixed an issue where a node stays in the recovering state after configuration authentication is enabled.

MSE-optimized version 2.0.3.1

Open source core version: 2.0.3

Enhancements

  • Improved compatibility with the ACM protocol. ACM clients are supported, and configuration operations can use the ACM protocol.

  • MSE Nacos provides better support for the address server mode.

Bug fixes

  • Fixed an issue where the time in the configuration history is inaccurate after a configuration is modified.

  • Fixed an issue where entering {address}:8848/nacos in the open source console fails to redirect to the console page.

  • Fixed an issue where Chinese characters in configurations published in the open source console are garbled.

  • Fixed an issue where the service provider count is incorrect because the Golang SDK does not retry, or retries abnormally, after the initial pull fails.

  • Fixed an issue where the Eureka protocol frequently prints logs.

  • Fixed an issue where Chinese characters published through nacos-nodejs-sdk are garbled.

  • Fixed an issue where the address server does not take effect in standalone mode.

MSE-optimized version 2.0.3.0

Open source core version: 2.0.3

New features

  • Compatible with the ACM (Diamond) protocol, which allows ACM users to migrate to this version.

  • Supports exporting configurations from ACM and importing them into the configuration management service of MSE Nacos.

Enhancements

  • Improved the stability of importing and exporting encrypted configurations.

MSE-optimized version 2.0.1.1

Open source core version: 2.0.1

Enhancements

  • Optimized the database query logic to reduce the impact of database jitter on the server.

Bug fixes

  • Fixed a frontend display issue in the console where all instances appear to change when you bring an instance online or offline, or change its weight.

  • Fixed an issue where metadata is not deleted after expiration when an instance goes offline while the Nacos 1.x client is used.

  • Fixed an issue where Istio (cloud-native gateway) cannot detect an instance going offline or a weight change.

MSE-optimized version 2.0.1.0

Open source core version: 2.0.1

Enhancements

  • Extended compatible client versions to Java Client 0.8.

  • Optimized the performance of the MCP and xDS protocols.

  • Optimized the stability of service data push.

Bug fixes

  • Fixed an issue where the namespace page displays an incorrect maximum configuration value.

  • Fixed an issue where new nodes may fail to join the cluster during scale-out.

MSE-optimized version 2.0.0.0

Open source core version: 2.0.0

New features

  • Supports the gRPC-based Nacos registry and configuration center features.

  • Supports a more complete authentication, encryption, and decryption system.

Enhancements

  • Performance is about 10 times higher than that of the Basic Edition.

Basic Edition

Important

The Basic Edition is discontinued and no longer available for new purchases. If you are using the Basic Edition, upgrade to the Professional Edition as soon as possible. For more information, see Upgrade a Nacos engine version.

MSE-optimized version 1.2.1.3

Open source core version: 1.2.1

New features

Enhancements

  • Optimized the running thread pool to support automatic dynamic adjustment.

Bug fixes

  • Fixed an issue where some queries are inaccurate when you query service subscribers.

MSE-optimized version 1.2.1.2

Open source core version: 1.2.1

Enhancements

  • Optimized database dependencies to reduce the impact of database pressure jitter on Nacos request responses.

Bug fixes

  • Fixed an issue where configurations exported from ACM cannot be imported.

MSE-optimized version 1.2.1.1

Open source core version: 1.2.1

Enhancements

  • Optimized the performance of the MCP and xDS protocols.

Bug fixes

  • Fixed an issue where the namespace page displays an incorrect maximum configuration value.

MSE-optimized version 1.2.1.0

Open source core version: 1.2.1

New features

  • Supports the HTTP-based Nacos registry and configuration center features.

Open source core version 1.1.3

Important

Maintenance of this version has ended. Upgrade as soon as possible.

New features

  • Supports the HTTP-based Nacos registry features.

References

For instructions, see Upgrade a Nacos engine version.