翻墙会员登录
翻墙
隐私与安全

WireGuard公钥常见填写错误相关问题解答

WireGuard公钥常见填写错误相关问题解答 - vpn

很多人配置WireGuard隧道时遇到连接不通、握手完全没响应的情况,排除防火墙和端口开放问题后,最常见的诱因就是公钥填写错误,这类问题的症状非常统一:隧道启动后长时间没有任何对等端握手记录,也不会产生任何流量转发,接下来可以按从本地到远端的顺序逐层排查。

第一步:检查本地配置文件的公钥字段

先打开你当前运行的WireGuard实例对应的配置文件,找到本端的PrivateKey字段下方的Peer区块,翻墙确认这里填写的是对端设备生成的公钥,而不是本端自己的公钥。很多新手会把两端的公钥搞混,直接把自己生成的公钥填到自己配置的Peer区块里,这种情况完全不会触发任何报错,只会静默等待永远不可能到来的握手。

你可以用WireGuard自带的密钥查看工具,把你手里的公钥文本重新解码校验,如果工具提示格式不合法、长度不对,就说明你复制粘贴的时候多带了空格、换行,或者漏了最后几个字符,翻墙这类肉眼很难发现的格式错误,是仅次于公私钥填反的第二高发问题。

第二步:核对对端对等端的公钥配置

WireGuard是对等端模型,两端的公钥配置是完全对称的:A端的Peer区块里必须填B端的公钥,梯子B端的Peer区块里也必须填A端的公钥,只要任意一端填错,两端都不会收到合法的握手包。你不需要修改任何运行中的配置,先登录对端的管理界面或者打开对端的配置文件,直接比对两个公钥的对应关系即可。

网络设备:WireGuard公钥:常见填

运维人员逐层排查WireGuard配置中的公钥填写错误问题,定位隧道握手无响应的诱因。

部分带Web管理界面的第三方WireGuard封装工具,会自动把本端公钥填充到对端的导出配置里,如果你手动修改过导出配置里的公钥,就会出现两端配置不匹配的情况,这时候直接用管理界面生成的完整配置文件导入,比手动逐字核对要更稳妥。

第三步:结合握手状态确认公钥问题

你可以查看WireGuard运行时的实时状态输出,如果连续几分钟都没有任何握手记录,同时你已经确认两端的UDP端口是可达的,就可以基本锁定公钥填写错误的问题。如果公钥填写正确但其他配置有误,至少会出现几次握手失败的日志,不会完全没有任何状态更新。

不要把AllowedIPs配置错误的症状和公钥错误搞混:如果只是AllowedIPs配置不对,你会看到隧道已经完成握手,只是特定网段的流量走不通,翻墙不会出现完全零握手的情况。另外PersistentKeepalive这类保活参数的配置错误,也只会影响NAT后面的设备长期连通性,不会导致初始握手完全无法发起。

排除公钥错误后的后续验证

当你修正两端的公钥配置之后,等待10到30秒就可以看到第一条握手记录,这时候再去测试两端的内网网段连通性,就可以确认隧道是否正常工作。如果修正公钥之后依然没有握手,再去排查防火墙规则、UDP端口开放状态这类其他问题,不需要一开始就调整路由或者修改系统网络参数。

你不需要为了排查这类问题关闭系统防火墙,只要确认两端的WireGuard使用的UDP端口没有被拦截,就可以完成绝大多数验证步骤,全程都可以用只读的状态查看操作完成排查,不会影响设备上其他正在运行的网络服务。

VPN 基础编辑组
VPN 基础编辑组
内容编辑

解释加密隧道、连接协议与出口地址,帮助理解 VPN 的工作方式。

查看更多文章
连接指南

找到适合当前设备的指南

遇到WireGuard地址前缀遗漏相关问题,可从“核对AllowedIPs及工具实际创建的路由”开始阅读。不要为解决一个目标而无范围地扩大所有前缀,需要结合具体环境判断。