服务注册与分布式协调 / 系统课时
搭建多节点 Nacos 集群
搭建多节点 Nacos 集群
多节点部署的关键不是把 Nacos 启动三遍,而是让所有节点拥有一致的成员列表、可达的内部网络和同一套持久化配置。完成本课后,你将得到一个可验证成员状态、可做单节点故障演练的三节点 Nacos 集群。
学习目标
- 配置三个及以上 Nacos Server 节点并统一成员与数据源
- 使用健康检查与集群 API 验证节点状态
- 通过停止单节点观察多数派与客户端入口的切换行为
先确定集群边界
下面以三台 Linux 主机为例:10.10.0.11、10.10.0.12、10.10.0.13,Nacos 主端口均为 8848。三个节点应使用稳定、彼此可达的地址,并保持系统时间基本同步;生产环境优先使用外部 MySQL 作为共享数据源。发行包集群模式要求 cluster.conf 每行写一个 ip:port,并配置至少三个节点。([Nacos 官网][1])

配置成员与共享数据源
在三台机器的 <NACOS_HOME>/conf/cluster.conf 写入完全相同的成员列表。这里的地址必须是其他 Nacos 节点实际能够访问到的地址,不要填 127.0.0.1,也不要填只在某个容器内部有效的临时地址。
10.10.0.11:8848
10.10.0.12:8848
10.10.0.13:8848三个节点还应指向同一个已初始化的 Nacos 数据库。下面是 application.properties 的核心片段示例;它依赖你已经创建数据库并执行当前 Nacos 发行包自带的 MySQL 初始化脚本。
spring.sql.init.platform=mysql
db.num=1
db.url.0=jdbc:mysql://<MYSQL_HOST>:3306/nacos?characterEncoding=utf8&connectTimeout=1000&socketTimeout=3000&autoReconnect=true&useUnicode=true&useSSL=false&serverTimezone=UTC
db.user.0=<DB_USER>
db.password.0=<DB_PASSWORD>三台节点的数据库地址、库名和集群级安全配置必须保持一致。若启用了默认鉴权,还要保证用于签发和校验令牌的集群密钥在各节点一致,否则请求可能在负载均衡切换后突然鉴权失败。([Nacos 官网][2])
启动并验证成员状态
在每个节点执行同一组启动与就绪检查命令。下面命令会启动集群模式,并最多等待约 60 秒,直到当前节点的 readiness API 返回 ok;<NACOS_HOME> 替换为实际安装目录。
cd <NACOS_HOME>/bin
# 启动 cluster 模式,启动日志仍写入 Nacos 日志目录
sh startup.sh -m cluster >/dev/null
# 轮询 readiness,避免服务仍在初始化时立即判失败
for i in $(seq 1 30); do
if curl -fsS 'http://127.0.0.1:8848/nacos/v3/admin/core/state/readiness' | grep -q '"data":"ok"'; then
echo ready
exit 0
fi
sleep 2
done
echo not-ready
exit 1预期输出
readyNacos 3.x 提供 readiness API,也提供需要管理员权限的集群节点列表 API。三个节点都就绪后,可先通过默认鉴权或企业 IdP 获取管理员访问令牌,再查询任一节点;下面示例使用 jq 只保留验收字段,运维机需已安装 jq,<ACCESS_TOKEN> 和 <HOST_A> 替换为实际值。([Nacos 官网][3])
curl -fsS 'http://<HOST_A>:8848/nacos/v3/admin/core/cluster/node/list' \
-H 'Authorization: Bearer <ACCESS_TOKEN>' \
| jq -c '{code,message,data:[.data[]|{ip,port,state}]}'预期输出
{"code":0,"message":"success","data":[{"ip":"10.10.0.11","port":8848,"state":"UP"},{"ip":"10.10.0.12","port":8848,"state":"UP"},{"ip":"10.10.0.13","port":8848,"state":"UP"}]}若成员顺序不同也属于正常现象;验收时重点确认三条成员都存在且 state 为 UP。
做一次单节点故障演练
在节点 B 上停止 Nacos,再从节点 A、C 分别检查 readiness。三节点集群失去一个节点后仍保留多数派,存活节点应继续处于可读状态;成员探测需要时间,故障节点可能先显示 SUSPICIOUS,随后再变为 DOWN。
# 在节点 B 执行
cd <NACOS_HOME>/bin
sh shutdown.sh >/dev/null && echo node-b-stopped
# 在节点 A 或运维机执行
curl -fsS 'http://10.10.0.11:8848/nacos/v3/admin/core/state/readiness'
curl -fsS 'http://10.10.0.13:8848/nacos/v3/admin/core/state/readiness'预期输出
node-b-stopped
{"code":0,"message":"success","data":"ok"}
{"code":0,"message":"success","data":"ok"}客户端生产配置应指向稳定入口或可用的服务端地址集合,而不是只写节点 B。节点断开时,已有长连接可能出现一次重连和短暂重试;验证重点是业务客户端能否自动恢复并继续完成注册、发现或配置读取,而不是要求连接迁移完全无抖动。