Nacos配置管理實(shí)踐(手把手教你搭建Nacos集群)

更新時(shí)間：2025年08月12日 09:57:24 作者：學(xué)會(huì)歌唱的老周

本文詳解Nacos配置管理在微服務(wù)中的實(shí)現(xiàn),包括通過(guò)bootstrap.yml讀取Nacos配置、配置優(yōu)先級(jí)規(guī)則（本地>服務(wù)名>環(huán)境）、熱更新機(jī)制及集群搭建步驟（數(shù)據(jù)庫(kù)初始化、Nginx反向代理）,強(qiáng)調(diào)多環(huán)境隔離與容災(zāi)部署優(yōu)化

Nacos配置管理

統(tǒng)一配置管理

以上把某些配置放到了nacos中，那微服務(wù)應(yīng)該如何從nacos中獲取配置呢？

去哪讀??？–bootstrap.yml
讀取誰(shuí)？-讀nacos地址

注意：與nacos地址和nacos配置文件有關(guān)的內(nèi)容均放在bootstrap.yml中

操作如下：

1.在服務(wù)（這里選userservice）的pom文件中引入Nacos的配置管理客戶端依賴：

<!--nacos配置管理依賴-->
<dependency>
	<groupId>com.alibaba.cloud</groupId>   
	<artifactId>spring-cloud-starter-alibaba-nacos-config</artifactId>
</dependency>

2.在服務(wù)（這里選userservice）中的resource目錄添加一個(gè)bootstrap.yml文件，這個(gè)文件是引導(dǎo)文件，優(yōu)先級(jí)高于application.yml：

spring:
  application:
    name: userservice
  profiles:
    active: dev #環(huán)境
  cloud:
    nacos:
      server-addr: localhost:8848 #nacos地址
      config:
        file-extension: yaml # 后綴名
        namespace: 995033ad-3d70-485d-9c55-9e60a4815ea9 #命名空間id

添加到bootstrap.yml中(先創(chuàng)建bootstrap.yml)，然后可以將application.yml中與bootstrap.yaml中相同的項(xiàng)刪除

新建一個(gè)接口測(cè)試，看是否能讀取到

@RestController
@RequestMapping("/user")
public class UserController {

    //讀nacos中的配置字段，若dateformat有值，則代表讀去nacos配置成功
    @Value("${pattern.dateformat}")//讀配置文件中的字段，到dateformat
    private String dateformat;

    @GetMapping("now")
    public String now(){
        return LocalDateTime.now().format(DateTimeFormatter.ofPattern(dateformat));
    }
}

訪問(wèn) http://localhost:8081/user/now http://localhost:8082/user/now 結(jié)果如下

表示已經(jīng)讀取到nacos配置，因?yàn)橹挥衝acos中配置了pattern.dateformat 字段，其他沒(méi)有配置

配置熱更新

配置熱更新：配置文件更新后，不用重啟服務(wù)，即可將更新后的配置文件應(yīng)用到服務(wù)上去

@RefreshScope

推薦用方法二

@RestController
@RequestMapping("/user")
//@RefreshScope //nacos配置更新后 自動(dòng)更新到代碼 ////方法一
public class UserController {

    @Autowired
    private UserService userService;

    ////方法一
    //讀nacos中的配置字段，若dateformat有值，則代表讀去nacos配置成功
//    @Value("${pattern.dateformat}")//讀配置文件中的字段，到dateformat
//    private String dateformat;

    @Autowired
    private PatternProperties properties;////方法二

    @GetMapping("now")
    public String now(){
        ////方法一
        return LocalDateTime.now().format(DateTimeFormatter.ofPattern(dateformat));
        ////方法二
        return LocalDateTime.now().format(DateTimeFormatter.ofPattern(properties.getDateformat()));
    }

 
}

////方法二 在config包下新建這樣一個(gè)類，將其注入spring容器中
@Data
@Component //把PatternProperties類注冊(cè)成spring的一個(gè)bean，這樣就可以被任意使用
@ConfigurationProperties(prefix = "pattern") //指定配置文件中以"pattern"開(kāi)頭的屬性
public class PatternProperties {
    private String dateformat;
}

小結(jié)

多環(huán)境配置共享

微服務(wù)配置共享

dev和test環(huán)境都能拿到nacos中userservice.yaml中的值，而test環(huán)境拿不到dev環(huán)境的特有的值,當(dāng)然dev也拿不到test的值（但這里test里面沒(méi)設(shè)置）

