由浅入深学习Nacos：从入门到实战部署

最新推荐文章于 2025-04-30 11:48:02 发布
最新推荐文章于 2025-04-30 11:48:02 发布
阅读量833 收藏 24
点赞数 8
分类专栏： [软件工程] 框架 [系统搭建] 中间件 文章标签： Nacos
版权声明：本文为博主原创文章，遵循 CC 4.0 BY 版权协议，转载请附上原文出处链接和本声明。
本文链接：https://blog.csdn.net/niaonao/article/details/145894265
版权

由浅入深学习Nacos：从入门到实战部署

一、Nacos是什么？

Nacos（Dynamic Naming and Configuration Service）是阿里巴巴开源的一款集服务发现、配置管理、服务管理于一体的云原生平台。它支持动态服务注册与发现、配置动态更新、服务健康监测等功能，是构建微服务架构的核心基础设施之一。

  • 服务发现：微服务实例自动注册到Nacos，其他服务可通过服务名动态发现实例。
  • 配置管理：集中管理应用配置，支持实时推送更新，避免配置硬编码。
  • 服务管理：提供健康检查、流量管理、动态路由等能力，保障服务高可用。

在这里插入图片描述

二、Nacos功能特性

1. 核心功能

  • 服务注册与发现：支持基于DNS和HTTP的服务注册，提供健康检查机制。
  • 动态配置管理：通过控制台或API管理配置，支持灰度发布和多环境隔离。
  • 服务元数据管理：为服务添加自定义元数据（如版本、权重），支持精细化流量控制。
  • 集群管理：支持多节点集群部署，保障高可用和容灾能力。

2. 适用场景

  • 微服务架构中的服务治理。
  • 分布式系统的配置中心。
  • 混合云环境下的服务统一管理。

三、Nacos部署模式

Nacos支持三种部署模式，适应不同场景需求：

  1. 单机模式：适用于开发测试环境，资源占用低，启动快速。
  2. 集群模式：生产环境推荐，通过多节点保障高可用。
  3. 多集群模式：跨数据中心部署，解决异地容灾问题。

在这里插入图片描述

四、Nacos单机模式部署实战

在这里插入图片描述
访问官网下载地址

1. 版本1.4.8下载及部署（Nacos 1.x 已经停止功能维护，可跳过该版本看2.5.0部署）

步骤1：下载与解压
  • 此处选择nacos-server-1.4.8.zip。
  • 解压至非中文路径（如D:\nacos-server-1.4.8）。
步骤2：配置单机模式
  • 修改启动脚本bin/startup.cmd，设置运行模式为单机：
    set MODE="standalone"
步骤3：启动与验证
  • 执行bin/startup.cmd启动服务，默认端口8848。
  • 访问http://localhost:8848/nacos，使用默认账号nacos/nacos登录。
  • 验证成功标志：控制台显示服务健康状态，无报错日志。
D:\nacos-server-1.4.8\nacos\bin>startup.cmd
"nacos is starting with standalone"

         ,--.
       ,--.'|
   ,--,:  : |                                           Nacos 1.4.8
,`--.'`|  ' :                       ,---.               Running in stand alone mode, All function modules
|   :  :  | |                      '   ,'\   .--.--.    Port: 8848
:   |   \ | :  ,--.--.     ,---.  /   /   | /  /    '   Pid: 14544
|   : '  '; | /       \   /     \.   ; ,. :|  :  /`./   Console: http://192.168.8.36:8848/nacos/index.html
'   ' ;.    ;.--.  .-. | /    / ''   | |: :|  :  ;_
|   | | \   | \__\/: . ..    ' / '   | .; : \  \    `.      https://nacos.io
'   : |  ; .' ," .--.; |'   ; :__|   :    |  `----.   \
|   | '`--'  /  /  ,.  |'   | '.'|\   \  /  /  /`--'  /
'   : |     ;  :   .'   \   :    : `----'  '--'.     /
;   |.'     |  ,     .-./\   \  /            `--'---'
'---'        `--`---'     `----'

2025-02-17 10:08:16,229 INFO Tomcat initialized with port(s): 8848 (http)

2025-02-17 10:08:16,574 INFO Root WebApplicationContext: initialization completed in 2042 ms

