很多刚接触WireGuard的用户会在配置文件里看到PersistentKeepalive这个字段,它本质是WireGuard对等节点之间的保活触发规则,专门用来解决UDP连接经过多层NAT网关后,映射条目超时被清理,导致原本可以互通的对等端无法主动发起连接的问题。
它要解决的核心场景
WireGuard本身是完全对等的P2P模型,没有严格的服务端和客户端区分,任意节点都可以配置监听端口等待其他节点接入。但绝大多数家用宽带、移动网络下的节点,都会被运营商分配内网地址,外层的NAT网关不会长期保留没有流量的UDP映射规则。

多层NAT网络环境下的对等节点互联拓扑,对应WireGuard保活机制的典型运行场景
如果没有这个保活机制,哪怕两个节点之前已经成功握手建立过隧道,只要几分钟到几十分钟没有任何隧道流量,NAT映射就会过期,外部节点主动发往这个内网节点的数据包会直接被网关丢弃,隧道就会变成看似连通实际不通的假死状态。
各对等端的职责分工
PersistentKeepalive是配置在单个对等端的对端条目下的,不是全局生效的参数,坚果加速器你给哪个对端设置这个值,就代表本地节点会主动定期向这个指定对端发送空的保活数据包。
如果两个对等端都处于公网直连、没有NAT的环境下,完全不需要配置这个字段,双方都可以随时主动发起连接,多余的保活流量反而没有任何实际意义。只有处于NAT后方、需要主动穿透网关的那一侧节点,才需要开启这个参数。
WireGuard没有强制要求所有节点都设置监听端口,哪怕你没有配置任何监听端口,只要设置了PersistentKeepalive,节点就会按照设定的间隔主动向外发起保活包,维持NAT映射条目有效。
配置生效的边界条件
这个字段的取值单位是秒,设置为0就代表关闭主动保活功能,非0的合法取值一般在20到120秒区间,刚好匹配绝大多数家用NAT网关的UDP映射超时阈值。
这个保活动作只针对WireGuard自己的UDP隧道端口生效,加速器和你设备上其他TCP服务、其他UDP服务的端口映射完全独立,不会干扰其他正在运行的网络连接。另外它的保活包本身是封装在WireGuard协议里的合法加密报文,不会被当成无效垃圾包直接丢弃。
不要把这个参数和AllowedIPs的路由规则混淆,PersistentKeepalive只负责维持隧道层面的连通性,不会直接修改你的系统路由表,也不会因为你设置了全量路由就强制接管所有局域网流量。
低影响的只读验证方法
你不需要修改任何现有配置,也不用重启隧道,就可以直接观察这个字段的运行状态。你可以查看WireGuard运行时的状态输出,找到对应对端的最近一次保活发送时间,坚果加速器和你配置的间隔做对比,就能确认规则是否正常触发。
如果观察到保活包按照你设置的间隔正常发出,就说明这个字段的配置已经被正确加载,不需要额外调整系统防火墙或者路由规则。如果保活动作没有按预期触发,你可以去核对对应对端条目的字段拼写,确认是单数的PersistentKeepalive,不要写成复数形式导致配置不生效。



