Wi-Fi 与路由器

WireGuard预共享密钥排查过程中应记录的信息


WireGuard预共享密钥排查过程中应记录的信息

当WireGuard隧道出现连通异常,且你已经初步定位问题可能和预共享密钥相关时,不需要立刻反复修改密钥重启服务,先按分层顺序记录对应节点的状态信息,就能快速缩小问题范围,避免误改其他正常运行的隧道配置。

网络设备:WireGuard预共享密钥:

排查WireGuard预共享密钥相关连通异常时,优先按分层流程记录状态信息可快速缩小故障范围

本地节点基础状态记录

首先记录当前本地WireGuard实例的运行状态,优先做只读查询,不要改动任何配置项。你需要确认当前加载的配置文件里预共享密钥字段的实际取值,不要只核对你印象里的旧密钥,很多时候配置修改后没有完成热重载,运行态和磁盘文件的内容并不一致。

同步记录本地节点的公网监听UDP端口、对等端公网地址和端口配置,以及PersistentKeepalive的当前设置值。WireGuard是对等端模型,任意一端都可以配置监听端口,机场推荐不要默认只有一端处于服务端模式,两端的监听状态都要纳入记录范围。

隧道层面交互状态记录

接下来记录隧道运行时的实时流量统计信息,观察最近一次成功握手的时间戳。如果预共享密钥不匹配,两端的握手报文都会被直接丢弃,不会生成合法的握手记录,这个特征可以直接把密钥问题和端口不通、防火墙拦截的问题区分开。

记录当前配置的AllowedIPs字段完整内容,不要只看是否写了0.0.0.0/0。这个字段同时参与发送侧的目的路由选择和接收侧的源地址校验,哪怕预共享密钥完全正确,AllowedIPs配置不匹配也会出现看起来和密钥错误高度相似的丢包现象,需要把这类信息排除后再定位密钥问题。

对端可观测状态交叉记录

在你有权限访问的对端节点上,机场推荐 clash执行和本地相同的状态查询操作,记录对端侧的运行态配置、握手时间戳、流量收发计数。如果本地能看到发出的握手报文计数持续上涨,但对端侧完全没有收到对应握手请求,问题大概率出在中间链路的UDP拦截,和预共享密钥无关。

如果两端都看不到任何握手成功记录,再分别记录两端当前加载的预共享密钥的哈希标识,不要直接明文复制粘贴密钥比对,避免传输过程中密钥泄露。只有两端的密钥标识完全不匹配时,机场推荐才能确认是预共享密钥配置不一致导致的问题。

目标连通性验证记录

最后记录排除隧道加密层之后的底层连通性测试结果,机场推荐你可以使用同端口的UDP报文测试工具,验证两端的UDP端口可以正常收发报文。因为UDP和TCP的同号端口属于完全独立的监听端点,不要用TCP端口连通性测试的结果直接推导UDP端口可用。

所有记录完成后再交叉比对,不要仅凭单一现象下结论。比如握手失败同时伴随UDP端口不通的记录,就不能直接判定是预共享密钥错误,分层记录的所有信息可以帮你快速回溯问题根因,也能避免后续排查同类问题时重复做无效操作。

节点与线路编辑组
节点与线路编辑组
内容编辑

结合网络距离、运营商路径和时段变化,理解线路选择与测试方法。

查看更多文章
连接指南

从一个连接问题开始

遇到直连例外过宽相关问题,可从“缩小到明确需要的目标并保留原规则备份”开始阅读。不能把所有私有网段都默认视作本地资源,需要结合具体环境判断。