要保存的不只是正在使用的 YAML

准备更新插件、调整规则,或者担心以后找不到原来的设置时,最容易想到的是下载当前 YAML。但 YAML 只是配置的一部分:订阅更新设置、插件选项和自定义文件不一定都在这一份文件里。如果想保留 OpenClash 当前的配置资料,应先弄清自己下载的是单个配置,还是插件提供的完整备份。

本文核对的是OpenClash v0.47.156 的官方源码和发布说明,操作入口采用简体中文 LuCI 界面,并附英文标签。它是仍在维护的 OpenWrt 插件,不是 Windows 上的 Clash Verge Rev,也不是 Clash for Windows。前提是你已经能正常登录路由器管理页面并打开该版本插件;本文不安装固件或内核,不承诺所有 OpenWrt 衍生固件都显示相同布局。

下载动作本身不需要选择 CPU 架构,但备份里可能带有与原设备架构相关的内核。请记录路由器型号、固件版本、CPU 架构和 OpenClash 版本,后续不能把这份文件当作跨设备通用安装包。以下只完成下载和本地检查,不执行上传恢复。

在「配置管理」里点击「备份」

先结束正在编辑的设置,等订阅更新或其他修改完成,再开始备份。备份读取的是当时磁盘上的文件,不是编辑框里尚未保存的草稿,也不是保证所有文件处于同一瞬间的系统快照。不要在下载期间同时升级插件或改写配置。

  1. 登录你自己的路由器 LuCI,在「服务 → OpenClash」中打开「配置管理」(Config Manage)。
  2. 找到文件操作区域的「备份」(Backup)按钮。此时不需要选择本地文件,也不需要改动「上传文件类型」。
  3. 点击一次「备份」,等待浏览器完成下载;保存位置由浏览器设置决定,不能只看按钮恢复可点击就认定文件完整。
  4. 在电脑上确认下载的是 .tar.gz 文件,保留原始副本;若浏览器询问保存位置,选一个不对外共享的文件夹。

「上传」不是备份的下一步:本版备份按钮直接请求完整备份;旁边的「上传文件类型」和「上传」用于把文件送回路由器。不要为了下载备份先选择「备份文件」再点上传。

正常响应的文件名以 Backup-OpenClash- 开头,后面包含设备名称、系统报告的架构和时间,最后是 .tar.gz。时间取自路由器时钟;前端无法取得响应文件名时还可能使用 Backup-OpenClash.tar.gz。因此文件名可以帮助归档,但不能单凭它判断备份生成时间准确或内容完整。

完整备份具体包含哪些内容?

该版本的完整备份逻辑是:把 /etc/config/openclash 复制为 /etc/openclash/openclash,再归档 /etc/openclash/ 当时的内容,输出后删除这个临时副本。你在压缩包里看到的路径通常从 ./ 开始,而不是完整的 /etc/openclash/。

归档内的条目检查什么不要误解为
./openclash是否有复制进来的插件 UCI 设置文件它是另一个代理内核可执行文件
./config/是否有你预期保留的 YAML 文件名仅有该目录就等于保留了全部插件设置
./custom/、./overwrite/、./proxy_provider/、./rule_provider/核对自己实际使用的自定义文件和提供者资料每台设备都必须有相同数量和内容的文件
./core/ 及数据文件区分普通文件和指向其他位置的符号链接看到名称就代表实际内核和数据已打包完整

上表是检查范围,不是每台设备都必须一致的目录模板。不同使用方式会留下不同内容;这不是整机备份,不会因此保存 OpenWrt 的 /etc/config/network、/etc/config/firewall 等系统配置。它不能替代 OpenWrt 的系统备份。

小闪存模式需要单独判断:部分内核或数据会放到 /tmp/etc/openclash,原目录可能只是符号链接。备份里有名称,不等于包含链接指向的实际数据;不能据此承诺断网后可直接恢复运行。本文不要求关闭小闪存模式,也不改变现有存储路径。

在电脑上检查,不要把恢复当作验包

用可信的本地归档查看工具打开自己刚下载的文件,先浏览内容列表,不运行其中的程序。某些工具会先显示外层 gzip,再显示里面的 tar;这不一定是异常。核对 ./openclash 和预期的 ./config/ 文件,并查看是否有无法读取、意外结束或损坏提示。

  • 只有一个 YAML:这通常不是本文的完整插件备份。回到「配置管理」确认使用了「备份」按钮,不要仅把文件后缀改成 .tar.gz。
  • 下载的是网页或登录内容:重新确认 LuCI 登录状态和管理地址,再下载一次。登录超时返回的页面不能作为备份。
  • 归档损坏或缺少预期文件:保留先前可读副本,不覆盖唯一备份;等正在进行的配置修改结束后重新下载,仍异常则停止后续升级或恢复。
  • 大小和别人不同:内核、规则集和设备存储方式都会影响大小,没有一个通用的“正常 MB 数”。大小正常也不能证明内容可恢复。

能打开目录列表只是第一道检查,不等于 YAML 语法正确、订阅仍有效、节点可连接或恢复已经成功。v0.47.156 的备份数据通过管道输出,不先在 /tmp 生成整份压缩包,但会临时复制插件设置;这并不意味着完全不写盘、不占内存,或空间不足时一定不会出问题。

保存好这一份,后续修改才有参考

给备份配一条简短记录:设备型号、固件和插件版本、架构、保存日期,以及当时是否启用了小闪存模式。保留一份未经改写的原文件,放在你控制的私有存储中;不要只留在即将重装的路由器里。新文件检查通过前,不覆盖以前的可用副本。

备份可能等同于账户资料:配置和插件设置可能包含订阅 Token、节点密码或控制器密钥。不要把完整归档上传到在线解压网站、公开网盘、群聊或 GitHub Issue。排障时只提供脱敏后的错误信息及必要片段。

以后若需要恢复,应先另存当时的当前配置,核对设备、架构和版本边界,并准备重新安装对应插件或取回已知可用配置的办法。官方上传恢复会写回插件文件和设置,不是只读预览,也不是保证逐字节还原所有旧文件的系统回滚。本文不提供跨设备、跨版本直接覆盖的步骤。

做到这里,目标就是手里有一份来源明确、内容能读取、范围已知的备份。下载和检查本身不要求切换代理模式、更新内核或上传任何文件;不用为了证明备份存在,立刻在正在使用的路由器上做一次覆盖恢复。

官方来源与版本边界

版本号、文件名和界面文字可能随项目更新而变化,操作前请以链接中的项目文档为准。