Clash Verge Rev 升级安装保留配置文件说明

点了一下“检查更新”，装完新版本打开，订阅列表空了，节点全没了。这种情况在 Clash Verge Rev 的升级过程中并不罕见，但绝大多数时候不是软件把配置删了，而是配置目录变了、服务模式冲突，或者升级方式不对。只要提前把配置备份好、理解不同升级方式的行为差异，Clash Verge Rev 升级保留配置这件事完全可以做到零风险。这篇教程按“先备份 → 再升级 → 后验证”的顺序展开，每一步都有具体操作路径。

01. 升级前必须做的三件事

不管你是从旧版本升级到 v2.5.2，还是从 1.x 时代的老版本迁移，升级前的准备动作都是相同的。花五分钟做完，能省掉后面一小时的排查。

第一件事：找到当前配置目录。打开 Clash Verge Rev，进入左侧菜单“设置”，在“Verge 高级设置”区域找到“配置目录”按钮，点击后系统会打开文件管理器，这就是软件实际使用的配置目录。Windows 安装版通常位于 C:\Users\用户名\.config\clash-verge\，便携版则在程序目录下的 .config 文件夹内。不同版本或安装方式的路径可能略有差异，以应用内实际打开的路径为准。

第二件事：手动复制整个配置目录。不要只依赖软件内置的备份按钮。把“配置目录”里看到的所有文件和文件夹完整复制一份，存到桌面或 D 盘等非系统盘位置。这里面包含 profiles 子目录（存放所有订阅 YAML 文件）、verge.yaml（主配置文件，记录端口、TUN 设置、主题等）以及 rules 目录。这些文件加起来可能只有几十 MB，但对恢复来说每一份都关键。社区用户的经验也印证了这一点：“这种大更新我都是先把配置备份出来，然后完全卸载删除所有配置，免得出怪问题”。

第三件事：记下订阅链接。打开“订阅”页面，把每个订阅的 URL 复制出来存到记事本。如果你的配置目录里有本地文件订阅而非远程 URL，确认对应的 YAML 文件已经在备份里。

02. 自动更新：最省事但需注意服务模式

Clash Verge Rev 安装版支持应用内自动更新。当新版本可用时，界面会提示，点击即可下载并安装。这种升级方式对配置文件是安全的——软件更新时只替换程序文件，配置目录不在更新范围内。

但有一个例外需要注意。从 v2.4.5 版本开始，macOS 和 Linux 对服务 IPC 权限做了进一步限制，引入了一个破坏性变更：需要先在旧版本卸载 TUN 服务，再安装新版本的服务。如果你在旧版本里开启了 TUN 模式并安装了服务，直接点击自动更新，新版本的服务组件可能因为权限冲突而无法启动，表现为 TUN 模式开关打开后系统代理不生效，或者弹出服务安装失败的报错。

正确的处理方式是在点击更新之前，先做一步服务卸载。Windows 用户打开软件安装目录，进入 resources 文件夹，找到 uninstall-service.exe，右键以管理员身份运行。macOS 用户在终端执行：

sudo "/Applications/Clash Verge.app/Contents/Resources/resources/clash-verge-service-uninstall"

卸载服务后，再点击应用内的更新按钮。更新完成后重新打开 TUN 模式开关，软件会自动安装适配新版本的服务。

03. 覆盖安装与彻底重装的选择

如果你不通过应用内更新，而是手动下载新版本安装包来升级，有两种路径。

覆盖安装是直接把新版 x64-setup.exe 双击运行，安装程序会替换旧版本的程序文件，但保留配置目录不变。部分 pre-release 版本已经修复了覆盖安装时保留配置的行为，社区反馈“直接覆盖安装的不用卸载老版本”。这种方式最适合从 v2.x 的小版本升级，比如 v2.5.1 到 v2.5.2。

彻底重装则是先卸载旧版本，再安装新版本。官方在多个版本的 Release Notes 中推荐过这种方式，尤其是从 1.x 升级到 2.x、或者跨越大版本号升级时。卸载时有一个关键选择：Windows 的卸载程序会询问是否删除用户配置。不要勾选“删除用户配置”。只要保留这个选项不被选中，配置目录会原封不动地留在 %APPDATA%\io.github.clash-verge-rev.clash-verge-rev，新版本安装后会自动加载这个目录，恢复你之前导入的所有订阅和设置。

如果你已经不小心删了配置目录，回退办法是从第 01 节的手动备份里把文件拷回去，或者用软件内置的配置还原功能导入之前导出的备份包。

04. 升级后配置丢失的排查与恢复

升级完成打开软件，发现订阅还在但节点没了，或者整个代理页面空白。先别急着卸载重装，按下面的顺序排查。

检查配置目录是否变化。进入“设置 → 配置目录”，看看打开的路径和升级前是否一致。如果路径变了，把之前备份的 profiles 文件夹和 verge.yaml 拷贝到新路径下，重启软件。

检查服务模式状态。如果配置看起来正常但 TUN 模式不工作，进入“设置”，找到 TUN 模式旁边的盾牌图标，点击重新安装服务。如果报错，先手动卸载旧服务（方法见第 02 节），再重新点击安装。

检查配置文件是否损坏。打开配置目录下的 clash-verge-check.yaml，如果里面有语法错误或重复的代理名称，内核会拒绝加载配置，导致代理页面空白。日志里可能出现类似 proxy [节点名] is the duplicate name 的报错。这种情况下，从备份里恢复 profiles 目录下的对应 YAML 文件即可。

使用内置备份恢复。Clash Verge Rev 的“备份设置”页面提供了本地备份和恢复功能。如果你在升级前用过“手动备份 → 本地备份”，可以直接在“查看记录”里选择最近的备份进行恢复。恢复过程会自动覆盖当前配置目录，操作前确认你愿意接受这个覆盖。

05. 长期维护的配置管理建议

升级一次排查一次，不如把配置管理做成习惯。

每次升级前都做手动目录备份。软件内置的备份功能虽然方便，但社区反馈显示“升级前不要只依赖客户端自己的备份按钮”，手工复制配置目录是更稳妥的兜底方案。把备份按日期命名，比如 clash-config-backup-2026-09-18，保留最近三份即可。

定期导出订阅链接。配置目录里的 profiles 文件夹保存的是订阅解析后的 YAML 文件，但如果订阅本身更新了节点，你恢复的只是旧快照。把订阅 URL 单独存一份，恢复后重新更新订阅，能拿到最新节点。

如果使用 WebDAV 备份，注意官方说明中提到的限制：WebDAV 备份暂不支持跨平台配置同步，仅适合同一平台内的备份恢复场景。

更多关于配置导入、订阅管理和 TUN 模式使用的操作，可以参考 Clash Verge Rev 使用教程；如果需要了解配置文件的备份与云端同步方案，WebDAV 配置备份指南中有完整的操作流程。