手机连接

WireGuardPersistentKeepalive字段的具体含义说明

WireGuardPersistentKeepalive字段的具体含义说明

很多刚接触WireGuard的用户会在配置文件里看到PersistentKeepalive这个字段,它本质是WireGuard对等节点之间的保活触发规则,专门用来解决UDP连接经过多层NAT网关后,映射条目超时被清理,导致原本可以互通的对等端无法主动发起连接的问题。

它要解决的核心场景

WireGuard本身是完全对等的P2P模型,没有严格的服务端和客户端区分,任意节点都可以配置监听端口等待其他节点接入。但绝大多数家用宽带、移动网络下的节点,都会被运营商分配内网地址,外层的NAT网关不会长期保留没有流量的UDP映射规则。

网络设备:WireGuard Persi

多层NAT网络环境下的对等节点互联拓扑,对应WireGuard保活机制的典型运行场景

如果没有这个保活机制,哪怕两个节点之前已经成功握手建立过隧道,只要几分钟到几十分钟没有任何隧道流量,NAT映射就会过期,外部节点主动发往这个内网节点的数据包会直接被网关丢弃,隧道就会变成看似连通实际不通的假死状态。

各对等端的职责分工

PersistentKeepalive是配置在单个对等端的对端条目下的,不是全局生效的参数,坚果加速器你给哪个对端设置这个值,就代表本地节点会主动定期向这个指定对端发送空的保活数据包。

如果两个对等端都处于公网直连、没有NAT的环境下,完全不需要配置这个字段,双方都可以随时主动发起连接,多余的保活流量反而没有任何实际意义。只有处于NAT后方、需要主动穿透网关的那一侧节点,才需要开启这个参数。

WireGuard没有强制要求所有节点都设置监听端口,哪怕你没有配置任何监听端口,只要设置了PersistentKeepalive,节点就会按照设定的间隔主动向外发起保活包,维持NAT映射条目有效。

配置生效的边界条件

这个字段的取值单位是秒,设置为0就代表关闭主动保活功能,非0的合法取值一般在20到120秒区间,刚好匹配绝大多数家用NAT网关的UDP映射超时阈值。

这个保活动作只针对WireGuard自己的UDP隧道端口生效,加速器和你设备上其他TCP服务、其他UDP服务的端口映射完全独立,不会干扰其他正在运行的网络连接。另外它的保活包本身是封装在WireGuard协议里的合法加密报文,不会被当成无效垃圾包直接丢弃。

不要把这个参数和AllowedIPs的路由规则混淆,PersistentKeepalive只负责维持隧道层面的连通性,不会直接修改你的系统路由表,也不会因为你设置了全量路由就强制接管所有局域网流量。

低影响的只读验证方法

你不需要修改任何现有配置,也不用重启隧道,就可以直接观察这个字段的运行状态。你可以查看WireGuard运行时的状态输出,找到对应对端的最近一次保活发送时间,坚果加速器和你配置的间隔做对比,就能确认规则是否正常触发。

如果观察到保活包按照你设置的间隔正常发出,就说明这个字段的配置已经被正确加载,不需要额外调整系统防火墙或者路由规则。如果保活动作没有按预期触发,你可以去核对对应对端条目的字段拼写,确认是单数的PersistentKeepalive,不要写成复数形式导致配置不生效。

手机连接编辑组
手机连接编辑组
内容编辑

整理 Android 与 iOS 的连接权限、后台运行和网络切换注意事项。

查看更多文章
连接指南

从一个连接问题开始

遇到未匹配流量的默认动作相关问题,可从“选择几个不在专用规则中的目标验证”开始阅读。只验证已写规则的目标不能覆盖默认行为,需要结合具体环境判断。