Nacos 3.2.1-2026.03.30 is a snapshot release focused on critical bug fixes for issues discovered in 3.2.0, particularly around AI module dependency conflicts, console UI bugs, and race conditions in the skill publish pipeline.

Key highlights include:

• Dependency Resolution: Upgraded MCP SDK to 0.17.0 to resolve json-schema-validator conflicts affecting AI module functionality
• AI Module Stability: Fixed race condition in skill publish pipeline and streamlined skill download routing
• Console UI Fixes: Addressed configuration file editing errors and namespace ID validation issues in the new UI
• Input Validation: Enhanced parameter validation in ops controller forms for better security

• [#14794] Support force-publish skills for admin user

• [#14784] Validate input parameters in ops controller forms for better security

• [#14765] Fix configuration file editing error in 3.2 console
• [#14768] Fix /v3/console/ai/mcp/importToolsFromMcp failure due to json-schema-validator dependency conflict
• [#14771] Fix batch import failure in legacy console UI
• [#14775] Add missing OIDC-related configurations to application.properties template
• [#14783] Remove downloadSkillZip from AiClientProxy interface and route skill download directly to HTTP client
• [#14786] Eliminate race condition in AI publish pipeline by pre-generating executionId
• [#14794] Fix namespace ID validation issue in new UI when adding custom namespace

• [#14782] Upgrade MCP SDK to 0.17.0 to resolve json-schema-validator conflict

Full Changelog: https://github.com/alibaba/nacos/compare/3.2.0...3.2.1-2026.03.30

• [CHANGE] Hetzner SD: The __meta_hetzner_datacenter label is deprecated for the role robot but kept for backward compatibility, use the __meta_hetzner_robot_datacenter label instead. For the role hcloud, the label is deprecated and will stop working after the 1 July 2026. #17850
• [CHANGE] Hetzner SD: The __meta_hetzner_hcloud_datacenter_location and __meta_hetzner_hcloud_datacenter_location_network_zone labels are deprecated, use the __meta_hetzner_hcloud_location and __meta_hetzner_hcloud_location_network_zone labels instead. #17850
• [CHANGE] Promtool: Redirect debug output to stderr to avoid interfering with stdout-based tool output. #18346
• [FEATURE] AWS SD: Add Elasticache Role. #18099
• [FEATURE] AWS SD: Add RDS Role. #18206
• [FEATURE] Azure SD: Add support for Azure Workload Identity authentication method. #17207
• [FEATURE] Discovery: Introduce prometheus_sd_last_update_timestamp_seconds metric to track the last time a service discovery update was sent to consumers. #18194
• [FEATURE] Kubernetes SD: Add support for node role selectors for pod roles. #18006
• [FEATURE] Kubernetes SD: Introduce pod-based labels for deployment, cronjob, and job controller names: __meta_kubernetes_pod_deployment_name, __meta_kubernetes_pod_cronjob_name and __meta_kubernetes_pod_job_name, respectively. #17774
• [FEATURE] PromQL: Add </ and >/ operators for trimming observations from native histograms. #17904
• [FEATURE] PromQL: Add experimental histogram_quantiles variadic function for computing multiple quantiles at once. #17285
• [FEATURE] TSDB: Add storage.tsdb.retention.percentage configuration to configure the maximum percent of disk usable for TSDB storage. #18080
• [FEATURE] TSDB: Add an experimental fast-startup feature flag that writes a series_state.json file to the WAL directory to track active series state across restarts. #18303
• [FEATURE] TSDB: Add an experimental st-storage feature flag. When enabled, Prometheus stores ingested start timestamps (ST, previously called Created Timestamp) from scrape or OTLP in the TSDB and Agent WAL, and exposes them via Remote Write 2. #18062
• [FEATURE] TSDB: Add an experimental xor2-encoding feature flag for the new TSDB block float sample chunk encoding that is optimized for scraped data and allows encoding start timestamps. #18062
• [ENHANCEMENT] HTTP client: Add AWS external_id support for sigv4. #17916
• [ENHANCEMENT] Kubernetes SD: Deduplicate deprecation warning logs from the Kubernetes API to reduce noise. #17829
• [ENHANCEMENT] TSDB: Remove old temporary checkpoints when creating a Checkpoint. #17598
• [ENHANCEMENT] UI: Add autocomplete support for experimental first_over_time and ts_of_first_over_time PromQL functions. #18318
• [ENHANCEMENT] Vultr SD: Upgrade govultr library from v2 to v3 for continued security patches and maintenance. #18347
• [PERF] PromQL: Improve performance and reduce heap allocations in joins (VectorBinop)/And/Or/Unless. #17159
• [PERF] PromQL: Partially address performance regression in native histogram aggregations due to using KahanAdd. #18252
• [PERF] Remote write: Optimize WAL watching used for RW sending to reuse internal buffers. #18250
• [PERF] TSDB: Optimize LabelValues intersection performance for matchers. #18069
• [PERF] UI: Skip restacking on hover in stacked series charts. #18230
• [BUGFIX] AWS SD: Fix EC2 SD ignoring the configured endpoint option, a regression from the AWS SDK v2 migration. #18133
• [BUGFIX] AWS SD: Fix panic in EC2 SD when DescribeAvailabilityZones returns nil ZoneName or ZoneId. #18133
• [BUGFIX] Agent: Fix memory leak caused by duplicate SeriesRefs being loaded as active series. #17538
• [BUGFIX] Alerting: Fix alert state incorrectly resetting to pending when the FOR period is increased in the config file. #18244
• [BUGFIX] Azure SD: Fix system-assigned managed identity not working when client_id is empty. #18323
• [BUGFIX] Consul SD: Fix filter parameter not being applied to health service endpoint, causing Node and Node.Meta filters to be ignored. #17349
• [BUGFIX] Kubernetes SD: Fix duplicate targets generated by *DualStack EndpointSlices policies. #18192
• [BUGFIX] OTLP: Fix ErrTooOldSample being returned as HTTP 500 instead of 400 in PRW v2 histogram write paths, preventing infinite client retry loops. #18084
• [BUGFIX] OTLP: Fix exemplars getting mixed between incorrect parts of a histogram. #18056
• [BUGFIX] PromQL: Do not skip histogram buckets in queries where histogram trimming is used. #18263
• [BUGFIX] Remote write: Fix prometheus_remote_storage_sent_batch_duration_seconds measuring before the request was sent. #18214
• [BUGFIX] Rules: Fix alert state restoration when rule labels contain Go template expressions. #18375
• [BUGFIX] Scrape: Fix panic when parsing bare label names without an equal sign in brace-only metric notation. #18229
• [BUGFIX] TSDB: Fail early when use-uncached-io feature flag is set on unsupported environments. #18219
• [BUGFIX] TSDB: Fall back to CLI flag values when retention is removed from config file. #18200
• [BUGFIX] TSDB: Fix memory leaks in buffer pools by clearing reference fields before returning buffers to pools. #17895
• [BUGFIX] TSDB: Fix missing mmap of histogram chunks during WAL replay. #18306
• [BUGFIX] TSDB: Fix storage.tsdb.retention.time unit mismatch in file causing retention to be 1e6 times longer than configured. #18200
• [BUGFIX] Tracing: Fix missing traceID in query log when tracing is enabled, previously only spanID was emitted. #18189
• [BUGFIX] UI: Fix tooltip Y-offset drift when using multiple graph panels. #18228
• [BUGFIX] UI: Update retention display in runtime info when config is reloaded. #18200

This release contains bug fixes since the 2.26.0 release. We recommend that you upgrade at the next available opportunity.

Bugfixes

• #9455 Fix memory leak in ColumnarScan

Patch release with a fix in query engine order by logic,backup scheduler configuration update and updates of dependencies.

• Fix order by for nested properties, issue #10732
• Updated deps

• Fix store of settings for scheduled backups

orientdb-community-3.2.51.tar.gz orientdb-community-3.2.51.zip

orientdb-tp3-3.2.51.tar.gz orientdb-tp3-3.2.51.zip

agent-3.2.51.jar

Nacos 3.2.0 is a major release focused on plugin architecture enhancement, AI Registry expansion, API modernization, and code quality improvements. Key highlights include:

• AI Registry Completes the "AI Triad": Skill Registry and Prompt Registry join existing MCP/Agent Registry, with Nacos Copilot integration for AI-assisted management
• Plugin Architecture Modernization: Comprehensive SPI-based plugin management with console UI, cluster-wide synchronization, and PostgreSQL enhancements
• API Cleanup: Legacy UDP PUSH support removed, /v1 and /v2 HTTP APIs extracted to submodules for future removal
• Security & Code Quality: OIDC/OAuth2 authentication plugin, multiple FindBugs fixes, dead code removal, and JDK 17+ compatibility enhancements
• Console Modernization: Dual UI support for new/legacy console switching with improved user experience

• [#13699] Support outputSchema for MCP tools
• [#14041] Merge nacos-plugin PostgreSQL & Base Implementation into main repository
• [#14056] Refactor datasource plugins structure and enhance PostgreSQL capabilities
• [#14077] Implement SPI-based plugin discovery and management API
• [#14078] Implement cluster-wide state synchronization for plugins
• [#14079] Add plugin management console UI and API
• [#14084] Support MCP Tool _meta and annotations fields
• [#14085] Enhance MCP tool metadata with annotations support
• [#14101] Implement cluster-wide state synchronization
• [#14109] Introduce Prompt Registry as core component of Nacos AI Registry
• [#14110] Introduce Skills Registry to complement Nacos AI Registry vision
• [#14117] Add plugin management console UI and API
• [#14120] Add version parameter support to Maintainer SDK Get Agent Card method
• [#14527] Add OIDC/OAuth2 Authentication Plugin (Server)
• [#14534] Add find-skill-from-nacos capability for intelligent skill discovery
• [#14623] Add skill-scanner integration for AI Skill security scanning
• [#14641] Update Nacos console UI with modern design
• [#14653] Support dual UI switching between new and legacy console with contextPath adaptation
• [#14672] Skill support for data level access and visibility Phase 2
• [#14677] Skill support for data level access and visibility Phase 3

• [#14048] Refactor datasource plugins structure and enhance PostgreSQL capabilities
• [#14050] Extract /v1 and /v2 HTTP APIs to submodules for future removal
• [#14052] Remove UDP PUSH support for naming module
• [#14057] Refactor CreateTool and support output scheme
• [#14074] Remove legacy UDP PUSH support from naming module
• [#14122] Add JVM --add-opens options for JDK 17+ compatibility in startup scripts
• [#14125] Activate dev profile by default for plugin dependencies
• [#14441] Refactor version comparison and JSON field handling with constants
• [#14461] Remove obsolete p3c-pmd plugin and cleanup annotations
• [#14463] Unify component scanning with custom package exclusion
• [#14468] Unify component scanning with custom package exclusion
• [#14546] Remove unused common.cache package (dead code from Guava removal attempt)
• [#14585] Refactor admin API input from JSON body to form params
• [#14640] Refactor database plugins and update CI report paths

• [#13770] Fix missing context path in importToolsFromMcp and other AI-related APIs
• [#14009] Fix UUID passing issue in configuration fuzzy listening causing initialization events to be filtered
• [#14016] Fix Console automatic server member synchronization in distributed deployment
• [#14020] Fix missing '?' placeholder in database query
• [#14024] Fix MCP cache index inconsistency when recreating MCP server with same name
• [#14028] Fix remote server selection to use healthy nodes during import/export operations
• [#14063] Fix control plugin bug
• [#14104] Fix AI API context path errors in console
• [#14114] Fix incorrect grayRule detection in ConfigMigrateService
• [#14121] Fix console-ui pagination reset to 0 instead of 1 on API error
• [#14210] Fix MainLayout to handle language changes and fetch notices on update
• [#14307] Add JVM --add-opens options for JDK 17+ compatibility in startup scripts
• [#14401] Fix incorrect created field returned by ConfigRowMapperInjector
• [#14402] Fix MySQL LIKE query escaping to prevent underscore and hyphen confusion
• [#14442] Fix Derby and MySQL LIKE query with proper escape handling
• [#14450] Fix console remote server context-path for maintainer-client
• [#14454] Throw proper exception when form parameters exceed size limit
• [#14471] Replace Long.valueOf() with Long.parseLong() to avoid unnecessary boxing
• [#14479] Fix typo, incorrect Javadoc and improve resource management in health check processors
• [#14484] Add 'type' and 'md5' fields to findConfigInfoLike4PageFetchRows for plugin development
• [#14486] Remove unnecessary equals() override in enum classes
• [#14491] Fix DumpChangeGrayConfigWorker NPE
• [#14509] Fix non-short-circuit operator in for-loop condition
• [#14510] Fix clone() not calling super.clone() in ConfigForm
• [#14515] Fix unnecessary equals() override in enum classes
• [#14527] Add OIDC/OAuth2 Authentication Plugin (Server)
• [#14533] Fix DM_DEFAULT_ENCODING: add explicit charset to avoid platform-dependent encoding
• [#14538] Fix DMI_RANDOM_USED_ONLY_ONCE: replace new Random() with ThreadLocalRandom
• [#14545] Remove unused common.cache package
• [#14547] Fix HE_EQUALS_USE_HASHCODE: add missing hashCode() to Config model classes
• [#14548] Fix NP_PARAMETER_MUST_BE_NONNULL_BUT_MARKED_AS_NULLABLE: add null check in GrpcConnection callback
• [#14567] Fix console-ui TypeError in MainLayout and improve copilot module loading
• [#14616] Fix naming module pagination parameter validation
• [#14622] Exclude json-schema-validator 3.0.0 from agentscope-core to resolve NoClassDefFoundError
• [#14625] Fix NoClassDefFoundError by excluding conflicting json-schema-validator dependency
• [#14635] Fix health status update method to correctly handle persistent instances
• [#14712] Fix Skill ZIP upload losing SKILL.md content

• [#11180] Upgrade jraft-core version to 1.4.0
• [#14006] Upgrade Spring Boot to 3.4.10 to address CVE-2025-55752
• [#14055] Bump org.apache.logging.log4j:log4j-core from 2.24.3 to 2.25.3
• [#14625] Exclude json-schema-validator 3.0.0 from agentscope-core
• [#14714] Upgrade gRPC version to 1.78.0

Action Required: This release introduces significant database schema changes with multiple new tables added for plugin management, AI Registry (Skill/Prompt), and enhanced audit capabilities.

Before upgrading, you must apply the new schema:

1. Backup your existing database
2. Apply the schema upgrade script: conf/schema.sql (for MySQL) or corresponding script for your database type
3. Restart Nacos server after schema migration

Failure to apply the schema changes may result in plugin management, AI Registry, and other new features not functioning correctly.

Action Required: The plugins directory includes the api-legacy-adapter plugin by default to maintain compatibility with extracted /v1 and /v2 HTTP APIs. This plugin will be removed in future versions.

If you have confirmed that your deployment no longer uses the legacy /v1 or /v2 APIs, you can safely remove the api-legacy-adapter plugin from the plugins directory immediately to reduce footprint.

The naming module has removed legacy UDP PUSH support, moving to a cleaner HTTP API architecture. Clients relying on UDP-based service discovery updates must migrate to HTTP-based mechanisms.

Module	Java Required
Nacos-Server / Nacos-Console	Java 17
Nacos-Client	Java 8
Nacos-Maintainer-Client	Java 8

---

• Centralized Management: Create, update, and version skills via UI or API with changelogs
• Skill Composition: Chain multiple MCP tools into business-meaningful capabilities (e.g., "user_onboarding" = verify_email + create_profile + send_welcome_email)
• MCP Integration: Skills explicitly declare dependencies on registered MCP tools with integrity validation
• Folder-based Organization: Skills displayed in multi-level folder structure for better organization
• Agent-Friendly APIs: REST/gRPC APIs for agent frameworks (LangChain, CrewAI, etc.) to discover and subscribe to skills
• Upload Support: Upload skill packages (zip format, max 10MB) with authentication
• Security Scanning: Integrated skill-scanner for AI Skill security validation
• Data Level Access: Fine-grained visibility and access control (Phase 2 & 3)

• First-Class Configuration: Store prompts with metadata (agentId, modelId, version, tags) as versioned config artifacts
• Multi-Version Management: Support parallel multi-version management with template and commit message tracking
• Tag-Based Subscription: Subscribe to prompts by tags for dynamic updates
• Interactive Debugging: Test and compare prompt outputs across versions directly in console
• AI Client Proxy: Unified HTTP/gRPC client interface for prompt operations

• AI-Powered Assistant: Integrated AI assistant to help optimize and create Prompts and Skills
• Intelligent Discovery: Automatically find relevant existing skills from the registry
• Console Integration: Accessible directly from Nacos console for seamless workflow

---

• @INotWant made their first contribution in https://github.com/alibaba/nacos/pull/14009
• @QingYuanQ made their first contribution in https://github.com/alibaba/nacos/pull/14020
• @echooymxq made their first contribution in https://github.com/alibaba/nacos/pull/14100
• @shichaoyuan made their first contribution in https://github.com/alibaba/nacos/pull/14099
• @chlch made their first contribution in https://github.com/alibaba/nacos/pull/14104
• @lvren1485 made their first contribution in https://github.com/alibaba/nacos/pull/14210
• @slightsharp made their first contribution in https://github.com/alibaba/nacos/pull/14263
• @Cholesterol12138 made their first contribution in https://github.com/alibaba/nacos/pull/14357
• @codezkk made their first contribution in https://github.com/alibaba/nacos/pull/14401
• @1lck made their first contribution in https://github.com/alibaba/nacos/pull/14449
• @Zjianru made their first contribution in https://github.com/alibaba/nacos/pull/14461
• @qiacheng7 made their first contribution in https://github.com/alibaba/nacos/pull/14465
• @aMetric made their first contribution in https://github.com/alibaba/nacos/pull/14477
• @DocJlm made their first contribution in https://github.com/alibaba/nacos/pull/14480
• @java-acc made their first contribution in https://github.com/alibaba/nacos/pull/14485
• @FrioSea made their first contribution in https://github.com/alibaba/nacos/pull/14476
• @saynoword made their first contribution in https://github.com/alibaba/nacos/pull/14534
• @pierluigilenoci made their first contribution in https://github.com/alibaba/nacos/pull/14706
• @daguimu made their first contribution in https://github.com/alibaba/nacos/pull/14730

Full Changelog: https://github.com/alibaba/nacos/compare/3.1.1...3.2.0