Go to file
luhuabin 08da133e55
Code Coverage / ci (17, ubuntu-latest) (push) Waiting to run Details
PUSH-CI / Build dist tar (push) Waiting to run Details
PUSH-CI / Docker images (centos, 17) (push) Blocked by required conditions Details
PUSH-CI / Deploy nacos (push) Blocked by required conditions Details
PUSH-CI / Java e2e Test (push) Blocked by required conditions Details
PUSH-CI / GO E2E Test (push) Blocked by required conditions Details
PUSH-CI / Cpp E2E Test (push) Blocked by required conditions Details
PUSH-CI / Csharp E2E Test (push) Blocked by required conditions Details
PUSH-CI / Nodejs E2E Test (push) Blocked by required conditions Details
PUSH-CI / Python E2E Test (push) Blocked by required conditions Details
PUSH-CI / Clean (push) Blocked by required conditions Details
fix: service NullPointerException when getSpec() (#13868)
2025-09-29 17:08:58 +08:00
.github Split ci workflow to code cover and pull request ci. (#13467) 2025-06-04 16:14:25 +08:00
.mvn/wrapper 🔧 add mvnw (#13422) 2025-05-23 14:11:44 +08:00
address Upgrade to SpringBoot 3 and support GraalVM packaging (#13020) 2025-01-08 09:49:56 +08:00
ai adapt to new registry api (#13849) 2025-09-23 15:36:33 +08:00
api adapt to new registry api (#13849) 2025-09-23 15:36:33 +08:00
auth fix(auth): add AI gRPC resource parser and enable auth for MCP/Agent requests (#13827) 2025-09-18 10:14:34 +08:00
bootstrap feat: remove deployment type config (#13807) 2025-09-15 20:13:51 +08:00
client Fix agentCard subscribe judgement problem. (#13830) 2025-09-18 16:30:40 +08:00
client-basic Update ClientBasicParamUtil.java (#13537) 2025-06-23 13:59:19 +08:00
cmdb V3.0 develop console mode (#13134) 2025-02-25 18:27:01 +08:00
common [ISSUE#13322] Refactor a2a registry implementation (#13794) 2025-09-11 16:05:11 +08:00
config fix null point exception (#13861) 2025-09-29 09:54:30 +08:00
consistency Upgrade os-maven-plugin version to 1.7.1 (#13385) 2025-08-25 11:18:30 +08:00
console [ISSUE#13322] Add unit test for agent registration. (#13836) 2025-09-22 09:51:53 +08:00
console-ui adapt to new registry api (#13849) 2025-09-23 15:36:33 +08:00
core [ISSUE#13322] Refactor a2a registry implementation (#13794) 2025-09-11 16:05:11 +08:00
distribution For #13863, make multiple pids into a single line in shutdown.sh (#13864) 2025-09-29 09:46:16 +08:00
doc nacos is coming 2018-07-21 00:27:23 +08:00
example optimize fuzzy watch of config&naming. 2025-01-09 15:28:00 +08:00
istio [#13458] Fix nacos start up failure when set functionMode is config or naming. (#13564) 2025-06-26 16:48:40 +08:00
k8s-sync fix: service NullPointerException when getSpec() (#13868) 2025-09-29 17:08:58 +08:00
lock Fix Unit test problem. 2025-01-10 14:35:50 +08:00
logger-adapter-impl [#13524] Add client api for AI mcp (#13610) 2025-07-15 19:08:02 +08:00
maintainer-client [ISSUE#13322] Add unit test for agent registration. (#13836) 2025-09-22 09:51:53 +08:00
mcp-registry-adaptor adapt to new registry api (#13849) 2025-09-23 15:36:33 +08:00
naming [ISSUE #12191]: Add namespace existence check (#13687) 2025-08-28 13:33:55 +08:00
persistence Merge remote-tracking branch 'refs/remotes/upstream/develop' into v3.0-develop-sync-develop 2025-04-22 19:47:57 +08:00
plugin 【Fix issue #13600】 auth error when non-admin users clone config (#13674) 2025-08-05 19:16:04 +08:00
plugin-default-impl [ISSUE #13761]Fix: Add validation when deleting roles to prevent issues like mistakenly deleting ROLE_ADMIN. (#13764) 2025-09-02 16:45:13 +08:00
prometheus V3.0 develop fix ut (#13167) 2025-03-10 15:38:27 +08:00
resources fix copyright. (#6389) 2021-07-20 09:47:08 +08:00
server [#13458] Fix nacos start up failure when set functionMode is config or naming. (#13564) 2025-06-26 16:48:40 +08:00
style doc: fix a typo in code-style file (#13204) 2025-03-26 11:21:27 +08:00
sys feat: grpc server startup support listen on specified ip (#13592) 2025-07-16 16:00:24 +08:00
test [#13524] support frontend endpoint (#13652) 2025-07-28 20:23:57 +08:00
.gitattributes Fix #339 Project language problem identified in github 2019-01-22 10:02:01 +08:00
.gitignore Develop support ram info switch (#12382) 2024-07-19 11:22:35 +08:00
.travis.yml Build and test on Linux ARM64 at TravisCI (#7777) 2022-02-21 17:10:00 +08:00
BUILDING 🔧 add mvnw (#13422) 2025-05-23 14:11:44 +08:00
CHANGELOG.md fix:Use the article an before instance (#11759) 2024-02-27 09:24:02 +08:00
CODE_OF_CONDUCT.md Create CODE_OF_CONDUCT.md 2018-11-07 22:50:14 +08:00
CONTRIBUTING.md [Document] Fix some translation issues (#8507) 2022-06-07 15:35:53 +08:00
LICENSE fix LICENSE by https://www.apache.org/licenses/LICENSE-2.0.txt (#6277) 2021-07-07 10:00:29 +08:00
NOTICE update notice (#7939) 2022-03-15 13:34:41 +08:00
README.md fix: logo layout (#13664) 2025-07-31 17:10:03 +08:00
REPORTING-BUGS.md syntax error (#10041) 2023-03-06 10:20:50 +08:00
codecov.yml Add codeCov report after CI finish (#8344) 2022-05-11 16:20:28 +08:00
mvnw 🔧 add mvnw (#13422) 2025-05-23 14:11:44 +08:00
mvnw.cmd 🔧 add mvnw (#13422) 2025-05-23 14:11:44 +08:00
pom.xml Upgrade version to 3.1.0. (#13839) 2025-09-22 10:56:34 +08:00

README.md

Nacos: Dynamic Naming and Configuration Service

Gitter License Gitter Ask DeepWiki


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 servicesfor exampleDubbo/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.

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:

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 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:

Documentation

You can view the full documentation from the Nacos website.

You can also read this online eBook from the NACOS ARCHITECTURE & PRINCIPLES.

All the latest and long-term notice can also be found here from GitHub notice issue.

Contributing

Contributors are welcomed to join Nacos project. Please check CONTRIBUTING about how to contribute to this project.

How can I contribute?

  • Take a look at issues with tags marked good first issue or contribution welcome.
  • Answer questions on issues.
  • Fix bugs reported on issues, and send us a pull request.
  • Review the existing pull request.
  • Improve the website, typically we need
    • blog post
    • translation on documentation
    • use cases around the integration of Nacos in enterprise systems.
  • nacos-spring-project provides the integration functionality for Spring.
  • nacos-group is the repository that hosts the eco tools for Nacos, such as SDK, synchronization tool, etc.
  • spring-cloud-alibaba provides the one-stop solution for application development over Alibaba middleware which includes Nacos.

Contact

  • Gitter: Nacos's IM tool for community messaging, collaboration and discovery.
  • Twitter: Follow along for latest nacos news on Twitter.
  • Weibo: Follow along for latest nacos news on Weibo (Twitter of China version).
  • Nacos Segmentfault: Get latest notice and prompt help from Segmentfault.
  • Email Group:
    • users-nacos@googlegroups.com: Nacos usage general discussion.
    • dev-nacos@googlegroups.com: Nacos developer discussion (APIs, feature design, etc).
    • commits-nacos@googlegroups.com: Commits notice, very high frequency.
  • Join us from DingDing(Group 1: 21708933(full), Group 2: 30438813(full), Group 3: 31222241(full), Group 4: 12810027056).

DingDing Group QR Code

DingDing MCP Group QR Code

WeChat Group QR Code

Enterprise Service

If you need Nacos enterprise service support, or purchase cloud product services, you can join the discussion by scanning the following DingTalk group. It can also be directly activated and used through the microservice engine (MSE) provided by Alibaba Cloud. https://cn.aliyun.com/product/aliware/mse?spm=nacos-website.topbar.0.0.0

Download

Who is using

These are only part of the companies using Nacos, for reference only. If you are using Nacos, please add your company here to tell us your scenario to make Nacos better.

Alibaba Group 虎牙直播 ICBC 爱奇艺
平安科技 华夏信财 优客工场 贝壳找房
瑞安农村商业银行 司法大数据 搜易贷 平行云
甘肃紫光 海云天 Acmedcare+ 北京天合互联信息有限公司
上海密尔克卫化工 大连新唯 立思辰 东家
上海克垚 联采科技 南京28研究所 凤凰网-汽车
中化信息 一点车 明传无线 妙优车
蜂巢 华存数据 数云 广通软件
菜菜 科蓝公司 浩鲸 未名天日语
金联创 同窗链 顺能 百世快递
汽车之家 鲸打卡 时代光华 康美
环球易购 Nepxion chigua 宅无限
天阙 联合永道 明源云 DaoCloud
美菜 松格科技 集萃智能 吾享
拓深科技 长亮科技 深圳易停车库 武汉日创科技
易管智能 云帐房 三诺生物
郑州山水 知氏教育