alibaba /nacos
an easy-to-use dynamic service discovery, configuration and service management platform for building AI cloud native applications.
★ 33,524⑂ 13,288👁 887⑃ 5,526● 9,880▤ 103
+1
Daily
+28
Weekly
+85
Monthly
33,524
stars
13,288
forks
887
watchers
5,526
prs
9,880
issues
103
releases
README
Nacos: Dynamic Naming and Configuration Service
-------
What does it do
Nacos (official site: nacos.io) is an easy-to-use platform designed for dynamic service discovery and configuration and service management. It helps you to build cloud native applications and microservices platform easily.
Service is a first-class citizen in Nacos. Nacos supports almost all type of services,for example,Dubbo/gRPC service, Spring Cloud RESTFul service or Kubernetes service.
Nacos provides four major functions.
Service Discovery and Service Health Check
Nacos makes it simple for services to register themselves and to discover other services via a DNS or HTTP interface. Nacos also provides real-time health checks of services to prevent sending requests to unhealthy hosts or service instances.
Dynamic Configuration Management
Dynamic Configuration Service allows you to manage configurations of all services in a centralized and dynamic manner across all environments. Nacos eliminates the need to redeploy applications and services when configurations are updated, which makes configuration changes more efficient and agile.
Dynamic DNS Service
Nacos supports weighted routing, making it easier for you to implement mid-tier load balancing, flexible routing policies, flow control, and simple DNS resolution services in the production environment within your data center. It helps you to implement DNS-based service discovery easily and prevent applications from coupling to vendor-specific service discovery APIs.
Service and MetaData Management
Nacos provides an easy-to-use service dashboard to help you manage your services metadata, configuration, kubernetes DNS, service health and metrics statistics.
The web console is available in the following languages: 中文, English, Русский(only new UI)
Quick Start
It is super easy to get started with your first project.
Deploying Nacos on cloud
You can deploy Nacos on cloud, which is the easiest and most convenient way to start Nacos.
Use the following Nacos deployment guide to see more information and deploy a stable and out-of-the-box Nacos server.
Start by the provided startup package
Step 1: Download the binary package
You can download the package from the latest stable release.
Take release nacos-server-1.0.0.zip for example:
sh
unzip nacos-server-1.0.0.zip
cd nacos/bin
Step 2: Start Server
On the Linux/Unix/Mac platform, run the following command to start server with standalone mode:
sh
sh startup.sh -m standalone
On the Windows platform, run the following command to start server with standalone mode. Alternatively, you can also double-click the startup.cmd to run NacosServer.
startup.cmd -m standalone
For more details, see quick-start.
Quick start for other open-source projects:
Quick start with Nacos command and console
Quick start with dubbo
Quick start with spring cloud
Quick start with kubernetes
Documentation
You can viewTop issues
#273Wanted: Who is using Nacos227 comments · 2018-11-14#9129What features do you expect from Nacos 3.0?63 comments · 2022-09-12#4336nacos 1.4.0 多平台兼容性疑问55 comments · 2020-11-26#14683[Proposal] Unified Multi-Language SDK Protocol Definitions via Shared Proto Repository35 comments · 2026-03-21#15837Nacos native Docker image support32 comments · 2026-09-10#15473Nacos1.4.2版本集群扩容和缩容问题26 comments · 2026-07-08#2272Batch offline service based on IP address24 comments · 2020-01-08#422nacos客户端如何批量获取配置以及监听某个group下新增dataId变化22 comments · 2018-12-10
Discussions
#15974The data in the Nacos 2.1.2 cluster is not synchronized(Nacos 2.1.2 集群数据不同步)0 comments · 2026-11-02#15942Start up fail1 comments · 2026-10-25#15917通过waypoint代理访问nacos检测链接总是非法id0 comments · 2026-10-17#15912Nacos 与 Springboot-3.5 的版本兼容性问题2 comments · 2026-10-14#15909nacos怎么从一个k8s集群迁移到另一个k8s集群呢?0 comments · 2026-10-13#15904Expected release date for Nacos 3.3.0 GA?0 comments · 2026-10-11#15882nacos2.1缩容导致ipcount数量下降1 comments · 2026-09-28#15881nacos3.2.4,控制台手动添加配置,数据库会产生两条一模一样的数据,一条tenant_id='',一条tanent_id='public'0 comments · 2026-09-27
Latest release
3.3.0(Oct 29th, 2026) 3.3.0 2026-10-29Nacos 3.3.0 Nacos 3.3.0 is a feature iteration release for the Nacos 3.x series. It brings protocol-neutral Agent management and discovery, shared AI resource search, and unified MCP lifecycle management to the stable release. This release focuses on: - AI Registry capabilities across Agent, AgentSpec, Skill, Prompt, and MCP resources. - DNS service discovery and distributed locks. - Dynamic plugin management and authentication enabled by default. - Spring Boot 4 and Jackson 3 compatibility, with improved client and server reliability. The main feature updates include: - Agen