本文目录导读:

针对 QuickQ(通常是基于 OpenWrt 或类似系统的路由器/网关),设置 WireGuard 的 PersistentKeepalive(持久保活)间隔通常有两种方法:通过 Web 界面 或 通过命令行修改配置文件。
注意: QuickQ 的固件版本较多(如基于 Lean 源码的魔改版、iStoreOS 版等),路径可能略有不同,以下是通用的操作步骤:
通过 Web 界面(最推荐,操作简单)
- 登录 QuickQ 后台:进入“网络” -> “VPN” -> “WireGuard” 或 “服务” -> “VPN -> WireGuard”(视具体固件而定)。
- 找到对应的 Peers(对端/客户端):
- 如果是作为客户端连接别人:找到你添加的那个对端(Peer),点击“编辑”或“修改”。
- 如果是服务端接受别人连接:在“已连接客户端”列表或“对等端”列表中找到对应的客户端,点击编辑。
- 设置 Keepalive:
- 找到 “持久保活”、“Keep Alive” 或 “持续连接” 字段。
- 数值设置:建议设置为 25(秒) 或 30(秒)。
- 解释:这个数值不能太短(如5秒),否则无意义且浪费流量;也不能太长(如120秒),否则可能仍然被 NAT 网关踢掉,25-30秒是一个常见且有效的值,能保证绝大多数网络环境下的连接稳定。
- 点击 “保存并应用”。
通过命令行(修改配置文件)
Web 界面没有该选项,或者你想快速批量修改,可以使用 SSH 登录到 QuickQ。
- SSH 登录 QuickQ。
- 编辑 WireGuard 配置文件:
vim /etc/config/wireguard
(或者如果固件使用
wg-quick标准格式,位置在/etc/wireguard/wg0.conf) - 找到对应的 Peer 段落。
- 添加或修改参数:
config peer 'your_peer_name' option public_key '...' option endpoint '...' # 添加下面这行 option persistent_keepalive '25' # 按需修改数值,单位秒 # 如果是标准 wg0.conf 格式,则在 [Peer] 下添加: # PersistentKeepalive = 25 - 重启 WireGuard 接口:
# 方法一 /etc/init.d/network restart # 方法二(如使用 wg-quick) wg-quick down wg0 && wg-quick up wg0
特别提示:为何需要 Keepalive?
- 解决 NAT 踢出:如果你的 QuickQ 路由器在移动 4G/5G 热点、企业级 NAT 或 家用光猫 后面,这些设备会因短时间内无数据流量,自动断开 UDP 映射(WireGuard 使用 UDP),Keepalive 会定时发送空包维持映射。
- 服务端 vs 客户端:通常是客户端需要设置(例如你的 QuickQ 连接到一个固定 IP 的远程服务器),但如果你想让服务端主动保活(罕见的场景),服务端也可以设置。
- 如果还是掉线:除了设置 Keepalive,请检查 QuickQ 的 防火墙 / 流量规则 是否开启了 “FullCone NAT”(全锥型 NAT),在 OpenWrt 中,使用
iptables开启--set-fullcone或启用net.netfilter.nf_conntrack_udp_timeout=30(将 UDP 超时设短)能显著改善稳定性。
进入 QuickQ 的 WireGuard 设置界面,找到对端,将 持久保活 填为 25 并保存即可,这是最直接有效的方法。
版权声明:除非特别标注,否则均为本站原创文章,转载时请以链接形式注明文章出处。