問(wèn)題一：nacos中userservice.yaml 與 userservice-dev.yaml中假如有相同的配置項(xiàng)，則以哪個(gè)為準(zhǔn)呢？（哪個(gè)優(yōu)先級(jí)高）

問(wèn)題二：本地，nacos遠(yuǎn)程都有相同的配置，以哪個(gè)為準(zhǔn)呢？

用案例回答上述答案，配上一個(gè)相同的案例

在本地yaml中加入配置 pattern.name = 本地環(huán)境local，并把name放入配置類中

重啟服務(wù)，顯示本地環(huán)境local，因?yàn)榇藭r(shí)只有本地有這個(gè)配置

接下來(lái)我們?cè)谶h(yuǎn)程端加入該配置

在userservice.yaml加入該配置項(xiàng)

刷新網(wǎng)頁(yè)（無(wú)需重啟服務(wù)），顯示的是userservice.yaml中的配置，而不顯示本地的配置

再在userservice-dev.yaml寫(xiě)入配置

刷新網(wǎng)頁(yè)（無(wú)需重啟服務(wù)），顯示的是userservice-dev.yaml中的配置，而不顯示本地的配置，也不顯示userservice.yaml中的配置

總結(jié)

配置優(yōu)先級(jí)：服務(wù)名-profile.yaml(userservice-dev.yaml) > 服務(wù)名.yaml(userservice.yaml) > 本地配置

小結(jié)

搭建Nacos集群

1.集群結(jié)構(gòu)圖

官方給出的Nacos集群圖：

SLB：負(fù)載均衡器

其中包含3個(gè)nacos節(jié)點(diǎn)，然后一個(gè)負(fù)載均衡器代理3個(gè)Nacos。這里負(fù)載均衡器可以使用nginx。

我們計(jì)劃的集群結(jié)構(gòu)：

三個(gè)nacos節(jié)點(diǎn)的地址：

節(jié)點(diǎn)	ip	port
nacos1	10.0.4.94	8845
nacos2	10.0.4.94	8846
nacos3	10.0.4.94	8847

2.搭建集群

搭建集群的基本步驟：

搭建數(shù)據(jù)庫(kù)，初始化數(shù)據(jù)庫(kù)表結(jié)構(gòu) （nacos官方提供）
下載nacos安裝包
配置nacos
啟動(dòng)nacos集群
nginx反向代理

2.1.初始化數(shù)據(jù)庫(kù)

Nacos默認(rèn)數(shù)據(jù)存儲(chǔ)在內(nèi)嵌數(shù)據(jù)庫(kù)Derby中，不屬于生產(chǎn)可用的數(shù)據(jù)庫(kù)。

官方推薦的最佳實(shí)踐是使用帶有主從的高可用數(shù)據(jù)庫(kù)集群，主從模式的高可用數(shù)據(jù)庫(kù)可以參考傳智教育的后續(xù)高手課程。

這里我們以單點(diǎn)的數(shù)據(jù)庫(kù)為例來(lái)講解。

首先新建一個(gè)數(shù)據(jù)庫(kù)，命名為nacos，而后導(dǎo)入下面的SQL：

