升级 FlClash 0.8.97 前,把旧版导出的完整 ZIP 存到应用之外,保留原安装包。装好后先看配置是否还在,再开连接。新版改了界面和服务层,出现启动异常时,删除订阅重导可能只会弄丢本地修改。

0.8.97 改了什么,为什么要留旧备份?

9 月 10 日正式版公告列出 UI 与翻译更新、Android VPN 服务及生命周期重构、桌面新增 Helper 服务与 Rust bridge,以及核心 IPC 和进程生命周期重构。代理认证也在更新项中。公告没有承诺所有旧配置无损迁移,也没有给出性能提升数字。

这里依据固定版本源码整理操作,未安装测试各系统,也未核定所打包的 Mihomo 内核版本。对象是已有 Clash YAML 配置的 Android、Windows、macOS、Linux 用户;不能将下列步骤理解为各系统版本的兼容认证。

本地 ZIP 里究竟备份了什么?

官方 README列明 WebDAV 同步支持,这不是此次新增。升级前优先留一份本地文件,避免恢复时还依赖远程连接。

在旧版找到“备份与恢复”,导出本地备份并完成文件保存。旧界面布局可能不同;0.8.97 从工具页面的“设置”分组进入“备份与恢复”,备份页面实现明确包含“本地”下的“备份”“恢复”。保存后用文件管理器查看 ZIP 确实存在,复制到应用目录之外,并在文件名注明原客户端版本。导出的 ZIP 位于你在保存窗口选定的位置,并非固定存到安装目录。不要只停留在文件选择框:取消保存不等于完成备份。ZIP 可能带有订阅地址与账户配置,保存到自己的磁盘或受控存储,不要作为问题附件公开上传。

备份实现会打包配置 JSON、数据库,以及数据库登记的配置和脚本文件。下面是新版归档涉及的路径示意,不是让你手工拼装备份:

config.json
database.sqlite
profiles/<配置文件名>.yaml
scripts/<脚本文件名>.js

因此,只复制一个 YAML 会漏掉应用状态;复制程序安装目录也不等于备份。源码通过系统的应用支持目录定位数据,不能假定 Windows ZIP 包旁边就是所有配置。额外保存当前配置名称、策略组选择与覆写内容,可帮助辨别首次启动后到底丢了哪一项。

保持安装渠道,避免把升级变成全新安装

停止连接并退出旧版,包括桌面托盘进程。从正式版 Release 选对应系统与 CPU 架构。Android 提供 arm64-v8a、armeabi-v7a、x86_64;Windows 有 amd64 与 arm64 的安装版和 ZIP,macOS 分 Intel 与 Apple Silicon。

原来用安装器,就继续使用对应安装器;原来由软件包管理器维护,就保留该管理方式。Android 若提示签名不匹配,不要直接卸载换包,先核对原下载渠道。官方同时提供 GitHub 与 F-Droid 入口,不应自行推断渠道之间签名相同。

首次打开后,对照旧记录看配置数量、脚本、覆写和 DNS 设置。数据齐全就直接进入连接检查,不必为了“迁移完整”再恢复一次。遇到初始化错误,也不要立即清空应用数据;备份尚未验证时,清空会失去原始恢复材料。

“仅恢复配置文件”与“恢复所有数据”怎么选?

确实缺数据时,进入“工具 → 备份与恢复”。先看“选项”中的“恢复策略”,确认使用“兼容”还是“覆盖”,尤其不要在刚新增了配置的客户端上随手覆盖。再点“本地 → 恢复”:先选“仅恢复配置文件”或“恢复所有数据”,随后才在文件选择器中选自己的 ZIP。

恢复动作源码中,“仅恢复配置文件”仍恢复配置、脚本、规则及关联等数据库内容,但跳过应用设置,包括全局覆写、DNS 覆盖开关和当前选中的配置。仅恢复后,应手动选中要用的配置,并检查全局 DNS 与覆写是否仍符合需要。“恢复所有数据”才继续恢复这些设置及主题、窗口、VPN、网络等偏好。换设备通常不需要把原设备的所有偏好一并带来;同机完整恢复则要与原记录逐项比较。

迁移代码存在旧数据转换分支,备份读取也识别旧版本。它说明开发者处理了迁移,不代表任何年代、损坏或手工改过的备份都能恢复。

配置还在却连不上,该查服务还是再恢复?

用原配置、原连接模式启动,先区分下面几种表现。新界面能打开,仅说明应用窗口工作;配置恢复成功也不能替代系统授权。

升级后表现更可能涉及哪层接下来的动作
配置、脚本或覆写缺失数据迁移或恢复选项与升级前记录比较,按缺失范围恢复
Android 配置齐全但无法启动 VPNVPN 服务或系统授权查看系统 VPN 提示与客户端启动错误
桌面出现 Helper 启动错误服务组件、权限或安装位置核对新版完整安装包及错误内容
能连接但单个规则集失败远程资源或规则配置转入规则集更新排错,不再覆盖数据

Android 本次重构了服务生命周期,可在连接后切到后台再返回,查看 VPN 是否仍运行。桌面则检查原来的系统代理或 TUN 模式能否启动。不要把旧目录中的 Helper、核心程序单独复制到新包:本次同时改了服务桥接与核心 IPC,官方没有提供混用组件的兼容承诺。

若只有导入列表为空,接着看配置导入为空排查;只坏一个远程规则集,转到Rule Provider 更新失败。提交日志前按配置秘密信息脱敏方法隐藏订阅凭据。核对完成后另存新版备份,升级前的 ZIP 继续保留;需要回退时,用原安装包配原备份,不让旧版直接接管已迁移的数据。