OpenWrt 升级后代理插件不见了?先分清软件和配置
OpenWrt 升级后,普通上网恢复了,翻墙插件的菜单却不见了,可以先检查插件是否仍然安装,再查看原配置。反复上传配置备份,不一定能把缺少的软件带回来。
本文以 OpenWrt 的常规固件升级为例。第三方固件、代理插件及定制升级方式可能有不同处理,恢复前要核对实际使用的项目说明。
为什么“保留配置”之后,插件仍可能消失?
先分清三样东西:
| 内容 | 可以理解成什么 |
|---|---|
| 软件包 | 插件和相关程序本身 |
| 配置文件 | 程序运行时读取的设置 |
| 软件包清单 | 之前安装过哪些软件的名单 |
OpenWrt 的官方说明指出,用户自行安装的软件包默认不会在普通固件升级中保留下来。保存配置与重新安装这些软件,是需要分别确认的事情。查看官方的软件包保留说明
因此,配置文件可能还在,但读取它的程序已经不在新固件里。具体到某个插件,还要看它是否随新固件预装、是否由其他升级工具重新包含。
同样,保存了软件包清单,只是方便之后核对安装内容。OpenWrt 的升级程序将这项功能明确描述为保存“已安装软件包的列表”,并不是把每个程序都装进配置备份。查看官方升级程序的说明
第一步:先保存现在的状态,确认普通上网
记下软路由型号、升级前后的固件名称与版本,以及原插件名称。保留已有的旧备份,不要用新备份覆盖唯一一份旧文件。
再保存一份当前配置,方便比较。LuCI 的“系统 → 备份/升级”页面提供生成配置归档的入口,名称可能随界面语言变化。官方 LuCI 将这项操作描述为下载当前配置文件的归档。查看 LuCI 备份页面的项目资料
使用一台测试设备打开平时可以直连的普通网站。如果普通上网也失败,先检查管理地址、上游连接和基础网络;此时只测试需要翻墙的网站,无法分清哪一层出了问题。
第二步:查插件的安装状态,别只看菜单
在固件的软件管理或插件提供的状态入口,核对原插件是否安装。菜单入口消失是一个现象,不能直接证明全部配置都已删除。
可以按下面的情况继续:
- 确认软件没有安装: 查原项目是否支持当前固件,再按对应说明安装兼容的软件与依赖。
- 软件显示已安装,但菜单没有出现: 核对网页管理组件及项目的相关故障说明,记录错误。
- 插件页面能打开,但服务不能运行: 先看启动错误,确认实际缺少什么或哪里不兼容。
这里没有一种适合所有插件的安装命令。固件版本、设备架构和软件来源要匹配;不要只因为文件名相似,就把升级前的安装包直接装回去。
页面重新出现,只说明界面这一部分恢复了,还需要继续验证服务和访问。
第三步:再检查配置是否保留、是否适配
程序恢复后,查看原订阅、当前配置、节点与规则是否仍能读取。不要一开始就删除所有配置、重新导入整套内容。
OpenWrt 的备份会按指定文件范围保存内容,不能默认认为某个代理插件的所有额外文件都在里面。LuCI 提供“查看当前备份文件列表”的功能,可以核对实际包含哪些文件。查看备份文件列表的项目说明
如果配置缺失,先对照旧备份和插件自己的导出文件,再按插件文档恢复必要部分。如果文件存在但加载报错,则查看新版本的兼容或迁移说明。
上传整份旧系统配置前,还要确认它适用于当前设备和升级路径。LuCI 的恢复提示说明,恢复后可能重启;若 LAN 地址被旧配置改变,管理连接也可能需要重新建立。LAN 就是家中设备连接软路由的一侧。
所以,仅为了找回代理设置时,应先检查插件提供的恢复方式,避免把已经恢复正常的网络设置一起改回去。
第四步:确认服务运行,再测试真正需要的访问
保持同一台测试设备,分别检查:
- 普通网页能否打开。
- 插件能否加载配置,日志是否仍有错误。
- 当前节点是否可以完成目标网页或应用的访问。
- 有开机自启需求时,按插件文档核对相应状态。
每次只恢复一部分,恢复后重新发起访问。别只看“运行中”或节点旁的延迟数字,就当作翻墙功能已经恢复。
求助时提供固件与插件版本、安装状态、配置加载结果和经过遮挡的错误信息。订阅链接、节点密码、宽带账号和备份文件中的凭据不要公开。
下次升级前,准备什么更容易恢复?
可以把这些资料放在自己妥善保管的位置:
- 带日期的系统配置备份。
- 实际备份文件列表,以及插件要求另存的配置或文件。
- 软件包清单、插件名称与版本、原始项目链接。
- 当前接线、管理地址和能够恢复普通上网的设置记录。
如果准备使用 Attended Sysupgrade,也就是按软件包清单构建新固件的定制升级方式,先核对它能生成的固件与软件包结果。OpenWrt 的 ASU 项目说明了请求包含所选软件包的固件这一机制。查看官方定制升级项目
这与单纯下载普通固件升级不同,也不能仅凭工具名称就认定所有第三方代理插件一定会被包含。
把“程序在不在”和“配置能不能用”分开检查,升级后的恢复过程会清楚很多。先保住基础联网,再恢复代理软件和必要配置,最后验证实际访问。
资料核对日期:2026 年 10 月 14 日。
评论