Nacos 三节点集群部署手册:MySQL 持久化 + Nginx 负载均衡

1. 部署概述

本手册面向生产环境,指导完成一套高可用的 Nacos 集群部署:3 个 Nacos 节点组成集群,使用 MySQL 作为统一配置与元数据存储,通过 Nginx 对 3 个节点做反向代理与负载均衡,对外提供统一访问入口。

1.1 架构说明

flowchart TD C[客户端 / 微服务] --> N[Nginx 反向代理 :8848] N --> A[Nacos 节点1 :8848] N --> B[Nacos 节点2 :8848] N --> D[Nacos 节点3 :8848] A --> M[(MySQL 主库)] B --> M D --> M

1.2 节点规划

角色 主机名 IP 端口 说明
Nginx nginx-01 192.168.10.10 8848 统一入口,负载均衡
Nacos nacos-01 192.168.10.11 8848 集群节点 1
Nacos nacos-02 192.168.10.12 8848 集群节点 2
Nacos nacos-03 192.168.10.13 8848 集群节点 3
MySQL mysql-01 192.168.10.20 3306 数据持久化

说明:Nacos 集群节点数建议为奇数(3 或 5),本手册以 3 节点为例。所有节点需保证时间同步(NTP),否则可能出现集群选举异常。

1.3 版本与前置条件

  • 操作系统:CentOS 7.9 / Ubuntu 20.04 及以上
  • JDK:1.8 及以上(推荐 JDK 8 或 JDK 11)
  • Nacos:2.2.x(本手册以 2.2.3 为例)
  • MySQL:5.7 或 8.0
  • Nginx:1.20 及以上
  • 各节点已关闭防火墙或放通 8848、9848、9849、7848 端口

2. 环境准备

2.1 关闭防火墙与 SELinux

bash 复制代码
# 关闭 firewalld
systemctl stop firewalld
systemctl disable firewalld
关闭 SELinux(临时 + 永久)
setenforce 0
sed -i 's/^SELINUX=.*/SELINUX=disabled/' /etc/selinux/config

2.2 时间同步

bash 复制代码
yum install -y ntpdate
ntpdate ntp.aliyun.com
# 建议配置 crontab 定时同步
echo "*/5 * * * * /usr/sbin/ntpdate ntp.aliyun.com >/dev/null 2>&1" >> /var/spool/cron/root

2.3 安装 JDK

bash 复制代码
yum install -y java-1.8.0-openjdk java-1.8.0-openjdk-devel
java -version

2.4 主机名与 hosts 配置(三台 Nacos 节点均执行)

bash 复制代码
hostnamectl set-hostname nacos-01   # 各节点分别设置为 nacos-01/02/03
cat >> /etc/hosts <<EOF
192.168.10.11 nacos-01
192.168.10.12 nacos-02
192.168.10.13 nacos-03
EOF

3. MySQL 安装与初始化

3.1 安装 MySQL 8.0

bash 复制代码
# 添加 MySQL 官方源
rpm -Uvh https://dev.mysql.com/get/mysql80-community-release-el7-7.noarch.rpm
yum install -y mysql-community-server
systemctl start mysqld
systemctl enable mysqld
获取初始密码
grep 'temporary password' /var/log/mysqld.log

3.2 修改 root 密码并创建 Nacos 库

sql 复制代码
ALTER USER 'root'@'localhost' IDENTIFIED BY 'Root@123456';
CREATE DATABASE nacos_config DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
CREATE USER 'nacos'@'%' IDENTIFIED BY 'Nacos@123456';
GRANT ALL PRIVILEGES ON nacos_config.* TO 'nacos'@'%';
FLUSH PRIVILEGES;

3.3 导入 Nacos 初始化脚本

从 Nacos 安装包的 conf/mysql-schema.sql 导入表结构:

bash 复制代码
mysql -unacos -pNacos@123456 -h192.168.10.20 nacos_config < mysql-schema.sql
验证表是否创建成功
mysql -unacos -pNacos@123456 -h192.168.10.20 -e "use nacos_config; show tables;"

