NetKeeperPlus

面向 X-Wrt 的浙江电信闪讯拨号、短信取号与双线路自动回退插件

简体中文 | English

功能

• 通过 PPPoE 完成闪讯 NetKeeper 拨号，并按浙江电信规则生成动态用户名。
• wan / wan6 作为主线路，usbwan / usbwan6 作为 5G 备用线路。
• 基于 mwan3 的线路健康检测、快速回退、自动恢复与 WAN 自动重拨。
• PPP 认证失败时，通过 5G 模块发送 MM 并从回复短信更新账号和动态密码。
• 在动态密码到期前 5 分钟自动取号并重拨 WAN。
• 中文 LuCI 状态与统计面板，支持手动重连和手动发送短信取号。
• 网络配置应用前自动备份，失败时自动回滚。

工作方式

线路	接口	角色	默认优先级
校园网 IPv4	wan	NetKeeper PPPoE 主线路	高
校园网 IPv6	wan6	基于 PPP 接口的 DHCPv6 主线路	高
5G IPv4	usbwan	故障回退线路	低
5G IPv6	usbwan6	IPv6 故障回退线路	低

健康检测会分别绑定主、备出口探测公网地址。WAN 无法访问公网时，mwan3 将新连接切换到 USBWAN；NetKeeperPlus 同时重拨 WAN，恢复稳定后再将新连接切回主线路。拨号仍在进行时不会被健康检测误判并反复重启。

短信恢复仅在 PPP 明确返回认证失败时触发。普通断线、探测失败或 IPv6 降级不会发送短信，以免产生重复请求。

兼容性

项目	要求
固件	X-Wrt 26.04，已在 ramips/mt7620 上验证
包管理器	opkg
拨号	PPPoE、PAP
多线路	mwan3plus
5G 模块接口	兼容 UDX710-UOOLS 的 Web API

软件包为 all 架构，不包含平台相关二进制文件。其他 OpenWrt 分支可能可以运行，但尚未验证。

安装

从本仓库构建两个 IPK 后上传到路由器，并按顺序安装：

opkg install ./netkeeperplus_0.1.0-6_all.ipk
opkg install ./luci-app-netkeeperplus_0.1.0-6_all.ipk

安装完成后打开 LuCI：网络 -> NetKeeperPlus。

安装软件包不会自动修改现有 WAN。确认校园网线和 5G 模块均已连接后，在 SSH 中应用主备配置：

netkeeperplusctl configure apply

该命令会重启网络服务，连接会短暂中断。应用前的 network、mwan3 和 firewall 配置保存在 /etc/netkeeperplus/backups/。

配置

在 LuCI 中至少填写：

• 闪讯账号，例如 手机号@YD.XY。
• 当前动态密码。
• 短信中的账号手机号。
• 5G 模块地址和管理密码。

默认开启认证失败自动取号、到期前 300 秒续期和线路健康检测。短信发送方、短信 ID、有效期、账号手机号和重复内容都会被校验，并带有冷却时间与小时配额限制。

常用命令

# 使用当前配置重新拨号，不发送短信
netkeeperplusctl reconnect

# 立即发送 MM、等待新短信并重拨 WAN
netkeeperplusctl refresh --force

# 应用 WAN/USBWAN 主备网络配置
netkeeperplusctl configure apply

# 回滚最近一次网络配置
netkeeperplusctl configure rollback

构建与测试

Windows PowerShell：

.\scripts\New-Ipk.ps1
.\tests\Test-NetkeeperVectors.ps1
.\scripts\Test-New-Ipk-VersionValidation.ps1
.\scripts\Test-Ipk.ps1 -IpkPath .\dist\netkeeperplus_0.1.0-6_all.ipk -ExpectedPackage netkeeperplus -ExpectedVersion 0.1.0-6
.\scripts\Test-Ipk.ps1 -IpkPath .\dist\luci-app-netkeeperplus_0.1.0-6_all.ipk -ExpectedPackage luci-app-netkeeperplus -ExpectedVersion 0.1.0-6
.\scripts\Test-Ipk-PayloadValidation.ps1

构建产物位于 dist/，同时生成 SHA-256 校验文件。生成器使用隔离临时目录、稳定时间戳和确定性归档，需要系统提供 tar.exe。

项目结构

package/netkeeperplus/           核心拨号、短信恢复、健康检测与配置工具
package/luci-app-netkeeperplus/  中文 LuCI 页面与权限声明
scripts/                         IPK 构建和包内容校验
tests/                           NetKeeper 动态用户名测试向量

安全说明

• 账号和动态密码仅保存在路由器本地 UCI 配置中，不写入 network 配置。
• 状态文件和备份目录限制为 root 访问，LuCI 仅获得所需的最小权限。
• 日志不会输出明文动态密码，发布问题日志前仍应检查并隐藏账号、手机号和公网地址。
• 本项目不会绕过运营商认证，仅自动化合法账号的标准 PPPoE 登录与密码获取流程。

项目地址

https://github.com/LaokeQwQ/NetKeeperPlus