CREATE TABLE `config_info` (
  `id` bigint(20) NOT NULL AUTO_INCREMENT COMMENT 'id',
  `data_id` varchar(255) NOT NULL COMMENT 'data_id',
  `group_id` varchar(255) DEFAULT NULL,
  `content` longtext NOT NULL COMMENT 'content',
  `md5` varchar(32) DEFAULT NULL COMMENT 'md5',
  `gmt_create` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '創(chuàng)建時(shí)間',
  `gmt_modified` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '修改時(shí)間',
  `src_user` text COMMENT 'source user',
  `src_ip` varchar(50) DEFAULT NULL COMMENT 'source ip',
  `app_name` varchar(128) DEFAULT NULL,
  `tenant_id` varchar(128) DEFAULT '' COMMENT '租戶字段',
  `c_desc` varchar(256) DEFAULT NULL,
  `c_use` varchar(64) DEFAULT NULL,
  `effect` varchar(64) DEFAULT NULL,
  `type` varchar(64) DEFAULT NULL,
  `c_schema` text,
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_configinfo_datagrouptenant` (`data_id`,`group_id`,`tenant_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8 COLLATE=utf8_bin COMMENT='config_info';

/******************************************/
/*   數(shù)據(jù)庫(kù)全名 = nacos_config   */
/*   表名稱 = config_info_aggr   */
/******************************************/
CREATE TABLE `config_info_aggr` (
  `id` bigint(20) NOT NULL AUTO_INCREMENT COMMENT 'id',
  `data_id` varchar(255) NOT NULL COMMENT 'data_id',
  `group_id` varchar(255) NOT NULL COMMENT 'group_id',
  `datum_id` varchar(255) NOT NULL COMMENT 'datum_id',
  `content` longtext NOT NULL COMMENT '內(nèi)容',
  `gmt_modified` datetime NOT NULL COMMENT '修改時(shí)間',
  `app_name` varchar(128) DEFAULT NULL,
  `tenant_id` varchar(128) DEFAULT '' COMMENT '租戶字段',
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_configinfoaggr_datagrouptenantdatum` (`data_id`,`group_id`,`tenant_id`,`datum_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8 COLLATE=utf8_bin COMMENT='增加租戶字段';


/******************************************/
/*   數(shù)據(jù)庫(kù)全名 = nacos_config   */
/*   表名稱 = config_info_beta   */
/******************************************/
CREATE TABLE `config_info_beta` (
  `id` bigint(20) NOT NULL AUTO_INCREMENT COMMENT 'id',
  `data_id` varchar(255) NOT NULL COMMENT 'data_id',
  `group_id` varchar(128) NOT NULL COMMENT 'group_id',
  `app_name` varchar(128) DEFAULT NULL COMMENT 'app_name',
  `content` longtext NOT NULL COMMENT 'content',
  `beta_ips` varchar(1024) DEFAULT NULL COMMENT 'betaIps',
  `md5` varchar(32) DEFAULT NULL COMMENT 'md5',
  `gmt_create` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '創(chuàng)建時(shí)間',
  `gmt_modified` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '修改時(shí)間',
  `src_user` text COMMENT 'source user',
  `src_ip` varchar(50) DEFAULT NULL COMMENT 'source ip',
  `tenant_id` varchar(128) DEFAULT '' COMMENT '租戶字段',
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_configinfobeta_datagrouptenant` (`data_id`,`group_id`,`tenant_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8 COLLATE=utf8_bin COMMENT='config_info_beta';

/******************************************/
/*   數(shù)據(jù)庫(kù)全名 = nacos_config   */
/*   表名稱 = config_info_tag   */
/******************************************/
CREATE TABLE `config_info_tag` (
  `id` bigint(20) NOT NULL AUTO_INCREMENT COMMENT 'id',
  `data_id` varchar(255) NOT NULL COMMENT 'data_id',
  `group_id` varchar(128) NOT NULL COMMENT 'group_id',
  `tenant_id` varchar(128) DEFAULT '' COMMENT 'tenant_id',
  `tag_id` varchar(128) NOT NULL COMMENT 'tag_id',
  `app_name` varchar(128) DEFAULT NULL COMMENT 'app_name',
  `content` longtext NOT NULL COMMENT 'content',
  `md5` varchar(32) DEFAULT NULL COMMENT 'md5',
  `gmt_create` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '創(chuàng)建時(shí)間',
  `gmt_modified` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '修改時(shí)間',
  `src_user` text COMMENT 'source user',
  `src_ip` varchar(50) DEFAULT NULL COMMENT 'source ip',
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_configinfotag_datagrouptenanttag` (`data_id`,`group_id`,`tenant_id`,`tag_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8 COLLATE=utf8_bin COMMENT='config_info_tag';

/******************************************/
/*   數(shù)據(jù)庫(kù)全名 = nacos_config   */
/*   表名稱 = config_tags_relation   */
/******************************************/
CREATE TABLE `config_tags_relation` (
  `id` bigint(20) NOT NULL COMMENT 'id',
  `tag_name` varchar(128) NOT NULL COMMENT 'tag_name',
  `tag_type` varchar(64) DEFAULT NULL COMMENT 'tag_type',
  `data_id` varchar(255) NOT NULL COMMENT 'data_id',
  `group_id` varchar(128) NOT NULL COMMENT 'group_id',
  `tenant_id` varchar(128) DEFAULT '' COMMENT 'tenant_id',
  `nid` bigint(20) NOT NULL AUTO_INCREMENT,
  PRIMARY KEY (`nid`),
  UNIQUE KEY `uk_configtagrelation_configidtag` (`id`,`tag_name`,`tag_type`),
  KEY `idx_tenant_id` (`tenant_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8 COLLATE=utf8_bin COMMENT='config_tag_relation';

/******************************************/
/*   數(shù)據(jù)庫(kù)全名 = nacos_config   */
/*   表名稱 = group_capacity   */
/******************************************/
CREATE TABLE `group_capacity` (
  `id` bigint(20) unsigned NOT NULL AUTO_INCREMENT COMMENT '主鍵ID',
  `group_id` varchar(128) NOT NULL DEFAULT '' COMMENT 'Group ID，空字符表示整個(gè)集群',
  `quota` int(10) unsigned NOT NULL DEFAULT '0' COMMENT '配額，0表示使用默認(rèn)值',
  `usage` int(10) unsigned NOT NULL DEFAULT '0' COMMENT '使用量',
  `max_size` int(10) unsigned NOT NULL DEFAULT '0' COMMENT '單個(gè)配置大小上限，單位為字節(jié)，0表示使用默認(rèn)值',
  `max_aggr_count` int(10) unsigned NOT NULL DEFAULT '0' COMMENT '聚合子配置最大個(gè)數(shù)，，0表示使用默認(rèn)值',
  `max_aggr_size` int(10) unsigned NOT NULL DEFAULT '0' COMMENT '單個(gè)聚合數(shù)據(jù)的子配置大小上限，單位為字節(jié)，0表示使用默認(rèn)值',
  `max_history_count` int(10) unsigned NOT NULL DEFAULT '0' COMMENT '最大變更歷史數(shù)量',
  `gmt_create` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '創(chuàng)建時(shí)間',
  `gmt_modified` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '修改時(shí)間',
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_group_id` (`group_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8 COLLATE=utf8_bin COMMENT='集群、各Group容量信息表';

/******************************************/
/*   數(shù)據(jù)庫(kù)全名 = nacos_config   */
/*   表名稱 = his_config_info   */
/******************************************/
CREATE TABLE `his_config_info` (
  `id` bigint(64) unsigned NOT NULL,
  `nid` bigint(20) unsigned NOT NULL AUTO_INCREMENT,
  `data_id` varchar(255) NOT NULL,
  `group_id` varchar(128) NOT NULL,
  `app_name` varchar(128) DEFAULT NULL COMMENT 'app_name',
  `content` longtext NOT NULL,
  `md5` varchar(32) DEFAULT NULL,
  `gmt_create` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP,
  `gmt_modified` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP,
  `src_user` text,
  `src_ip` varchar(50) DEFAULT NULL,
  `op_type` char(10) DEFAULT NULL,
  `tenant_id` varchar(128) DEFAULT '' COMMENT '租戶字段',
  PRIMARY KEY (`nid`),
  KEY `idx_gmt_create` (`gmt_create`),
  KEY `idx_gmt_modified` (`gmt_modified`),
  KEY `idx_did` (`data_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8 COLLATE=utf8_bin COMMENT='多租戶改造';


/******************************************/
/*   數(shù)據(jù)庫(kù)全名 = nacos_config   */
/*   表名稱 = tenant_capacity   */
/******************************************/
CREATE TABLE `tenant_capacity` (
  `id` bigint(20) unsigned NOT NULL AUTO_INCREMENT COMMENT '主鍵ID',
  `tenant_id` varchar(128) NOT NULL DEFAULT '' COMMENT 'Tenant ID',
  `quota` int(10) unsigned NOT NULL DEFAULT '0' COMMENT '配額，0表示使用默認(rèn)值',
  `usage` int(10) unsigned NOT NULL DEFAULT '0' COMMENT '使用量',
  `max_size` int(10) unsigned NOT NULL DEFAULT '0' COMMENT '單個(gè)配置大小上限，單位為字節(jié)，0表示使用默認(rèn)值',
  `max_aggr_count` int(10) unsigned NOT NULL DEFAULT '0' COMMENT '聚合子配置最大個(gè)數(shù)',
  `max_aggr_size` int(10) unsigned NOT NULL DEFAULT '0' COMMENT '單個(gè)聚合數(shù)據(jù)的子配置大小上限，單位為字節(jié)，0表示使用默認(rèn)值',
  `max_history_count` int(10) unsigned NOT NULL DEFAULT '0' COMMENT '最大變更歷史數(shù)量',
  `gmt_create` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '創(chuàng)建時(shí)間',
  `gmt_modified` datetime NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '修改時(shí)間',
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_tenant_id` (`tenant_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8 COLLATE=utf8_bin COMMENT='租戶容量信息表';


CREATE TABLE `tenant_info` (
  `id` bigint(20) NOT NULL AUTO_INCREMENT COMMENT 'id',
  `kp` varchar(128) NOT NULL COMMENT 'kp',
  `tenant_id` varchar(128) default '' COMMENT 'tenant_id',
  `tenant_name` varchar(128) default '' COMMENT 'tenant_name',
  `tenant_desc` varchar(256) DEFAULT NULL COMMENT 'tenant_desc',
  `create_source` varchar(32) DEFAULT NULL COMMENT 'create_source',
  `gmt_create` bigint(20) NOT NULL COMMENT '創(chuàng)建時(shí)間',
  `gmt_modified` bigint(20) NOT NULL COMMENT '修改時(shí)間',
  PRIMARY KEY (`id`),
  UNIQUE KEY `uk_tenant_info_kptenantid` (`kp`,`tenant_id`),
  KEY `idx_tenant_id` (`tenant_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8 COLLATE=utf8_bin COMMENT='tenant_info';

CREATE TABLE `users` (
	`username` varchar(50) NOT NULL PRIMARY KEY,
	`password` varchar(500) NOT NULL,
	`enabled` boolean NOT NULL
);

CREATE TABLE `roles` (
	`username` varchar(50) NOT NULL,
	`role` varchar(50) NOT NULL,
	UNIQUE INDEX `idx_user_role` (`username` ASC, `role` ASC) USING BTREE
);

CREATE TABLE `permissions` (
    `role` varchar(50) NOT NULL,
    `resource` varchar(255) NOT NULL,
    `action` varchar(8) NOT NULL,
    UNIQUE INDEX `uk_role_permission` (`role`,`resource`,`action`) USING BTREE
);

INSERT INTO users (username, password, enabled) VALUES ('nacos', '$2a$10$EuWPZHzz32dJN7jexM34MOeYirDdFAZm2kuWj7VEOJhhZkDrxfvUu', TRUE);

INSERT INTO roles (username, role) VALUES ('nacos', 'ROLE_ADMIN');

2.2.下載nacos

nacos在GitHub上有下載地址：https://github.com/alibaba/nacos/tags，可以選擇任意版本下載。

本例中才用1.4.1版本：

2.3.配置Nacos

將這個(gè)包解壓到任意非中文目錄下，如圖：

目錄說(shuō)明：

bin：?jiǎn)?dòng)腳本
conf：配置文件

進(jìn)入nacos的conf目錄，修改配置文件cluster.conf.example，重命名為cluster.conf：

然后添加內(nèi)容：

127.0.0.1:8845
127.0.0.1.8846
127.0.0.1.8847

然后修改application.properties文件，添加數(shù)據(jù)庫(kù)配置

spring.datasource.platform=mysql

db.num=1

db.url.0=jdbc:mysql://127.0.0.1:3306/nacos?characterEncoding=utf8&connectTimeout=1000&socketTimeout=3000&autoReconnect=true&useUnicode=true&useSSL=false&serverTimezone=UTC
db.user.0=root
db.password.0=123456

2.4.啟動(dòng)

將nacos文件夾復(fù)制三份，分別命名為：nacos1、nacos2、nacos3

然后分別修改三個(gè)文件夾中的application.properties，

nacos1:

server.port=8845

nacos2:

server.port=8846

nacos3:

server.port=8847

然后分別啟動(dòng)三個(gè)nacos節(jié)點(diǎn)：直接啟動(dòng)在終端輸入startup.cmd(因?yàn)閚acos默認(rèn)啟動(dòng)就是集群?jiǎn)?dòng)) 不需要startup.cmd -m standalone

startup.cmd

2.5.nginx反向代理

找到課前資料提供的nginx安裝包：

解壓到任意非中文目錄下：

修改conf/nginx.conf文件，配置如下：

upstream nacos-cluster {
    server 127.0.0.1:8845;
	server 127.0.0.1:8846;
	server 127.0.0.1:8847;
}

server {
    listen       80;
    server_name  localhost;

    location /nacos {
        proxy_pass http://nacos-cluster;
    }
}

而后在瀏覽器訪問(wèn)：http://localhost/nacos即可。

代碼中application.yml文件配置如下：

spring:
  cloud:
    nacos:
      server-addr: localhost:80 # Nacos地址

重啟服務(wù)，進(jìn)入nacos頁(yè)面 http://localhost/nacos

2.6.優(yōu)化

實(shí)際部署時(shí)，需要給做反向代理的nginx服務(wù)器設(shè)置一個(gè)域名，這樣后續(xù)如果有服務(wù)器遷移nacos的客戶端也無(wú)需更改配置.
Nacos的各個(gè)節(jié)點(diǎn)應(yīng)該部署到多個(gè)不同服務(wù)器，做好容災(zāi)和隔離