2025-02-17 10:08:18,602 INFO Adding welcome page: class path resource [static/index.html]

2025-02-17 10:08:18,911 WARN You are asking Spring Security to ignore Ant [pattern='/**']. This is not recommended -- please use permitAll via HttpSecurity#authorizeHttpRequests instead.

2025-02-17 10:08:18,912 INFO Will not secure Ant [pattern='/**']

2025-02-17 10:08:18,933 INFO Will secure any request with [org.springframework.security.web.session.DisableEncodeUrlFilter@3b0c9195, org.springframework.security.web.context.request.async.WebAsyncManagerIntegrationFilter@366c4480, org.springframework.security.web.context.SecurityContextPersistenceFilter@293a5f75, org.springframework.security.web.header.HeaderWriterFilter@37efd131, org.springframework.security.web.csrf.CsrfFilter@a43ce46, org.springframework.security.web.authentication.logout.LogoutFilter@60975100, org.springframework.security.web.savedrequest.RequestCacheAwareFilter@1dd6d4b7, org.springframework.security.web.servletapi.SecurityContextHolderAwareRequestFilter@2dd29a59, org.springframework.security.web.authentication.AnonymousAuthenticationFilter@2c7b5824, org.springframework.security.web.session.SessionManagementFilter@7e5d9a50, org.springframework.security.web.access.ExceptionTranslationFilter@3d97a632]

2025-02-17 10:08:18,960 INFO Exposing 1 endpoint(s) beneath base path '/actuator'

2025-02-17 10:08:19,013 INFO Tomcat started on port(s): 8848 (http) with context path '/nacos'

2025-02-17 10:08:19,028 INFO Nacos started successfully in stand alone mode. use embedded storage

在这里插入图片描述
在这里插入图片描述

步骤4：关闭服务

本地使用命令行窗口启动，通过Ctrl+C关闭服务即可。

可选：MySQL持久化

Nacos数据存储类似Redis，默认在内存中存储，也支持数据持久化。
单机模式下支持MySQL，通过以下配置开启持久化。不开启则默认使用内存存储

  • 创建数据库nacos-config，执行conf/mysql-schema.sql初始化表结构。
  • 修改conf/application.properties，配置MySQL连接：
    spring.datasource.platform=mysql
db.url.0=jdbc:mysql://127.0.0.1:3306/nacos-config?useSSL=false&serverTimezone=UTC
db.user.0=root
db.password.0=root

启动日志

D:\nacos-server-1.4.8\nacos\bin>startup.cmd
"nacos is starting with standalone"

         ,--.
       ,--.'|
   ,--,:  : |                                           Nacos 1.4.8
,`--.'`|  ' :                       ,---.               Running in stand alone mode, All function modules
|   :  :  | |                      '   ,'\   .--.--.    Port: 8848
:   |   \ | :  ,--.--.     ,---.  /   /   | /  /    '   Pid: 6292
|   : '  '; | /       \   /     \.   ; ,. :|  :  /`./   Console: http://192.168.8.36:8848/nacos/index.html
'   ' ;.    ;.--.  .-. | /    / ''   | |: :|  :  ;_
|   | | \   | \__\/: . ..    ' / '   | .; : \  \    `.      https://nacos.io
'   : |  ; .' ," .--.; |'   ; :__|   :    |  `----.   \
|   | '`--'  /  /  ,.  |'   | '.'|\   \  /  /  /`--'  /
'   : |     ;  :   .'   \   :    : `----'  '--'.     /
;   |.'     |  ,     .-./\   \  /            `--'---'
'---'        `--`---'     `----'

2025-02-17 10:27:28,857 INFO Tomcat initialized with port(s): 8848 (http)

2025-02-17 10:27:29,177 INFO Root WebApplicationContext: initialization completed in 1818 ms

2025-02-17 10:27:30,168 WARN There are no [com.alibaba.nacos.config.server.model.event.LocalDataChangeEvent] publishers for this event, please register

2025-02-17 10:27:30,170 WARN There are no [com.alibaba.nacos.config.server.model.event.LocalDataChangeEvent] publishers for this event, please register