正常情况下应看到 config_info、config_info_beta、config_info_tag、config_tags_relation、group_capacity、his_config_info、permissions、roles、tenant_capacity、tenant_info、users 等表。

4. Nacos 集群部署

4.1 下载并解压 Nacos

在三台 Nacos 节点上分别执行:

bash 复制代码
cd /opt
wget https://github.com/alibaba/nacos/releases/download/2.2.3/nacos-server-2.2.3.tar.gz
tar -zxvf nacos-server-2.2.3.tar.gz
mv nacos /usr/local/nacos

4.2 配置 MySQL 数据源

编辑 /usr/local/nacos/conf/application.properties,修改以下内容:

properties 复制代码
# 数据源类型
spring.datasource.platform=mysql
数据库实例数量
db.num=1
数据库连接信息
db.url.0=jdbc:mysql://192.168.10.20:3306/nacos_config?characterEncoding=utf8&connectTimeout=1000&socketTimeout=3000&autoReconnect=true&useUnicode=true&useSSL=false&serverTimezone=Asia/Shanghai
db.user.0=nacos
db.password.0=Nacos@123456
连接池配置
db.pool.config.connectionTimeout=30000
db.pool.config.validationTimeout=10000
db.pool.config.maximumPoolSize=20
db.pool.config.minimumIdle=2

4.3 配置集群节点列表

复制集群配置模板并填写三台节点信息:

bash 复制代码
cd /usr/local/nacos/conf
cp cluster.conf.example cluster.conf
cat > cluster.conf <<EOF
192.168.10.11:8848
192.168.10.12:8848
192.168.10.13:8848
EOF

注意:cluster.conf 中不要写 127.0.0.1,必须写各节点的真实内网 IP,否则集群无法正常组建。

4.4 配置 JVM 参数

编辑 /usr/local/nacos/bin/startup.sh,根据服务器内存调整堆大小(建议生产环境至少 2G):

bash 复制代码
# 找到 JAVA_OPT 配置行,修改为:
JAVA_OPT="${JAVA_OPT} -server -Xms2g -Xmx2g -Xmn1g -XX:MetaspaceSize=128m -XX:MaxMetaspaceSize=320m"

4.5 启动集群

三台节点依次以集群模式启动:

bash 复制代码
cd /usr/local/nacos/bin
sh startup.sh -m cluster
查看启动日志
tail -f /usr/local/nacos/logs/start.out

当日志中出现 Nacos started successfully in cluster mode 时表示启动成功。

4.6 验证集群状态

bash 复制代码
# 查看集群节点列表
curl "http://192.168.10.11:8848/nacos/v1/ns/operator/servers?accessToken="
查看集群健康状态
curl "http://192.168.10.11:8848/nacos/v1/ns/operator/metrics"

返回结果中 servers 数组应包含 3 个节点,且 state 均为 UP。

5. Nginx 反向代理配置

5.1 安装 Nginx

bash 复制代码
yum install -y epel-release
yum install -y nginx
systemctl start nginx
systemctl enable nginx

5.2 配置负载均衡

编辑 /etc/nginx/conf.d/nacos.conf:

nginx 复制代码
upstream nacos_cluster {
    # 负载均衡策略:轮询(默认),也可使用 ip_hash 保持会话
    server 192.168.10.11:8848 max_fails=2 fail_timeout=10s;
    server 192.168.10.12:8848 max_fails=2 fail_timeout=10s;
    server 192.168.10.13:8848 max_fails=2 fail_timeout=10s;
    keepalive 32;
}
server {
listen       8848;
server_name  nacos.example.com;
# 控制台与 OpenAPI 代理
location / {
    proxy_pass         http://nacos_cluster;
    proxy_http_version 1.1;
    proxy_set_header   Host              $host;
    proxy_set_header   X-Real-IP         $remote_addr;
    proxy_set_header   X-Forwarded-For   $proxy_add_x_forwarded_for;
    proxy_set_header   X-Forwarded-Proto $scheme;
    proxy_set_header   Connection        "";
    proxy_connect_timeout 10s;
    proxy_read_timeout    60s;
    proxy_send_timeout    60s;
}
}

5.3 校验并重载配置

