7个步骤实现Nacos配置中心集群部署：从零开始的高可用配置实战指南

7个步骤实现Nacos配置中心集群部署：从零开始的高可用配置实战指南

【免费下载链接】jeecg-boot项目地址: https://gitcode.com/gh_mirrors/jee/jeecg-boot

在分布式系统架构中，配置中心作为核心组件之一，承担着统一管理配置、实现动态更新的重要职责。Nacos（动态服务发现、配置管理平台）作为JEECG-Boot微服务架构的关键组成部分，其高可用集群部署是保障系统稳定运行的基础。本文将通过7个实战步骤，从理论解析到集群搭建、从配置优化到故障转移，全面指导您完成Nacos配置中心的高可用集群部署，帮助您构建具备故障自动恢复能力的分布式配置管理体系。

1. 集群架构原理解析

1.1 配置中心部署模式对比

Nacos配置中心支持多种部署模式，不同模式适用于不同的业务场景和规模需求：

1.2 Nacos集群核心组件

Nacos集群由以下关键组件构成：

• Nacos Server：核心服务节点，处理配置管理和服务发现请求
• 数据存储：MySQL数据库，持久化配置数据和集群元信息
• 一致性协议：基于Raft协议实现集群数据一致性
• 负载均衡：客户端负载均衡或外部负载均衡器

图：Nacos配置中心集群架构示意图，展示多节点协同工作模式

1.3 网络端口规划指南

Nacos集群部署需要规划以下关键端口：

⚠️注意事项：所有节点间必须保证上述端口的网络互通，建议通过专用网络隔离提高安全性。

2. 环境准备与资源规划

2.1 硬件资源配置方案

根据业务规模需求，Nacos集群可分为以下三种配置方案：

小型集群（100节点以下）

• 服务器数量：3台
• CPU：4核
• 内存：8GB
• 磁盘：100GB SSD

中型集群（100-500节点）

• 服务器数量：3-5台
• CPU：8核
• 内存：16GB
• 磁盘：200GB SSD

大型集群（500节点以上）

• 服务器数量：5-7台
• CPU：16核
• 内存：32GB
• 磁盘：500GB SSD

2.2 软件环境依赖清单

✅推荐配置：生产环境建议使用JDK 11，MySQL 8.0，并启用数据库主从复制。

2.3 集群节点规划表

3. 集群部署实施步骤

3.1 数据库环境搭建

首先创建Nacos集群所需的数据库：

# 登录MySQL数据库 mysql -u root -p # 创建数据库 CREATE DATABASE nacos_cluster CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci; # 授权用户 GRANT ALL PRIVILEGES ON nacos_cluster.* TO 'nacos'@'%' IDENTIFIED BY 'Nacos@123'; FLUSH PRIVILEGES;

初始化数据库表结构，执行项目中的SQL文件：

# 导入Nacos数据库脚本 mysql -u nacos -pNacos@123 nacos_cluster < jeecg-boot/db/tables_nacos.sql

⚠️常见误区：不要使用MySQL的utf8字符集，必须使用utf8mb4以支持完整的Unicode字符。

3.2 项目代码获取

克隆JEECG-Boot项目代码：

git clone https://gitcode.com/gh_mirrors/jee/jeecg-boot cd jeecg-boot

3.3 Docker Compose集群配置

创建或修改Docker Compose配置文件：

# jeecg-boot/jeecg-server-cloud/docker-compose.yml version: '3.8' services: nacos-1: build: ./jeecg-cloud-nacos container_name: nacos-1 ports: - "8848:8848" - "9848:9848" - "9849:9849" environment: - PREFER_HOST_MODE=ip - MODE=cluster - NACOS_SERVERS=192.168.1.101:8848 192.168.1.202:8848 192.168.1.203:8848 - SPRING_DATASOURCE_PLATFORM=mysql - MYSQL_SERVICE_HOST=192.168.1.200 - MYSQL_SERVICE_PORT=3306 - MYSQL_SERVICE_DB_NAME=nacos_cluster - MYSQL_SERVICE_USER=nacos - MYSQL_SERVICE_PASSWORD=Nacos@123 volumes: - ./nacos-1/logs:/home/nacos/logs networks: - jeecg-network nacos-2: build: ./jeecg-cloud-nacos container_name: nacos-2 ports: - "8849:8848" - "9849:9848" - "9850:9849" environment: - PREFER_HOST_MODE=ip - MODE=cluster - NACOS_SERVERS=192.168.1.101:8848 192.168.1.202:8848 192.168.1.203:8848 - SPRING_DATASOURCE_PLATFORM=mysql - MYSQL_SERVICE_HOST=192.168.1.200 - MYSQL_SERVICE_PORT=3306 - MYSQL_SERVICE_DB_NAME=nacos_cluster - MYSQL_SERVICE_USER=nacos - MYSQL_SERVICE_PASSWORD=Nacos@123 volumes: - ./nacos-2/logs:/home/nacos/logs networks: - jeecg-network nacos-3: build: ./jeecg-cloud-nacos container_name: nacos-3 ports: - "8850:8848" - "9850:9848" - "9851:9849" environment: - PREFER_HOST_MODE=ip - MODE=cluster - NACOS_SERVERS=192.168.1.101:8848 192.168.1.202:8848 192.168.1.203:8848 - SPRING_DATASOURCE_PLATFORM=mysql - MYSQL_SERVICE_HOST=192.168.1.200 - MYSQL_SERVICE_PORT=3306 - MYSQL_SERVICE_DB_NAME=nacos_cluster - MYSQL_SERVICE_USER=nacos - MYSQL_SERVICE_PASSWORD=Nacos@123 volumes: - ./nacos-3/logs:/home/nacos/logs networks: - jeecg-network networks: jeecg-network: driver: bridge