2025-02-17 10:27:30,172 WARN There are no [com.alibaba.nacos.config.server.model.event.LocalDataChangeEvent] publishers for this event, please register

2025-02-17 10:27:30,174 WARN There are no [com.alibaba.nacos.config.server.model.event.LocalDataChangeEvent] publishers for this event, please register

2025-02-17 10:27:30,179 WARN There are no [com.alibaba.nacos.config.server.model.event.LocalDataChangeEvent] publishers for this event, please register

2025-02-17 10:27:30,181 WARN There are no [com.alibaba.nacos.config.server.model.event.LocalDataChangeEvent] publishers for this event, please register

2025-02-17 10:27:30,183 WARN There are no [com.alibaba.nacos.config.server.model.event.LocalDataChangeEvent] publishers for this event, please register

2025-02-17 10:27:30,186 WARN There are no [com.alibaba.nacos.config.server.model.event.LocalDataChangeEvent] publishers for this event, please register

2025-02-17 10:27:30,187 WARN There are no [com.alibaba.nacos.config.server.model.event.LocalDataChangeEvent] publishers for this event, please register

2025-02-17 10:27:30,188 WARN There are no [com.alibaba.nacos.config.server.model.event.LocalDataChangeEvent] publishers for this event, please register

2025-02-17 10:27:30,600 INFO Adding welcome page: class path resource [static/index.html]

2025-02-17 10:27:31,015 WARN You are asking Spring Security to ignore Ant [pattern='/**']. This is not recommended -- please use permitAll via HttpSecurity#authorizeHttpRequests instead.

2025-02-17 10:27:31,017 INFO Will not secure Ant [pattern='/**']

2025-02-17 10:27:31,047 INFO Will secure any request with [org.springframework.security.web.session.DisableEncodeUrlFilter@5b068087, org.springframework.security.web.context.request.async.WebAsyncManagerIntegrationFilter@6f152006, org.springframework.security.web.context.SecurityContextPersistenceFilter@1d131e1b, org.springframework.security.web.header.HeaderWriterFilter@5e1fa5b1, org.springframework.security.web.csrf.CsrfFilter@35a9782c, org.springframework.security.web.authentication.logout.LogoutFilter@61e94def, org.springframework.security.web.savedrequest.RequestCacheAwareFilter@615091b8, org.springframework.security.web.servletapi.SecurityContextHolderAwareRequestFilter@4aa83f4f, org.springframework.security.web.authentication.AnonymousAuthenticationFilter@3a393455, org.springframework.security.web.session.SessionManagementFilter@2f17e30d, org.springframework.security.web.access.ExceptionTranslationFilter@158a3b2e]

2025-02-17 10:27:31,078 INFO Exposing 1 endpoint(s) beneath base path '/actuator'

2025-02-17 10:27:31,151 INFO Tomcat started on port(s): 8848 (http) with context path '/nacos'

2025-02-17 10:27:31,173 INFO Nacos started successfully in stand alone mode. use external storage

2025-02-17 10:27:31,373 INFO Initializing Servlet 'dispatcherServlet'

2025-02-17 10:27:31,375 INFO Completed initialization in 2 ms

初始化一些config_info配置数据，登入Nacos可以看到配置列表。
在这里插入图片描述
在这里插入图片描述

2. 版本2.5.0下载及部署

步骤1：下载与解压
  • 下载nacos-server-2.5.0.zip，解压至非中文路径（如D:\nacos-server-2.5.0）。
步骤2：启动与常见问题

  • 问题1：缺少RocksDB依赖库
    现象：启动时报错java.lang.UnsatisfiedLinkError: Can't find dependent libraries。
    原因：在Windows本地启用Nacos 2.5.0版本时，遇到java.lang.UnsatisfiedLinkError: C:\librocksdbjni3694313270395220997.dll: Can’t find dependent libraries错误，通常是因为缺少RocksDB所需的依赖库。RocksDB是一个高性能的嵌入式数据库，Nacos使用它来存储数据。
    解决方案：

    1. 安装Visual C++ Redistributable 2015-2022。
    2. 重启系统后重新启动Nacos。

    在这里插入图片描述

  • 问题2：表结构不兼容
    现象：启动时提示表缺失。
    解决方案：
    使用对应版本的mysql-schema.sql初始化数据库，确保表结构与版本匹配。

