WireGuard预共享密钥是在原有公钥加密体系之外新增的一层链路加密防护，很多运维人员排查两端连通失败问题时，经常跳过信息留存步骤直接修改配置，反而导致故障根因被覆盖，反复试错也找不到问题。这份排查时需要记录的关键信息清单，覆盖从现象采集到根因定位的全流程核心内容，能帮使用者快速缩小问题范围，避免无意义的配置回滚操作。
运维人员排查WireGuard连通故障前，需先完整留存初始运行状态的各类关键信息，避免后续操作覆盖故障根因
故障发生时的基础连通现象记录
排查操作启动前，首先要完整记录当前的直观故障现象，不要上来就修改任何配置参数，先把初始状态的网络特征全部留存。
要分别导出WireGuard服务端和客户端的wg show命令完整输出内容，包括接口当前状态、VPN加速器最新握手时间、累计收发字节数、所有已配置的对等节点条目，不要只靠截图留存信息，纯文本格式后续可以直接做比对校验，避免截图遗漏字符。
还要同步记录故障触发的前置操作上下文，比如是刚更新完密钥、刚迁移了服务器公网IP、或是调整了系统防火墙规则之后才出现的连通异常，这类背景信息能直接排除大部分配置类低级错误，大幅缩短排查耗时。
预共享密钥本身的配置匹配校验记录
这部分是WireGuard预共享密钥：排查时应记录的信息的核心模块，首先要分别提取两端配置文件里preshared-key字段对应的密钥原文，不要直接用肉眼比对长串随机字符，要把两端的密钥文本分别做SHA256哈希校验，记录下两个密钥的哈希值，确认是否完全一致。
很多用户容易踩的操作误区是密钥复制的时候多带了空格、换行符，VPN加速器或是把节点公钥、私钥误填到了预共享密钥的字段里，记录哈希校验结果就能直接排除这类人为输入错误，不需要反复重新生成密钥做无用测试。
还要记录预共享密钥的生成方式，确认是用wg genpsk原生命令生成的合规密钥，还是自行手动编辑的自定义字符串，非标准生成的密钥虽然也能被WireGuard识别，但部分旧版本客户端会出现兼容问题，这类特征也要同步留存到排查记录里。
关联配置项的联动校验信息记录
接下来要记录预共享密钥关联的其他WireGuard配置参数，包括对应对等节点的公钥、允许的IP段、监听端口、持久保活参数的当前配置值，很多时候连通失败不是预共享密钥本身错误，而是和它绑定的对等节点公钥不匹配，导致校验流程直接中断。
还要记录两端操作系统的本地防火墙、云服务器安全组的规则状态，确认WireGuard接口的入站出站规则没有拦截带预共享密钥标识的加密报文，部分系统的默认安全策略会丢弃非知名端口的未知加密流量，这类和密钥校验联动的网络规则也要逐一登记。
跨场景验证的对照测试信息记录
要记录临时关闭预共享密钥之后的连通测试结果，如果移除两端配置里的preshared-key字段之后，节点之间能正常握手传输数据，就能确认故障点确实落在预共享密钥的校验环节，而不是上层路由或者公网连通性的问题。
还要记录不同客户端的对照测试结果，比如同一套密钥配置在Linux原生WireGuard接口、Windows端WireGuard GUI、移动端WireGuard应用上的表现是否一致，如果只有特定平台出现校验失败，网络加速器大概率是对应客户端的配置导入环节出了格式错误，不需要调整服务端全局配置。
所有排查过程中记录的密钥相关信息不要随意对外分发，预共享密钥本身属于VPN链路的第二层加密凭证，和节点私钥一样属于敏感隐私信息，内部排查完成之后要妥善加密归档，避免泄露之后被未授权人员接入内部虚拟网络。
