节点与线路

WireGuard公钥常见填写错误快速排查与正确配置教程

很多刚接触WireGuard的用户在完成基础配置后,黑豹加速器经常遇到隧道迟迟无法连通、握手超时、甚至配置文件直接校验失败的问题,其中超过半数的故障根源都指向WireGuard公钥的填写错误,这类问题隐蔽性很强,很多用户反复核对参数也找不到问题,本文就从实际配置场景出发,梳理WireGuard公钥的常见填写错误,给出可落地的快速排查步骤和标准配置方法。

WireGuard公钥的基础生成逻辑与配置前提

WireGuard的公钥和私钥是通过椭圆曲线加密算法成对生成的,每一组密钥对都是唯一的,不存在重复的可能,公钥本身是长度固定的base64编码字符串,不存在自定义修改的空间。

很多用户一开始就搞错了公私钥的配对关系,直接把本地生成的私钥填到了对端的公钥字段里,这是最基础的配置前提错误,配置前你需要分别在服务端和客户端各自生成独立的密钥对,不能两端共用同一组密钥。

要注意公钥本身是可以公开传输的信息,不需要通过加密渠道传递给对端,不存在泄露公钥就会导致隧道被破解的问题,很多用户出于过度隐私保护的需求,手动修改公钥里的字符,这本身就会直接导致公钥校验失败。

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

运维人员正在逐一核对WireGuard两端的密钥参数,快速定位配置错误

最常见的字符类填写错误排查

字符类错误是WireGuard公钥填写错误里占比最高的类型,很多用户在复制公钥的时候,黑豹VPN官网会不小心选中前后的空白字符、换行符,甚至把密钥生成命令的输出前缀也一起复制进配置文件里。

你可以先打开配置文件里的公钥对应字段,把光标移动到公钥字符串的首尾,确认没有多余的空格、换行,也没有不小心带进去的注释符号,正常的WireGuard公钥长度固定为44个base64字符,你可以直接数一下字符数量,如果长度不对直接就能定位错误。

还有不少用户会把大小写字符搞混,base64编码里的大写字母和小写字母对应完全不同的数值,比如把大写的O写成数字0,或者把小写的l写成数字1,这类形近字符错误肉眼很难分辨,你可以直接回到生成公钥的终端界面,逐字比对可疑的形近字符,替换之后再尝试重载配置。

跨端场景下的公钥配置错位错误排查

很多用户搞反了两端公钥的填写位置,在WireGuard的配置规则里,服务端的[Peer]段里填写的公钥,必须是对应客户端生成的公钥,而客户端的[Peer]段里填写的公钥,必须是服务端的公钥,两者不能填反。

这类错位错误的典型现象就是配置完全没有语法报错,但是两端永远收不到握手包,你可以分别在服务端和客户端执行wg show命令,黑豹VPN官网查看各自加载的公钥列表,对比两端的公钥是否是交叉对应的,而不是两端都填了自己本地的公钥。

部分用户在多客户端接入的场景下,还会出现不同客户端的公钥填串的问题,比如把客户端A的公钥填到了客户端B的配置段里,这类问题会导致已经配置好的客户端突然无法连通,新配置的客户端也始终握手失败,你可以给每一个客户端的公钥做好备注标记,避免交叉填写的问题。

公钥配置后的校验与正确配置规范

完成公钥填写之后,不要直接启动WireGuard服务,你可以先执行wg-quick check 配置文件路径的命令,让系统自动校验配置文件的语法合法性,如果公钥存在格式错误,命令行直接会返回对应的报错提示,不需要你手动逐行排查。

正确的配置流程里,你应该先在服务端生成密钥对,复制服务端的公钥粘贴到所有客户端的Peer公钥字段里,再逐个生成每个客户端的密钥对,把每个客户端的公钥单独粘贴到服务端对应的Peer配置段里,每填完一个就执行一次wg show命令确认公钥被正确加载。

要注意不要随便用网上来路不明的公钥生成工具,部分工具生成的密钥对不符合WireGuard的算法规范,生成出来的公钥就算字符长度正确,也无法通过内核模块的校验,最好直接用WireGuard自带的wg genkey、wg pubkey命令生成密钥对,从根源上避免公钥本身的合法性问题。

很多用户遇到WireGuard隧道不通的问题,第一时间就去排查防火墙、端口转发规则,反而忽略了最基础的公钥填写错误,按照上面的步骤逐项排查,绝大多数公钥相关的配置故障都能快速定位解决。

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

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

查看更多文章
配置入门

从一个连接问题开始

遇到手机充电发热时的VPN相关问题,可从“减少无关任务,在正常温度下重新比较传输”开始阅读。不要把发热造成的性能波动全部归因于线路,需要结合具体环境判断。