步骤3：验证启动
  • 启动成功后，访问控制台确认功能正常，日志显示Nacos started successfully。
D:\product\unsoft\nacos-server-2.5.0\nacos\bin>startup.cmd
"nacos is starting with standalone"

         ,--.
       ,--.'|
   ,--,:  : |                                           Nacos 2.5.0
,`--.'`|  ' :                       ,---.               Running in stand alone mode, All function modules
|   :  :  | |                      '   ,'\   .--.--.    Port: 8848
:   |   \ | :  ,--.--.     ,---.  /   /   | /  /    '   Pid: 13252
|   : '  '; | /       \   /     \.   ; ,. :|  :  /`./   Console: http://192.168.8.36:8848/nacos/index.html
'   ' ;.    ;.--.  .-. | /    / ''   | |: :|  :  ;_
|   | | \   | \__\/: . ..    ' / '   | .; : \  \    `.      https://nacos.io
'   : |  ; .' ," .--.; |'   ; :__|   :    |  `----.   \
|   | '`--'  /  /  ,.  |'   | '.'|\   \  /  /  /`--'  /
'   : |     ;  :   .'   \   :    : `----'  '--'.     /
;   |.'     |  ,     .-./\   \  /            `--'---'
'---'        `--`---'     `----'

2025-02-17 14:17:18,145 INFO Tomcat initialized with port(s): 8848 (http)

2025-02-17 14:17:18,664 INFO Root WebApplicationContext: initialization completed in 3608 ms

2025-02-17 14:17:23,549 INFO Will secure any request with [org.springframework.security.web.session.DisableEncodeUrlFilter@19ae6bb, org.springframework.security.web.context.request.async.WebAsyncManagerIntegrationFilter@10993713, org.springframework.security.web.context.SecurityContextPersistenceFilter@cb191ca, org.springframework.security.web.header.HeaderWriterFilter@30bcf3c1, org.springframework.security.web.csrf.CsrfFilter@2fc0cc3, org.springframework.security.web.authentication.logout.LogoutFilter@505a9d7c, org.springframework.security.web.savedrequest.RequestCacheAwareFilter@a776e, org.springframework.security.web.servletapi.SecurityContextHolderAwareRequestFilter@79145d5a, org.springframework.security.web.authentication.AnonymousAuthenticationFilter@58359ebd, org.springframework.security.web.session.SessionManagementFilter@15cafec7, org.springframework.security.web.access.ExceptionTranslationFilter@67ab1c47]

2025-02-17 14:17:23,888 INFO Adding welcome page: class path resource [static/index.html]

2025-02-17 14:17:24,323 INFO Exposing 1 endpoint(s) beneath base path '/actuator'

2025-02-17 14:17:24,345 WARN You are asking Spring Security to ignore Ant [pattern='/**']. This is not recommended -- please use permitAll via HttpSecurity#authorizeHttpRequests instead.

2025-02-17 14:17:24,346 INFO Will not secure Ant [pattern='/**']

2025-02-17 14:17:24,347 WARN You are asking Spring Security to ignore Mvc [pattern='/prometheus']. This is not recommended -- please use permitAll via HttpSecurity#authorizeHttpRequests instead.

2025-02-17 14:17:24,347 INFO Will not secure Mvc [pattern='/prometheus']

2025-02-17 14:17:24,347 WARN You are asking Spring Security to ignore Mvc [pattern='/prometheus/namespaceId/{namespaceId}']. This is not recommended -- please use permitAll via HttpSecurity#authorizeHttpRequests instead.

2025-02-17 14:17:24,347 INFO Will not secure Mvc [pattern='/prometheus/namespaceId/{namespaceId}']

2025-02-17 14:17:24,347 WARN You are asking Spring Security to ignore Mvc [pattern='/prometheus/namespaceId/{namespaceId}/service/{service}']. This is not recommended -- please use permitAll via HttpSecurity#authorizeHttpRequests instead.

2025-02-17 14:17:24,347 INFO Will not secure Mvc [pattern='/prometheus/namespaceId/{namespaceId}/service/{service}']

