微服务Nacos组件的介绍、安装、使用

news2025/4/24 20:24:45

微服务Nacos组件的介绍、安装、使用

在微服务架构日渐普及的今天，服务注册与配置管理成了系统架构中的关键环节。阿里巴巴开源的 Nacos（Naming and Configuration Service）正是解决这一问题的利器。本文将为你全面介绍 Nacos 的概念、安装方式、集成 Spring Boot 的实战用法及常见问题，助你快速上手并应用到实际项目中。

一、Nacos 是什么？

Nacos 是一个更易于构建云原生应用的服务发现、配置管理和服务治理平台。它提供了类似于 Netflix Eureka + Spring Cloud Config 的能力，并且集成了一整套健康检查、动态配置和服务管理能力。

核心能力概览：

服务注册与发现：支持动态注册与发现服务实例，支持 DNS、REST、gRPC 协议。
配置中心：集中化配置管理，支持配置热更新和版本控制。
服务健康检查：通过心跳机制实现服务自动摘除和健康状态监控。
多环境/命名空间支持：方便在开发、测试、生产环境之间做隔离。
权限控制与审计：基于角色的访问控制（RBAC），记录配置变更历史。

二、Nacos 的安装

1. 环境准备

JDK 8 或以上
Maven（如需构建源码）
MySQL（用于生产环境持久化配置和注册信息）
Docker（推荐使用 Docker 启动测试环境）

2. 下载与启动

Docker拉取nacos镜像

docker pull nacos/nacos-server:v2.3.0

Docker查看nacos镜像

docker images

在这里插入图片描述

Docker 启动（推荐）

docker run -d --name nacos-server \
  -p 8848:8848 \
  -p 9848:9848 \
  -e MODE=standalone \
  --restart=always \
  nacos/nacos-server:v2.3.0

在这里插入图片描述

默认访问地址：http://你自己的ip:8848/nacos
默认用户名/密码：nacos / nacos

在这里插入图片描述

三、Nacos 与 Spring Boot 的集成使用

1. 服务注册与发现

依赖引入

<dependency>
  <groupId>com.alibaba.cloud</groupId>
  <artifactId>spring-cloud-starter-alibaba-nacos-discovery</artifactId>
</dependency>

2. 配置中心集成

添加依赖

<dependency>
  <groupId>com.alibaba.cloud</groupId>
  <artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
</dependency>

application.yml 配置

spring:
  application:
    name: learn-server
  config:
    import: nacos:${spring.application.name}.yaml
  cloud:
    nacos:
      discovery:
        server-addr: 你自己的IP:8848 # Nacos 注册中心的地址
        namespace: learn-server-namespace-id  # 如果使用自定义命名空间，可以配置此项
      config:
        server-addr: 你自己的IP:8848 # Nacos 配置中心的地址
        file-extension: yaml # 配置文件的格式，yaml 或 properties
        refreshable: true  # 是否支持动态刷新配置
        shared-configs: # 可选的共享配置文件
#          - dataid: db_shared.yaml
            group: DEFAULT_GROUP
            refresh: true
        namespace: public

服务启动后会自动注册到 Nacos 控制台

在这里插入图片描述

其他服务可通过服务名访问，如：

@LoadBalanced
@Bean
RestTemplate restTemplate() {
    return new RestTemplate();
}

restTemplate.getForObject("http://learn-server/hello", String.class);

控制台中添加配置

Data ID：learn-server.yaml
Group：DEFAULT_GROUP
配置内容：

demo:
  name: nacos-config

在这里插入图片描述

Controller 中读取配置

@RefreshScope
@RestController
public class ConfigController {
  @Value("${demo.name}")
  private String name;

  @GetMapping("/config")
  public String getName() {
    return name;
  }
}