疾风云机场账号登录
疾风云机场
Wi-Fi 与路由器

WireGuardPeer对等端配置实操步骤及完整示例说

很多刚接触WireGuard的用户很容易把全局接口配置和Peer对等端配置搞混,Peer是定义对端节点身份、路由权限的核心模块,哪怕密钥对生成正确,只要Peer段配置出错,整个隧道都无法正常连通。本文就从实操前提、分步配置到完整示例、排错逻辑把全流程讲清楚,帮大家避开常见的配置坑。

工程师实操WireGuardPeer配置

运维人员正在调试网络设备,完成WireGuard对等端参数的配置校验。

Peer配置前的必要前置检查

首先要确认你已经提前生成了本地节点和对端Peer节点的公私钥对,不能把两个节点的公钥私钥搞混,很多新手直接把本地私钥填进Peer的公钥字段,这是最常见的低级错误。

还要提前确认两端的基础网络连通性,比如服务端的WireGuard监听端口没有被系统防火墙、云服务商安全组拦截,疾风云VPN对端节点的公网IP或者可路由内网IP是准确的,不要填临时解析的动态域名结果之后又忘了同步更新。

分步完成Peer对等端核心参数配置

在WireGuard的主配置文件里,所有Peer段都是独立的区块,用方括号包裹的Peer标识开头,同一个配置文件里可以添加多个Peer段,对应多个不同的对端接入节点。

第一个必填参数是PublicKey,这里要填的是你要连接的对端节点的公钥,不是本地节点的私钥或者公钥,这个参数是WireGuard做身份校验的核心依据,错一个字符都无法完成加密握手流程。

第二个必填参数是AllowedIPs,这个参数定义的是你本地节点要把哪些网段的流量发送给这个Peer对等端,很多新手以为这个是对端节点自身的隧道IP,其实它是全局路由匹配的规则段,如果要把所有流量都走WireGuard隧道,疾风云机场这里可以填0.0.0.0/0,但是如果只需要访问对端的特定内网段,就只填对应网段即可。

完整的WireGuard Peer配置:配置示例说明

我们以最常见的站点到站点组网场景为例,服务端的WireGuard接口地址是10.0.0.1/24,监听端口是51820,现在要添加一个分支节点作为Peer,分支节点的隧道地址是10.0.0.2/32,分支背后的内网网段是192.168.2.0/24。

那么服务端侧添加的Peer配置段就应该是:[Peer] 区块下,PublicKey参数填写分支节点的公钥,AllowedIPs参数填写10.0.0.2/32, 192.168.2.0/24,Endpoint参数填写分支节点的公网IP加端口,PersistentKeepalive参数设置为25。

对应的分支节点侧的Peer配置段就要反向指向服务端,把PublicKey换成服务端的公钥,AllowedIPs填服务端侧的隧道网段10.0.0.0/24和服务端背后的内网网段,Endpoint填服务端的公网IP加51820端口,PersistentKeepalive参数对于位于家用NAT后面的节点是必要的,可以维持隧道的保活连接,避免被运营商的NAT表项提前回收。

Peer配置后的验证与常见误区排查

配置完成之后不要直接重启WireGuard服务,先执行wg-quick check 配置文件路径命令,先让系统校验配置文件的语法错误,很多新手配置完直接重启服务,遇到报错根本不知道哪里出了问题,提前做语法校验可以快速定位参数格式错误。

配置加载完成之后,执行wg show命令查看Peer的最新握手时间字段,如果这个字段是空的,说明两端没有完成加密握手,优先检查防火墙端口有没有放行,公钥有没有填反。如果握手成功但是流量不通,优先排查AllowedIPs的路由规则有没有配置错误,不要上来就抓包排查,大部分连通问题都是Peer段的路由规则配置不对导致的。

还要注意一个常见误区,很多用户在同一个配置文件里给多个Peer配置了重叠的AllowedIPs网段,这时候WireGuard会按照最长前缀匹配规则来路由流量,很容易出现流量走错Peer的情况,配置的时候要确保所有Peer的AllowedIPs网段没有不必要的重叠。

另外要注意WireGuard Peer配置本身不会自动过滤非路由网段的流量,不要随意扩大AllowedIPs的范围,避免把本不需要走隧道的流量错误导入隧道,带来不必要的隐私边界风险和额外的网络开销。

Wi-Fi 与路由器编辑组
Wi-Fi 与路由器编辑组
内容编辑

检查无线信号、设备摆放与有线连接,逐步定位家庭网络瓶颈。

查看更多文章
连接指南

找到适合当前设备的指南

遇到OpenVPN数据通道与登录状态相关问题,可从“分别检查授权、路由与实际请求”开始阅读。登录成功提示不能替代数据通道验收,需要结合具体环境判断。