2025-02-17 14:17:24,413 INFO Tomcat started on port(s): 8848 (http) with context path '/nacos'

2025-02-17 14:17:24,430 INFO No TaskScheduler/ScheduledExecutorService bean found for scheduled processing

2025-02-17 14:17:24,462 INFO Nacos started successfully in stand alone mode. use embedded storage

3. 部署中的常见问题及解决方案

问题1：客户端注册失败（版本冲突）
  • 现象：客户端报错nacos registry failed。
  • 原因：客户端版本（如2.2.0）高于服务端（如1.4.8）。
  • 解决：升级服务端至2.5.0，确保版本兼容。
问题2：端口占用或网络不通
  • 检查步骤：
    1. 使用netstat -ano | findstr 8848确认端口未被占用。
    2. 通过telnet 127.0.0.1 8848测试连通性。
问题3：配置加载失败
  • 排查方向：
    1. 检查application.properties中的数据库配置是否正确。
    2. 确保MySQL服务已启动，且用户权限充足。

五、官方FAQ与资源

  • 官方FAQ：参考Nacos用户常见问题。
  • 最佳实践：
    • 生产环境务必使用集群模式，并配置持久化数据库。
    • 定期备份Nacos配置文件及数据库。

结语

Nacos作为微服务生态的核心组件，其灵活性和易用性为开发者提供了强大支持。通过本文的实战指南，无论是新手还是经验丰富的开发者，都能快速掌握单机部署及问题排查技巧。建议在实际项目中结合业务需求，逐步探索集群部署与高级功能，构建稳定高效的微服务体系。

