排查WireGuard公钥不匹配或连接失败时，核心是核对双方配置中Public Key与Peer Public Key的对应关系。记录时需区分本地端与远端端的标识，避免混淆服务端ListenPort与客户端Keepalive参数。若连接建立失败，应依次检查本地防火墙、隧道接口状态及目标端日志，旋风通过比对握手时间戳定位中断环节。
记录双方公钥与对等体标识
首先导出本地WireGuard客户端配置中的PublicKey，并与服务端配置中对应Peer的PublicKey进行逐字符比对。需注意区分服务端ListenPort与客户端Endpoint地址，二者可能共用IP但端口逻辑不同。若服务端为多客户端部署，务必核对每个Peer的Unique Key标识，防止配置漂移导致密钥错配。此步骤为只读操作，不改变现有连接状态。
验证本地接口与防火墙状态
使用系统自带工具查看WireGuard隧道接口是否处于Up状态，记录接口名称及分配的内网IP。同时检查本地防火墙规则，确认UDP 51820（或自定义端口）的出站/入站策略未拦截WireGuard流量。Linux系统可通过ip link show查看接口状态，旋风加速器官网Windows需确认防火墙例外规则。若接口存在但无数据传输，需进一步观察网卡驱动日志或内核模块加载情况，排除本地网络栈异常。
分析目标服务端日志与握手记录
登录WireGuard服务端，旋风查看日志中最近一次握手请求的时间戳与源IP。若日志显示"handshake success"但客户端仍无流量，需检查服务端AllowedIPs配置是否覆盖了客户端访问的目标网段。注意AllowedIPs同时参与路由选择与源地址校验，配置0.0.0.0/0并不意味着自动处理所有路由，需结合实际网络架构判断。记录服务端PersistentKeepalive参数值（注意为单数形式），确认其未与客户端心跳间隔产生冲突导致连接超时。
技术人员正在仔细比对本地配置与服务器日志，以定位WireGuard连接失败的具体环节。
