1. 部署概述
本手册面向生产环境,指导完成一套高可用的 Nacos 集群部署:3 个 Nacos 节点组成集群,使用 MySQL 作为统一配置与元数据存储,通过 Nginx 对 3 个节点做反向代理与负载均衡,对外提供统一访问入口。
1.1 架构说明
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 验证数据持久化
- 在控制台新建一个命名空间或配置项。
- 登录 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
文章就写到这里,欢迎大家留言交流,有问题随时讨论。