集群寻址

集群寻址用于告诉 Nacos Server 当前集群有哪些节点。每个节点启动后，会根据寻址结果建立集群成员列表，再完成节点通信、健康检查、Raft/Distro 等内部协作。

当前 Nacos 3.x 的集群寻址主要支持两种模式：

选择寻址模式

Nacos 通过 nacos.core.member.lookup.type 指定寻址模式：

nacos.core.member.lookup.type=file

可选值如下：

• file：使用 cluster.conf 或 nacos.member.list。
• address-server：从地址服务器拉取集群节点列表。

如果没有显式配置 nacos.core.member.lookup.type，Nacos 会按以下顺序选择：

1. 如果存在 ${nacos.home}/conf/cluster.conf，使用 file。
2. 如果配置了 nacos.member.list，使用 file。
3. 否则使用 address-server。

单机模式下，Nacos 会使用单机寻址，不需要配置集群成员列表。

文件寻址

文件寻址是最常用的生产部署方式。将所有 Nacos Server 节点写入 ${nacos.home}/conf/cluster.conf，每行一个节点地址：

10.0.0.11:8848
10.0.0.12:8848
10.0.0.13:8848

也可以使用 nacos.member.list 指定节点列表：

nacos.core.member.lookup.type=file
nacos.member.list=10.0.0.11:8848,10.0.0.12:8848,10.0.0.13:8848

使用文件寻址时，建议保持所有节点上的 cluster.conf 内容一致。Nacos 会监听 cluster.conf 变更并重新读取节点列表，但生产环境仍建议通过发布流程统一修改，避免节点间看到不同的集群成员。

地址服务器寻址

地址服务器寻址适用于由外部系统统一管理 Nacos Server 列表的场景。Nacos 启动时会访问地址服务器，拉取节点列表，并定期刷新。

常用配置如下：

nacos.core.member.lookup.type=address-server
address.server.domain=address-server.example.com
address.server.port=8080
address.server.url=/serverlist
nacos.core.address-server.retry=5

对应含义如下：

地址服务器返回内容应能被解析为 Nacos 集群节点列表，通常为多行 ip:port 格式。

运维建议

• 生产环境优先使用 file 或由平台统一维护的 address-server，避免每个节点临时写入不同的成员列表。
• 变更集群成员前，先确认新老节点版本、端口、网络策略和数据源配置一致。
• 如果使用 address-server，请把地址服务器纳入监控。地址服务器不可用会影响节点列表刷新，首次启动时也可能导致 Nacos 启动失败。
• 排查集群成员问题时，优先查看 ${nacos.home}/logs/nacos-cluster.log 和 ${nacos.home}/logs/nacos.log。
• 如果节点列表来自 cluster.conf，请检查文件内容、挂载路径和容器内实际文件是否一致。

常见问题