3.4 核心配置文件调整

修改Nacos配置文件：

# jeecg-boot/jeecg-server-cloud/jeecg-cloud-nacos/docs/config/jeecg-dev.yaml # 集群配置部分 nacos: server-addr: 192.168.1.101:8848,192.168.1.102:8849,192.168.1.103:8850 config: file-extension: yaml refresh-enabled: true # 启用动态刷新 group: DEFAULT_GROUP discovery: register-enabled: true weight: 10 # 服务权重 # 数据源配置 spring: datasource: dynamic: datasource: master: url: jdbc:mysql://192.168.1.200:3306/jeecg-boot?useUnicode=true&characterEncoding=utf8&autoReconnect=true&zeroDateTimeBehavior=convertToNull username: root password: password driver-class-name: com.mysql.jdbc.Driver

✅推荐值：配置动态刷新间隔建议设置为30秒，既保证配置更新的及时性，又不会过度消耗系统资源。

3.5 集群启动与初始化

启动Nacos集群：

# 进入项目目录 cd jeecg-boot/jeecg-server-cloud # 启动集群 docker-compose up -d # 查看启动状态 docker-compose ps

🔍检查：使用以下命令确认集群是否正常启动：

# 查看每个节点日志 docker-compose logs -f nacos-1 docker-compose logs -f nacos-2 docker-compose logs -f nacos-3

4. 集群功能验证方法

4.1 集群状态检查

访问Nacos控制台检查集群状态：

• 控制台地址：http://192.168.1.101:8848/nacos
• 默认账号：nacos/nacos

在控制台的"集群管理"→"节点列表"中，应该能看到3个节点，其中一个为Leader，其余为Follower。

图：Nacos配置中心集群监控面板，显示节点状态和配置信息

4.2 配置同步测试

创建测试配置并验证同步情况：

1. 在控制台创建配置：

   • Data ID: test-config
   • Group: DEFAULT_GROUP
   • 配置内容: test.key=hello-nacos-cluster

2. 访问其他节点控制台，确认配置已同步：

   • http://192.168.1.102:8849/nacos
   • http://192.168.1.103:8850/nacos

3. 通过API获取配置验证：

# 从不同节点获取配置 curl "http://192.168.1.101:8848/nacos/v1/cs/configs?dataId=test-config&group=DEFAULT_GROUP" curl "http://192.168.1.102:8849/nacos/v1/cs/configs?dataId=test-config&group=DEFAULT_GROUP"

4.3 故障转移测试

验证集群故障自动转移能力：

1. 停止Leader节点：

docker stop nacos-1

2. 观察集群重新选举情况：

docker logs -f nacos-2

3. 确认新Leader产生后，配置服务是否正常：

curl "http://192.168.1.102:8849/nacos/v1/cs/configs?dataId=test-config&group=DEFAULT_GROUP"

⚠️注意事项：故障转移测试应在业务低峰期进行，且确保至少有2个节点正常运行。

5. 集群高级配置与优化

5.1 JVM参数调优

根据服务器配置调整JVM参数：

# 在nacos启动脚本中修改JVM参数 # JVM参数配置示例（8GB内存服务器） JAVA_OPT="${JAVA_OPT} -server -Xms4g -Xmx4g -Xmn2g -XX:MetaspaceSize=128m -XX:MaxMetaspaceSize=320m"

5.2 数据一致性保障策略

Nacos集群通过Raft协议保证数据一致性，关键配置：

# nacos/conf/application.properties # Raft选举超时时间 nacos.core.protocol.raft.data.sync.timeout=3000 # 心跳间隔 nacos.core.protocol.raft.heartbeat.interval=500 # 选举超时时间 nacos.core.protocol.raft.election.timeout=3000

5.3 集群脑裂问题解决

脑裂问题解决方案：

1. 网络隔离检测：

# 开启网络分区检测 nacos.core.protocol.raft.detector.enabled=true # 检测间隔 nacos.core.protocol.raft.detector.interval=5000

2. 最小集群规模：确保集群节点数为奇数（3、5、7），避免平票情况

3. 数据恢复机制：

# 开启数据恢复 nacos.core.data.recovery.enabled=true

6. 同类产品对比分析

6.1 Nacos vs Apollo

6.2 Nacos vs Spring Cloud Config

✅选择建议：微服务架构优先选择Nacos，如需与Git工作流深度集成可考虑Apollo，简单场景可使用Spring Cloud Config。

7. 集群运维与监控

7.1 关键监控指标

7.2 日常维护任务

7.3 常见故障处理

部署决策树

参考资源

• 官方文档：jeecg-boot/jeecg-server-cloud/jeecg-cloud-nacos/README.md
• 配置示例：jeecg-boot/jeecg-server-cloud/jeecg-cloud-nacos/docs/config/
• 集群脚本：jeecg-boot/jeecg-server-cloud/docker-compose.yml

通过以上7个步骤，您已完成Nacos配置中心的高可用集群部署。合理的架构设计、正确的配置优化和完善的监控策略，将为JEECG-Boot微服务系统提供稳定可靠的配置管理能力，确保业务持续稳定运行。

【免费下载链接】jeecg-boot项目地址: https://gitcode.com/gh_mirrors/jee/jeecg-boot