bash 复制代码
nginx -t
systemctl reload nginx

5.4 验证代理效果

bash 复制代码
# 通过 Nginx 访问 Nacos 健康检查
curl -I http://192.168.10.10:8848/nacos/
多次请求观察是否轮询到不同节点
for i in {1..6}; do curl -s http://192.168.10.10:8848/nacos/v1/ns/operator/servers | head -c 200; echo; done

6. 控制台访问与验证

6.1 登录控制台

浏览器访问 http://192.168.10.10:8848/nacos,默认账号密码为 nacos/nacos,首次登录后请立即修改密码。

6.2 验证数据持久化

  1. 在控制台新建一个命名空间或配置项。
  2. 登录 MySQL 查询 nacos_config 库:
sql 复制代码
SELECT data_id, group_id, tenant_id, content FROM config_info;

若能看到刚创建的配置,说明 MySQL 持久化生效。

6.3 验证集群高可用

bash 复制代码
# 停止其中一个 Nacos 节点
sh /usr/local/nacos/bin/shutdown.sh
通过 Nginx 继续访问,服务应不受影响
curl http://192.168.10.10:8848/nacos/v1/ns/operator/servers

确认剩余两个节点仍可正常提供服务,且 Nginx 自动摘除故障节点。

7. 常见问题排查

问题现象 可能原因 解决方案
节点启动后集群列表只有一个 cluster.conf 配置错误或含 127.0.0.1 检查 cluster.conf,确保为真实内网 IP
启动报数据库连接失败 数据源配置错误或 MySQL 未授权 检查 application.properties 与 MySQL 用户权限
控制台 403 或无法登录 Nginx 未透传 Host 头 补充 proxy_set_header Host $host
集群频繁选举 节点间时间不同步 配置 NTP 时间同步
9848 端口连接失败 gRPC 端口未放通 放通 9848、9849 端口

8. 生产环境建议

  • MySQL 高可用:生产环境建议 MySQL 采用主从或 MGR 架构,避免单点故障。
  • Nginx 高可用:Nginx 前置可再叠加 Keepalived + VIP,避免代理层单点。
  • 端口放通:Nacos 2.x 除 8848 外,还需放通 9848(gRPC 客户端)、9849(gRPC 服务端)、7848(集群通信)。
  • JVM 调优:根据实际配置调整堆内存,避免频繁 Full GC。
  • 日志管理:配置日志轮转,避免日志文件占满磁盘。
  • 安全加固 :开启 Nacos 鉴权(nacos.core.auth.enabled=true),并修改默认 token 密钥。

9.最佳实践

https://download.csdn.net/download/lgz847368331/93848460

文章就写到这里,欢迎大家留言交流,有问题随时讨论。

相关推荐
Umi·19 分钟前
MySQL之多表关联查询练习
数据库·mysql
实泽有之,无泽虚之31 分钟前
Windows环境bat脚本自动备份MySQL数据库并清理旧备份文件
数据库·mysql
csdn_aspnet35 分钟前
【Docker 攻略】MySQL 安裝篇
运维·mysql·docker·容器
FungLeo1 小时前
FengCMS · PHP+MySQL 升级实录· 代码审计怎么闭环:REVIEW到 CLOSURE 四件套,12 个域90 篇修复文档跟到底
开发语言·mysql·php·代码审计·fengcms
索西引擎1 小时前
MySQL 进阶:锁机制
数据库·mysql
FungLeo2 小时前
FengCMS · PHP+MySQL 升级实录 · 一个不懂PHP 的后端,三天 216次提交完成十三年老站安全升级(项目复盘)
mysql·安全·php·安全加固·fengcms
星恒随风3 小时前
MySQL 从零入门(七):索引原理与 B+ 树详解——从磁盘 I/O 到 InnoDB 聚簇索引
linux·服务器·数据库·笔记·mysql
新*4 小时前
520 万数据迁移实战:Elasticsearch 索引重建与"改名"的完整踩坑记录
python·mysql·elasticsearch·数据迁移
csdn_aspnet14 小时前
Docker MySql 5.7、MySql8.x 进阶配置
mysql·docker·容器