如何将WAN Consul节点加入运行Consul的远程服务器?配置解析报错排查
环境与现象
已知本地主服务器lon-primary-serverIP为10.8.0.2,当前配置远程节点加入WAN集群时,Consul会向其他子网的DNS发起请求,无法正常定位目标节点。
当前Consul配置
{ "node_name": "phl-remote-server", "bind_addr": "{{GetInterfaceIP \"tun0\"}}", "ui": true, "client_addr": "0.0.0.0", "data_dir": "/tmp/consul", "datacenter": "phl", "log_level": "INFO", "enable_syslog": true, "enable_debug": true, "server": true, "bootstrap_expect": 1, "leave_on_terminate": false, "skip_leave_on_interrupt": true, "rejoin_after_leave": true, "advertise_addr": "{{GetInterfaceIP \"eth0\"}}", "advertise_addr_wan": "{{GetInterfaceIP \"tun0\"}}", "retry_join_wan": ["lon-primary-server"] }
启动告警日志
Nov 21 15:26:39 phl-pi-3 consul[1401]:
2020-11-21T15:26:39.897+0530 [WARN] agent: Join cluster failed, will retry: cluster=WAN retry_interval=30s error= Nov 21 15:26:39 phl-pi-3 consul[1401]: 2020-11-21T15:26:39.897+0530 [WARN] agent.server.memberlist.wan: memberlist: Failed to resolve lon-primary-server: lookup lon-primary-server on 192.168.1.1:53: no Nov 21 15:26:39 phl-pi-3 consul[1401]: 2020-11-21T15:26:39.897+0530 [WARN] agent: (WAN) couldn't join: number_of_nodes=0 error="1 error occurred:
- Failed to resolve lon-primary-server: lookup lon-primary-server on 192.168.1.1:53: no such host
待确认问题
配置存在什么问题?为何retry_join_wan配置项无法正常定位并加入WAN集群中的目标节点?
核心故障原因
retry_join_wan填入的是自定义主机名lon-primary-server,Consul本身不会内置存储该主机名与IP的映射关系,发起连接时会直接调用操作系统的标准DNS解析流程。- 从日志可见,节点当前默认DNS服务器为192.168.1.1,该服务器未配置
lon-primary-server的域名解析记录,因此直接返回no such host错误——故障发生在域名解析阶段,还未进入节点连通性校验环节。
可选修复方案
- 最快落地方案:直接使用IP替代主机名
你已知目标主节点IP为10.8.0.2,直接修改配置中对应行即可:
Consul的WAN集群加入配置默认支持直接传IP,未自定义端口时无需额外指定8300 WAN端口,可完全绕过DNS解析环节,重启Consul后即可正常发起加入请求。"retry_join_wan": ["10.8.0.2"] - 保留主机名需求的实现方式
如果必须使用lon-primary-server作为节点标识,可通过两种方式让系统正确解析主机名:- 修改本机
/etc/hosts文件,新增映射条目10.8.0.2 lon-primary-server,操作系统解析该主机名时会优先读取hosts文件,不会再请求192.168.1.1的DNS。 - 调整节点DNS配置,将默认DNS服务器替换为可解析该主机名的内部DNS,或在现有192.168.1.1的DNS服务上新增
lon-primary-server的A记录。
- 修改本机
后续校验提醒
当前故障仅出现在域名解析环节,解析问题解决后,需额外确认两个节点之间的WAN端口(默认UDP/TCP 8300)网络连通性,避免出现解析正常但端口不通的二次故障。
内容的提问来源于stack exchange,提问作者Ciasto piekarz

