章节索引
升级前最需要弄清的是:网页管理失效后还能从哪里进入设备,以及哪些文件可用于还原。把管理插件、运行内核与规则设置分别处理,能让故障范围更清楚。先用单台终端检查网络,再恢复其他设备的连接。
从 备用管 理通道开始准备
管理界面与负责转发的内核承担不同任务。更换其中一项时,先沿用其余设置,把能恢复的文件保存在电脑上;这样查看异常时,可以对应到刚刚进行的操作。
安装文件的版本、扩展名与系统要求,应到项目发布说明中逐项核对。
先辨认设备采用的包管理方式。IPK 对应 opkg,APK 对应 apk,选择文件时以系统实际支持的格式为依据。
在插件停止的情况下试着访问路由器管理入口,再查看临时目录及可写分区的剩余空间。异地操作若无法接回设备,应等备用通道准备妥当后再安排更新。
# PLUGIN_PACKAGE 与 CONFIG_SECTION 须填入设备中实际使用的名称
df -h /overlay /tmp
if command -v opkg >/dev/null 2>&1; then
opkg list-installed | grep -F -- "$PLUGIN_PACKAGE"
else
apk list --installed | grep -F -- "$PLUGIN_PACKAGE"
fi
uci show "$CONFIG_SECTION"
将备份保存到路由器之外
从管理界面导出配置后,把压缩文件下载到电脑并查看内容。需要手工归档时,另存一份便于检查目录范围的副本,避免只留下无法确认内容的备份文件。
检查设置文件、规则目录、覆写文件和内核是否包含在归档中。含认证信息的配置应妥善保管,公开分享前必须去除私密字段。
# 先将占位路径替换为要保存的实际设置及目录
BACKUP=/tmp/plugin-backup-$(date +%F-%H%M).tgz
set --
for ITEM in path/to/settings-file path/to/config-directory path/to/custom-directory path/to/overwrite-directory path/to/core-directory; do
[ -e "/$ITEM" ] && set -- "$@" "$ITEM"
done
[ "$#" -gt 0 ] || { echo 'No matching files found'; exit 1; }
tar -C / -czf "$BACKUP" "$@"
ls -lh "$BACKUP"
tar -tzf "$BACKUP" | sed -n '1,40p'
安 装管 理组件后先检查菜单
能够列出归档内的文件后,再处理管理插件。保留原内核与规则不动,检查页面是否可用,便于区分界面依赖问题和流量处理问题。
从发布来源核对安装包后,按设备包管理器选择对应示例。示例里的文件名需要改成自己的安装文件,不能把不同系统的安装命令一起运行。
# 安装文件须先从发布来源核对,以下按设备包管理器选择其一
# opkg:把占位路径替换为本机的 IPK 文件
opkg install /path/to/package.ipk
# apk:把占位路径替换为本机的 APK 文件
apk add --force-overwrite --clean-protected --allow-untrusted /path/to/package.apk
刷新管理界面,逐项打开配置列表与版本信息。菜单缺失、页面异常或依赖提示出现时,应先处理管理组件,确认正常后再继续后面的更新。
替换内核前 留 存可 执行副本
手动放置内核文件时,应核对设备处理器类型、文件所在目录与执行权限。文件名称和路径必须符合插件要求,不能仅凭压缩包名称判断是否适配。
使用原配置启动新内核,可以减少额外变量。日志提示 Exec format error 时核对架构,看到 Permission denied 时检查权限;解析错误则应回到配置语法查找原因。
备份命令在更换文件之前使用,权限和版本检查在更换完成之后使用。先确认旧文件已留存,再放入与处理器匹配的文件,任一环节报错就停止后续操作。
# 替换前:将占位路径改为本机内核位置,并留存副本
cp -a /path/to/core-file /path/to/core-file.before-upgrade
# 替换完成后:再分别检查执行权限和版本输出
chmod 0755 /path/to/core-file
/path/to/core-file -v
配置更新的常见疑问
管理界面和内核运行正常后,才检查配置读取及规则加载。保存更新前的文件、错误输出和覆写设置,逐项比较变化,不把模板调整与组件更换混在一起。
列表能显示名称并不代表远端读取成功。遇到权限错误时核对认证与访问条件,遇到解析错误时检查文件内容;反复重装管理插件无法替代这些检查。
为什么读 取请求遭到 拒绝?
先核对访问凭据和授权范围,并暂时沿用原来可用的配置。认证问题需要从访问权限解决。
文件已取得 却无法加载 怎么办?
对照内核能够识别的字段检查 YAML,比较变更内容;文件语法问题应在配置环节处理。
更新后自定义规则去了哪里?
查看 custom 与 overwrite 是否仍被加载,并检查合并先后关系;恢复时使用事先保存的副本。
选定恢复方式后再操作
界面能够使用时,可从配置管理导入先前导出的压缩文件。只有归档内容和原路径均已确认、且需要通过 SSH 处理时,才采用手工解压方式,避免交替执行造成覆盖。
按恢复阶段逐项处理
让插 件停止写入文件
解压前暂停相关进程,防止运行中的配置和缓存继续变化。
在管理页面导入备份
导入完成后检查活动配置路径,确认选中的是准备恢复的文件。
手工恢复前另存 现状
将当前目录留作副本后,再把已检查过的归档还原到对应位置。
检查执行条件再启动
内核文件需要执行权限,设置提交完成后,再启动插件并查看输出。
用单台终端检查恢复结果
分别访问路由器、直连目标和需要代理的目标,核对解析,再接回其他设备。
# 先核对归档内容,并把所有占位路径替换为本机实际位置
BACKUP='/path/to/backup.tgz'
CONFIG_DIR='/path/to/config-directory'
CONFIG_FILE='/path/to/settings-file'
CORE_FILE='/path/to/core-file'
SERVICE='/path/to/service-script'
tar -tzf "$BACKUP" &&
"$SERVICE" stop &&
cp -a "$CONFIG_DIR" "$CONFIG_DIR.failed-$(date +%F-%H%M)" &&
cp -a "$CONFIG_FILE" "$CONFIG_FILE.failed-$(date +%F-%H%M)" &&
tar -C / -xzf "$BACKUP" &&
chmod 0755 "$CORE_FILE" &&
uci commit "$CONFIG_SECTION" &&
"$SERVICE" restart
示例通过条件连接安排执行:某个命令失败时,后面的操作随即停止。解压中断后,先检查已恢复的配置与内核文件是否完整,再决定是否继续,避免直接启动不完整的环境。
按报错所 在组件安排回退
管理菜单 或网页无 法打开
检查界面包、依赖和浏览器缓存;先让管理入口恢复可用。
内核程序不能 运行
找回更换前的副本,重新检查处理器适配情况及执行权限。
所有终端都无法 解析 域名
对照旧配置与旧内核排查解析接管和防火墙的变化,恢复先前可用的组合。
覆写内容没有生效
找到保存的自定义规则与覆写文件,检查加载路径,无须为此覆盖整套路由系统。
异常集中在个别设备
让受影响设备重新连接并获取网络设置,清理遗留解析缓存,再确认其他设备是否也有同样现象。
接回其他设备前逐项确认
- 网页管理、版本信息和配置列表均能正常查看
- 内核版本命令有输出,日志未出现权限或语法错误
- 自定义规则仍在,覆写内容按预期加载
- 从电脑分别检查直连、代理、解析及管理入口
- 手机与影音设备重新取得网络参数后再检查访问
