很多人配置WireGuard隧道时遇到连接不通、握手完全没响应的情况,排除防火墙和端口开放问题后,最常见的诱因就是公钥填写错误,这类问题的症状非常统一:隧道启动后长时间没有任何对等端握手记录,也不会产生任何流量转发,接下来可以按从本地到远端的顺序逐层排查。
第一步:检查本地配置文件的公钥字段
先打开你当前运行的WireGuard实例对应的配置文件,找到本端的PrivateKey字段下方的Peer区块,翻墙确认这里填写的是对端设备生成的公钥,而不是本端自己的公钥。很多新手会把两端的公钥搞混,直接把自己生成的公钥填到自己配置的Peer区块里,这种情况完全不会触发任何报错,只会静默等待永远不可能到来的握手。
你可以用WireGuard自带的密钥查看工具,把你手里的公钥文本重新解码校验,如果工具提示格式不合法、长度不对,就说明你复制粘贴的时候多带了空格、换行,或者漏了最后几个字符,翻墙这类肉眼很难发现的格式错误,是仅次于公私钥填反的第二高发问题。
第二步:核对对端对等端的公钥配置
WireGuard是对等端模型,两端的公钥配置是完全对称的:A端的Peer区块里必须填B端的公钥,梯子B端的Peer区块里也必须填A端的公钥,只要任意一端填错,两端都不会收到合法的握手包。你不需要修改任何运行中的配置,先登录对端的管理界面或者打开对端的配置文件,直接比对两个公钥的对应关系即可。

运维人员逐层排查WireGuard配置中的公钥填写错误问题,定位隧道握手无响应的诱因。
部分带Web管理界面的第三方WireGuard封装工具,会自动把本端公钥填充到对端的导出配置里,如果你手动修改过导出配置里的公钥,就会出现两端配置不匹配的情况,这时候直接用管理界面生成的完整配置文件导入,比手动逐字核对要更稳妥。
第三步:结合握手状态确认公钥问题
你可以查看WireGuard运行时的实时状态输出,如果连续几分钟都没有任何握手记录,同时你已经确认两端的UDP端口是可达的,就可以基本锁定公钥填写错误的问题。如果公钥填写正确但其他配置有误,至少会出现几次握手失败的日志,不会完全没有任何状态更新。
不要把AllowedIPs配置错误的症状和公钥错误搞混:如果只是AllowedIPs配置不对,你会看到隧道已经完成握手,只是特定网段的流量走不通,翻墙不会出现完全零握手的情况。另外PersistentKeepalive这类保活参数的配置错误,也只会影响NAT后面的设备长期连通性,不会导致初始握手完全无法发起。
排除公钥错误后的后续验证
当你修正两端的公钥配置之后,等待10到30秒就可以看到第一条握手记录,这时候再去测试两端的内网网段连通性,就可以确认隧道是否正常工作。如果修正公钥之后依然没有握手,再去排查防火墙规则、UDP端口开放状态这类其他问题,不需要一开始就调整路由或者修改系统网络参数。
你不需要为了排查这类问题关闭系统防火墙,只要确认两端的WireGuard使用的UDP端口没有被拦截,就可以完成绝大多数验证步骤,全程都可以用只读的状态查看操作完成排查,不会影响设备上其他正在运行的网络服务。
翻墙 


