在多节点WireGuard组网的日常运维中，不少用户遇到Peer配置连通故障时，往往直接反复修改参数试错，既没留存原始配置也没记录过程状态，反而导致故障根因被覆盖，排查耗时成倍增加。WireGuard Peer配置：排查时应记录的信息，全部围绕配置一致性、网络连通性、运行态状态三个核心维度展开，不需要冗余的无关数据，就能帮运维人员在最短时间内定位90%以上的常见配置故障，避免无效的重复操作。
Peer端基础标识与配置原始参数记录
排查操作启动前，首先要做的不是修改配置，而是先把当前Peer节点的所有核心原始配置完整记录下来，包括节点自身的公钥、预共享密钥、分配到的WireGuard虚拟IP地址三个核心值。记录完成后要和对端服务端节点上绑定该Peer的配置页逐字符比对，预期结果是两边的Peer公钥完全一致，没有多余空格、大小写错误或者字符遗漏，常见的排查误区就是很多用户随手复制公钥时漏了末尾一两个字符，导致隧道完全无法发起握手，反复调试都找不到问题。
接下来还要同步记录当前Peer配置里填写的服务端Endpoint地址和对应的UDP监听端口，如果Endpoint填写的是域名，还要把当前本地设备上解析得到的Endpoint实际公网IP也一并记录，避免本地DNS缓存过期，解析出来的IP已经不是服务端当前的公网地址，导致所有握手请求都发到了错误的节点上，这类动态IP场景下的配置偏差非常容易被忽略，留存解析结果就能直接排除域名解析类故障。
运维人员在排查WireGuard Peer配置故障时逐项记录核心关键信息
本地网络与端口连通性实测记录
接下来要记录运行WireGuard Peer的本地设备的基础网络状态，包括设备当前的公网出口IP、是否默认启用IPv6、本地系统防火墙针对WireGuard程序的放行规则。很多用户遇到的故障不是隧道本身没建立，而是本地防火墙默认拦截了WireGuard虚拟网卡的转发流量，导致隧道握手成功之后，完全无法访问对端内网的资源，西柚加速器多设备使用说明逐条记录防火墙的入站出站规则，就能快速确认有没有针对虚拟网段的多余限制。
还要记录针对服务端WireGuard端口的抓包实测结果，西柚加速器多设备使用说明用tcpdump或者对应平台的抓包工具，抓取本地网卡发出的目的地址为服务端Endpoint IP、目的端口为WireGuard服务端口的UDP报文，确认本地确实向外发出了WireGuard握手请求，预期结果是能看到连续的握手报文从本地网卡发出，没有被本地系统直接丢弃。不少家用宽带场景下运营商会随机封禁非标准UDP端口，或者路由器的UDP防火墙直接拦截陌生出站UDP报文，这类问题只有通过抓包记录才能快速定位，不会把时间浪费在反复调整WireGuard配置上。
WireGuard运行态日志与握手状态记录
WireGuard Peer配置：排查时应记录的信息里，运行态日志是最容易被忽略但指向性最强的内容，不要只看GUI界面上的连接状态提示，要把内核态或者用户态WireGuard的完整运行日志导出留存。日志里会明确标注公钥不匹配、虚拟IP网段冲突、路由规则写入失败这类具体报错，很多时候Peer配置的虚拟IP和本地现有局域网的网段完全重叠，WireGuard会自动放弃添加对应隧道路由，界面上不会给出明显提示，只有日志里能找到对应的记录。
还要按时间戳记录Peer的握手状态变化，正常连通的Peer节点握手间隔不会超过两分钟，如果连续多次都没有收到对端返回的握手回应，西柚大概率是对端服务端的Peer配置里没有把当前节点的公钥加入允许列表，或者对端的防火墙没有放行WireGuard的服务端口。记录连续握手失败的时间点，就能和对端服务端的运行日志做时间线对齐，快速确认是哪一侧的配置出现了遗漏，不需要两边反复截图核对所有配置项。
路由转发与跨节点访问路径记录
在多Peer的复杂组网场景下，还要完整记录当前Peer配置里设置的AllowedIPs段的完整列表，很多用户为了实现隧道全流量转发把AllowedIPs设为0.0.0.0/0，但是漏了把本地管理网段、局域网网段排除在隧道路由之外，导致Peer启动之后本地直接断网，没法再远程调试设备。记录AllowedIPs的时候要同步把配置的排除路由段也列出来，确认路由优先级不会出现冲突，避免排查过程中把自己锁在远程设备之外。
最后还要记录跨Peer节点访问时的路径追踪结果，用traceroute工具测试访问对端内网资源的路径，确认流量是走WireGuard虚拟网卡转发，还是走了本地的默认网关。不少操作系统的路由优先级规则和用户预期不符，导致明明配置了完整的Peer隧道，实际业务流量根本没有进入隧道，排查的时候把路径记录下来，就能快速区分是隧道本身连通性故障，还是路由规则配置错误，不用在隧道加密、密钥这类无关的环节浪费时间。
把上述所有信息整理归档之后，不管是自行排查故障，还是提交给其他运维人员协助处理，都能避免大量反复核对配置的无效沟通，大幅缩短WireGuard Peer配置故障的定位周期，后续同类故障再次出现时，历史记录也能直接作为参照，快速排除已知的同类问题。
