You need to enable JavaScript to run this app. 如何将WAN Consul节点加入运行Consul的远程服务器?配置解析报错排查
优惠活动
大模型
产品
解决方案
定价
更多

如何将WAN Consul节点加入运行Consul的远程服务器?配置解析报错排查

WAN 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,直接修改配置中对应行即可:
    "retry_join_wan": ["10.8.0.2"]
    
    Consul的WAN集群加入配置默认支持直接传IP,未自定义端口时无需额外指定8300 WAN端口,可完全绕过DNS解析环节,重启Consul后即可正常发起加入请求。
  • 保留主机名需求的实现方式
    如果必须使用lon-primary-server作为节点标识,可通过两种方式让系统正确解析主机名:
    1. 修改本机/etc/hosts文件,新增映射条目10.8.0.2 lon-primary-server,操作系统解析该主机名时会优先读取hosts文件,不会再请求192.168.1.1的DNS。
    2. 调整节点DNS配置,将默认DNS服务器替换为可解析该主机名的内部DNS,或在现有192.168.1.1的DNS服务上新增lon-primary-server的A记录。

后续校验提醒

当前故障仅出现在域名解析环节,解析问题解决后,需额外确认两个节点之间的WAN端口(默认UDP/TCP 8300)网络连通性,避免出现解析正常但端口不通的二次故障。


内容的提问来源于stack exchange,提问作者Ciasto piekarz

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.17 01:06:06