行走与记述

OpenWrt 升级后代理插件不见了?先分清软件和配置

OpenWrt 升级后,普通上网恢复了,翻墙插件的菜单却不见了,可以先检查插件是否仍然安装,再查看原配置。反复上传配置备份,不一定能把缺少的软件带回来。

本文以 OpenWrt 的常规固件升级为例。第三方固件、代理插件及定制升级方式可能有不同处理,恢复前要核对实际使用的项目说明。

为什么“保留配置”之后,插件仍可能消失?

先分清三样东西:

内容 可以理解成什么
软件包 插件和相关程序本身
配置文件 程序运行时读取的设置
软件包清单 之前安装过哪些软件的名单

OpenWrt 的官方说明指出,用户自行安装的软件包默认不会在普通固件升级中保留下来。保存配置与重新安装这些软件,是需要分别确认的事情。查看官方的软件包保留说明

因此,配置文件可能还在,但读取它的程序已经不在新固件里。具体到某个插件,还要看它是否随新固件预装、是否由其他升级工具重新包含。

同样,保存了软件包清单,只是方便之后核对安装内容。OpenWrt 的升级程序将这项功能明确描述为保存“已安装软件包的列表”,并不是把每个程序都装进配置备份。查看官方升级程序的说明

第一步:先保存现在的状态,确认普通上网

记下软路由型号、升级前后的固件名称与版本,以及原插件名称。保留已有的旧备份,不要用新备份覆盖唯一一份旧文件。

再保存一份当前配置,方便比较。LuCI 的“系统 → 备份/升级”页面提供生成配置归档的入口,名称可能随界面语言变化。官方 LuCI 将这项操作描述为下载当前配置文件的归档。查看 LuCI 备份页面的项目资料

使用一台测试设备打开平时可以直连的普通网站。如果普通上网也失败,先检查管理地址、上游连接和基础网络;此时只测试需要翻墙的网站,无法分清哪一层出了问题。

第二步:查插件的安装状态,别只看菜单

在固件的软件管理或插件提供的状态入口,核对原插件是否安装。菜单入口消失是一个现象,不能直接证明全部配置都已删除。

可以按下面的情况继续:

  • 确认软件没有安装: 查原项目是否支持当前固件,再按对应说明安装兼容的软件与依赖。
  • 软件显示已安装,但菜单没有出现: 核对网页管理组件及项目的相关故障说明,记录错误。
  • 插件页面能打开,但服务不能运行: 先看启动错误,确认实际缺少什么或哪里不兼容。

这里没有一种适合所有插件的安装命令。固件版本、设备架构和软件来源要匹配;不要只因为文件名相似,就把升级前的安装包直接装回去。

页面重新出现,只说明界面这一部分恢复了,还需要继续验证服务和访问。

第三步:再检查配置是否保留、是否适配

程序恢复后,查看原订阅、当前配置、节点与规则是否仍能读取。不要一开始就删除所有配置、重新导入整套内容。

OpenWrt 的备份会按指定文件范围保存内容,不能默认认为某个代理插件的所有额外文件都在里面。LuCI 提供“查看当前备份文件列表”的功能,可以核对实际包含哪些文件。查看备份文件列表的项目说明

如果配置缺失,先对照旧备份和插件自己的导出文件,再按插件文档恢复必要部分。如果文件存在但加载报错,则查看新版本的兼容或迁移说明。

上传整份旧系统配置前,还要确认它适用于当前设备和升级路径。LuCI 的恢复提示说明,恢复后可能重启;若 LAN 地址被旧配置改变,管理连接也可能需要重新建立。LAN 就是家中设备连接软路由的一侧。

所以,仅为了找回代理设置时,应先检查插件提供的恢复方式,避免把已经恢复正常的网络设置一起改回去。

第四步:确认服务运行,再测试真正需要的访问

保持同一台测试设备,分别检查:

  1. 普通网页能否打开。
  2. 插件能否加载配置,日志是否仍有错误。
  3. 当前节点是否可以完成目标网页或应用的访问。
  4. 有开机自启需求时,按插件文档核对相应状态。

每次只恢复一部分,恢复后重新发起访问。别只看“运行中”或节点旁的延迟数字,就当作翻墙功能已经恢复。

求助时提供固件与插件版本、安装状态、配置加载结果和经过遮挡的错误信息。订阅链接、节点密码、宽带账号和备份文件中的凭据不要公开。

下次升级前,准备什么更容易恢复?

可以把这些资料放在自己妥善保管的位置:

  • 带日期的系统配置备份。
  • 实际备份文件列表,以及插件要求另存的配置或文件。
  • 软件包清单、插件名称与版本、原始项目链接。
  • 当前接线、管理地址和能够恢复普通上网的设置记录。

如果准备使用 Attended Sysupgrade,也就是按软件包清单构建新固件的定制升级方式,先核对它能生成的固件与软件包结果。OpenWrt 的 ASU 项目说明了请求包含所选软件包的固件这一机制。查看官方定制升级项目

这与单纯下载普通固件升级不同,也不能仅凭工具名称就认定所有第三方代理插件一定会被包含。

把“程序在不在”和“配置能不能用”分开检查,升级后的恢复过程会清楚很多。先保住基础联网,再恢复代理软件和必要配置,最后验证实际访问。

资料核对日期:2026 年 10 月 14 日。

评论

搜索文章

正在加载搜索…