Nacos入门学习
悠悠寻燕语
04-27 310
一、软件版本（win10）： 1、软件名称 nacos-server-1.4.3.zip 2、下载地址 链接 3、解压软件，解压后的目录如下 二、修改配置，启动软件 1、修改nacos-server-1.4.3\nacos\bin\startup.cmd文件 第26行 set MODE=“cluster” 改为 set MODE=“standalone” 2、双击nacos-server-1.4.3\nacos\bin\startup.cmd启动软件，启动后的界面如下 三、使用数据库 1、新建MySql
Nacos实战攻略：从入门到精通，全面掌握服务治理与配置管理！（上）
邓邓子的博客
11-22 963
在当今的云计算和微服务架构时代，服务发现和配置管理是构建高可用、高灵活性的分布式系统的关键组成部分。Nacos（Naming and Configuration Service）作为阿里巴巴开源的一个全新的注册中心和配置中心，旨在解决微服务架构中的服务发现和配置管理问题，为开发者提供了一种更加高效、便捷的解决方案。
Nacos学习之初识Nacos
2501_90256713的博客
01-18 667
0、写在前面_什么是微服务在了解Nacos之前应该知道什么是微服务架构；微服务架构就是把一个单体项目拆分为多个微小的服务,每个微服务可以在自己的进程中运行并与HTTP资源API进行通信。围绕业务功能进行构建，独立技术选型，独立开发，独立部署，独立运维，并且多个服务相互协调，相互配合，最终完成用户的价值；注：微服务架构只是一个样式，一种风格；可以将一个项目，拆分成多个模块去开发；每一个模块都是单独运行在自己的容器中的；每个模块需要相互通讯（HTTP、MQ）；
全面掌握Nacos：安装、配置及微服务集成教程
最新发布
weixin_36328210的博客
04-30 1233
Nacos（即NAming and COnfiguration Service）是一个易于使用的动态服务发现、配置和服务管理平台，旨在构建云原生应用。它支持微服务中的服务发现与注册、动态配置管理、服务健康监测等多种功能。Nacos能够帮助开发者更好地管理服务的配置信息，并实现服务的快速发现和故障转移。在实际部署和使用Nacos时，可能需要根据特定需求调整一些配置项以达到预期的性能和功能。下面将详细描述如何自定义这些配置项：修改端口：如果你的服务端口冲突，或者出于安全考虑需要更换端口，只需修改。
Nacos学习
sunyanchun的专栏
07-18 744
什么是nacos Nacos 支持基于 DNS 和基于 RPC 的服务发现（可以作为springcloud的注册中心）、动态配置服务（可以做配置中心）、动态 DNS 服务。 官方介绍是这样的： Nacos 致力于帮助您发现、配置和管理微服务。Nacos 提供了一组简单易用的特性集，帮助您实现动态服务发现、服务配置管理、服务及流量管理。 Nacos 帮助您更敏捷和容易地构建、交付和管理微服务平台。 Nacos 是构建以“服务”为中心的现代应用架构(例如微服务范式、云原生范式)的服务基础设施。 na
nacos 学习
qq_16242037的博客
03-30 356
nacos介绍 Nacos（Naming Configuration Service） 是一个易于使用的动态服务发现、配置和服务管理平台，用于构建云原生应用程序。Nacos 提供了一组简单易用的特性集，帮助您快速实现动态服务发现、服务配置、服务元数据及流量管理。简单理解nacos = 注册中心+配置中心组合 nacos 安装 nacos 单机模式启动 Linux sh startup.sh -m standalone windows startup.cmd -m standalone nacos 访问
Nacos Docker MySQL 8 版本：Nacos:2.2.3，mysql:8.0.30
06-13
nacos 密码已经修改过了：jzkj@nacos 端口8858/3316 直接启动：docker-compose -f example/...官方已发布新版本中修复上述漏洞，受影响用户请尽快升级到安全版本。 漏洞修复版本： Nacos >= 1.4.6 Nacos >= 2.2.3
nacos:****.yaml does not exist或****.yaml is empty Nacos配置文件读取失败
weixin_46739493的博客
01-11 924
nacos配置文件读取失败
php-nacos:阿里巴巴nacos配置中心-PHP客户端
05-03
特性 容错兜底 容易上手 技术支持，有问题可加作者微信: suxiaolinKing ...Nacos::init( "http://127.0.0.1:8848/", "dev", "LARAVEL", "DEFAULT_GROUP", "" )->runOnce(); 拉取到的配置文件路径：
学习nacos.zip
01-10
转载自https://blog.csdn.net/qq_33619378/article/details/95212754，如有侵权，联系删除。
nacos:nacos学习操练的一个小demo
03-05
3. **健康检查**：Nacos能够自动检测注册的服务实例是否健康，如果发现某个实例不可用，会从服务列表中移除，确保服务消费者调用到的是正常运行的服务。在实践中，我们可以通过Nacos的健康检查机制来监控我们的Java...
nacos学习
qq_41044209的博客
03-07 679
下载与安装 https://github.com/alibaba/nacos/releases Windows安装： 解压、构建nacos需要的数据库和表： 在conf路径下在application.properties文件中进行数据库的配置 执行如下命令即可启动 一、配置中心 1、发布配置 2、Java代码获取配置： 创建maven项目，添加依赖 <dependency> <groupId...
Nacos注册中心原理解析
qq_45003354的博客
01-20 1158
作为注册中心简介和服务注册简流程
Nacos的入门学习
qq_23937767的博客
08-15 575
初学nacos的必经之路
nacos原理学习
最爱奶油花生
05-07 734
一、Nacos的整体架构 Nacos的整体架构还是比较清晰的，我们可以从下面这个官方提供的架构图进行简单分析。 二、Nacos 原理 之前讲过注册中和配置中心的核心原理，信息的同步主要的几种方式： push （服务端主动push） pull （客户端的轮询）， 超时时间比较短 long pull （超时时间比较长） 2.1、配置中心原理 nacos 配置中心就是采用：客户端 long pull 的方式 Nacos 客户端会循环请求服务端变更的数据，并且超时时间设置为30s，当..
Nacos实战学习入门
qq_40864151的博客
09-05 1710
nacos入门，nacos简介，nacos配置中心注册中心，
评论
添加红包

请填写红包祝福语或标题

个

红包个数最小为10个

元

红包金额最低5元

当前余额3.43元 前往充值 >
需支付：10.00元
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包

打赏作者

niaonao

你的鼓励将是我创作的最大动力

¥1 ¥2 ¥4 ¥6 ¥10 ¥20
扫码支付：¥1
获取中
扫码支付

您的余额不足，请更换扫码支付或充值

打赏作者

实付元
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明：

1.余额是钱包充值的虚拟货币，按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载，可以购买VIP、付费专栏及课程。

余额充值