Clash Verge Rev配置文件怎么备份和恢复?ZIP、目录迁移与回滚步骤
简答:如果你正准备重装、换电脑或担心配置丢失,最快做法是:客户端能打开就创建内置本地备份并导出 ZIP;客户端打不开就退出程序后复制整个应用数据目录;真正恢复时先保留目标目录快照,再导入 ZIP 或覆盖目录,最后逐项检查配置、规则、系统代理、TUN、DNS、端口和连接日志。菜单名称可能随版本变化,以当前界面为准。
定义:Clash Verge Rev 配置备份,是对应用数据目录及内置 ZIP 备份进行保存,用于迁移或回滚;它不等于只复制一个 YAML 文件,也不自动迁移目标系统的服务权限和本地路径。
先看速查卡:能打开用 ZIP,打不开复制整个目录
重装、换电脑或配置突然消失时,不要先删除原目录。先按下面的路径选择方案:
| 当前情况 | 优先做法 | 关键提醒 |
|---|---|---|
| 客户端可以正常打开 | 在设置中的“备份设置”创建本地备份,再使用“导出备份”保存 ZIP | 导出到应用数据目录之外 |
| 客户端打不开或配置异常 | 完全退出程序后复制整个应用数据目录 | 不要只复制一个 YAML 文件 |
| 准备恢复到新环境 | 先启动一次并退出,生成目标目录,再保留目标目录快照 | 新设备的 TUN、服务模式和权限仍需重新检查 |
| ZIP 已导入 | 选中备份记录后继续点击“恢复” | 导入不等于已经写回当前配置 |
当前项目语言文件列出了“备份设置”“本地备份”“WebDAV 备份”“导出备份”“导入备份”“恢复”和“查看记录”等入口;这些是开发分支文案,实际菜单名称和位置以当前版本界面为准,可参考项目中文设置文案。
本文是第三方使用指南,不是该客户端的官方页面。本文核对日期:2026-11-14。
内置 ZIP 怎么创建、导出和恢复:不要把“导入”当成“恢复”
- 创建备份:打开客户端设置,找到“Verge 高级设置”或类似的备份区域,进入“备份设置”,选择“本地备份”并点击“备份”。预期结果是出现本地备份成功提示,并在备份记录中看到新文件。
- 导出到外部位置:选中新生成的备份,点击“导出”或“导出备份”,将 ZIP 保存到桌面、移动硬盘或其他不在应用数据目录中的位置。这样可以降低清理应用目录时连备份一起删除的风险。
- 换机或重装前:同时记下当前配置名称、订阅来源和自定义覆写规则;不要公开上传 ZIP,因为配置目录可能包含订阅链接、个人令牌、节点地址、端口、密码或 UUID。项目隐私说明明确列出了这些敏感信息,见项目隐私说明。
- 目标环境先启动一次:在新电脑或重装后的系统中启动客户端一次,然后完全退出,包括托盘进程、核心和可能运行的服务。这样做是为了生成目标应用数据目录,方便确认路径并保留回滚点。
- 导入 ZIP:打开备份设置,点击“导入备份”,选择外部 ZIP。预期结果是备份列表出现新的记录。项目源码显示导入只会检查 ZIP 文件并复制到本地备份目录,不会立即替换正在使用的配置,具体逻辑见项目 backup.rs。
- 执行恢复:选中刚导入的记录,点击“恢复”,确认覆盖提示。当前开发分支中文文案为“恢复成功,应用将在 1 秒后重启”,这是开发分支界面文案,实际重启时间和提示以当前版本为准。
如果出现“本地备份导入失败”或英文类似 Failed to import local backup,先检查文件是否为 .zip、路径是否可读、文件是否已经存在于本地备份目录。项目源码明确限制导入文件扩展名为 ZIP,并会拒绝同名备份。
备份范围怎么判断:profiles.yaml、profiles/、verge.yaml 分工不同
项目当前隐私说明将应用数据放在一个平台相关目录中,常见位置如下;如果客户端界面提供“打开应用目录”,应优先以界面显示的实际路径为准:
| 平台 | 常见应用数据目录 | 目录中的主要内容 |
|---|---|---|
| Windows | %APPDATA%\io.github.clash-verge-rev.clash-verge-rev | 应用设置、配置档案、订阅、日志和核心运行资料 |
| macOS | ~/Library/Application Support/io.github.clash-verge-rev.clash-verge-rev | 同上,路径大小写和空格要保留 |
| Linux | ${XDG_DATA_HOME:-$HOME/.local/share}/io.github.clash-verge-rev.clash-verge-rev | 若设置了 XDG_DATA_HOME,应以该变量解析出的路径为准 |
| 文件或目录 | 通常记录的内容 | 备份建议 |
|---|---|---|
profiles.yaml | 配置档案索引、档案关系和当前配置引用 | 不要只复制某一个订阅 YAML,整个目录更稳妥 |
profiles/ | 下载或缓存的订阅内容,以及被配置引用的相关档案、覆写或脚本文件 | 有自定义覆写或脚本时必须整体保存 |
verge.yaml | 应用级设置;项目隐私说明指出,WebDAV 地址、用户名和密码可能以明文保存 | 不要把原文件或原始 ZIP 发到公开位置 |
config.yaml | 核心或应用使用的配置内容 | 恢复后重新检查规则模式、DNS、端口和代理状态 |
logs/、service-logs/ | 应用日志、服务日志和可能包含域名、IP 或连接元数据的核心日志 | 排障分享前先脱敏 |
| 核心运行文件 | 例如核心缓存和 GeoIP、GeoSite 数据库 | 内置 ZIP 的具体打包清单仍应以当前版本实际 ZIP 内容核对 |
项目目录源码定义了应用数据目录、config.yaml、verge.yaml、profiles.yaml、profiles/、日志目录和本地备份目录,可参考项目 dirs.rs。项目隐私说明则明确说明,应用配置、订阅资料、日志及核心运行资料都保存在本机,除非用户主动启用 WebDAV、导出备份或提交文件。
客户端打不开时的手动备份与恢复命令
以下命令必须在同一个终端会话中连续执行。关闭终端后重新打开,必须重新定义变量。执行覆盖或删除前,先打印变量并检查路径,确认不是空路径或错误目录。
Windows PowerShell 5.1/7
- 完全退出客户端后执行:
$src = Join-Path $env:APPDATA 'io.github.clash-verge-rev.clash-verge-rev'; $dst = 'D:\Backups\clash-verge-rev-2026-11-14'; Write-Host $src; Write-Host $dst; Test-Path -LiteralPath $src。预期源目录返回True;若为False,先从客户端或安装资料确认实际应用目录。 - 备份目录内容而不是外层文件夹:
New-Item -ItemType Directory -Path $dst -Force | Out-Null; robocopy $src $dst /E。预期在D:\Backups\clash-verge-rev-2026-11-14直接看到verge.yaml、profiles.yaml、profiles等内容。robocopy返回 0 至 7 通常表示复制完成或存在可接受差异;8 或更高表示有复制失败。 - 恢复前保留回滚点:
Rename-Item -Path $src -NewName 'io.github.clash-verge-rev.clash-verge-rev.before-restore',然后执行:New-Item -ItemType Directory -Path (Split-Path -Parent $src) -Force | Out-Null; robocopy $dst $src /E。 - 撤销恢复前强制核对:
Write-Host $src; Test-Path -LiteralPath $src; Test-Path -LiteralPath ($src + '.before-restore')。确认当前目录和.before-restore目录均为预期后,再执行:Remove-Item -LiteralPath $src -Recurse -Force; Rename-Item -Path ($src + '.before-restore') -NewName 'io.github.clash-verge-rev.clash-verge-rev'。如果目标目录不存在、改名冲突或路径不对,停止操作。
macOS
在同一个终端会话中执行:src="$HOME/Library/Application Support/io.github.clash-verge-rev.clash-verge-rev"; dst="$HOME/Desktop/clash-verge-rev-2026-11-14"; printf '%s\n' "$src" "$dst"; test -d "$src"。备份:mkdir -p "$dst" && ditto "$src" "$dst"。恢复:mv "$src" "${src}.before-restore" && mkdir -p "$src" && ditto "$dst" "$src"。撤销前先执行:printf '%s\n' "$src"; test -d "$src"; test -d "${src}.before-restore",确认无误后执行:rm -rf "$src" && mv "${src}.before-restore" "$src"。出现 Permission denied 时,先确认客户端已退出并核对目录归属,不要直接对未核对路径使用高权限命令。
Linux
在同一个终端会话中执行:src="${XDG_DATA_HOME:-$HOME/.local/share}/io.github.clash-verge-rev.clash-verge-rev"; dst="$HOME/clash-verge-rev-2026-11-14"; printf '%s\n' "$src" "$dst"; test -d "$src"。备份:mkdir -p "$dst" && cp -a "$src/." "$dst/"。恢复:mv "$src" "${src}.before-restore" && mkdir -p "$src" && cp -a "$dst/." "$src/"。撤销前先执行:printf '%s\n' "$src"; test -d "$src"; test -d "${src}.before-restore",确认无误后执行:rm -rf "$src" && mv "${src}.before-restore" "$src"。如果提示 Permission denied,先用 ls -ld "$src" 和 id 检查归属,确认路径后再考虑使用 sudo。
恢复后验证:配置、规则、DNS、TUN 和端口逐项检查
恢复后不要只看客户端能否打开。建议按下面清单逐项确认:
- 配置档案:当前配置名称、订阅档案和代理组仍然存在。
- 规则模式:确认当前是规则、全局还是直连模式,避免恢复后模式与原环境不同。
- 系统代理:检查系统代理开关、代理地址和端口;项目界面将系统代理与 TUN 分开列出。
- TUN 或虚拟网卡:确认是否开启;项目语言文案说明 TUN 需要服务模式或管理员模式,换系统后通常需要重新安装或授权服务,配置文件不会自动复制系统权限。
- DNS:重新检查 DNS 覆写、DNS 服务器和解析结果。若网页打不开但节点显示正常,可先关闭或恢复 DNS 覆写做对照测试,并查看连接日志是否出现解析失败。
- 端口:确认混合端口、HTTP 端口和 SOCKS 端口没有被其他程序占用。若界面出现类似
Port is already in use,先退出其他代理程序或更换未占用端口。 - Windows 代理测试:PowerShell 5.1 中不要直接使用别名
curl的-x、-I参数,应明确调用curl.exe:curl.exe -x http://127.0.0.1:<端口> https://www.gstatic.com/generate_204 -I。返回 HTTP 响应或状态码,说明本机 HTTP 代理端口至少接收到了请求;Failed to connect、Connection refused或超时,则继续检查核心、端口、节点和权限。 - macOS/Linux 测试:执行
curl -x http://127.0.0.1:<端口> https://www.gstatic.com/generate_204 -I。如果系统没有 curl,可先安装系统提供的 curl 工具或改用浏览器代理测试。 - 连接日志:查看日志中是否出现目标节点、连接尝试、DNS 错误或核心启动失败。若恢复后服务模式失效,应按目标系统重新安装、修复或授权服务。
项目源码显示,恢复 ZIP 后会解压到应用数据目录,并重新载入配置;恢复流程还会处理系统代理状态。实际是否成功,仍应以当前界面、日志和上述可复现测试为准。
如果你已完成配置备份,接下来可访问边界云加速官网了解跨设备网络连接相关服务信息,具体内容以官网为准。
WebDAV 备份怎么用:入口已核实,凭据仍要单独保护
当前开发分支设置文案包含“WebDAV 备份”标签、服务器地址、用户名、密码、刷新和上传相关操作。使用时进入备份设置,切换到 WebDAV 备份,填写自己控制的 WebDAV 地址和凭据,保存配置后再创建或上传备份。相关入口与文案可参考中文设置文件。
需要注意的是,项目隐私说明指出,WebDAV 配置可能写入 verge.yaml;而备份 ZIP 也可能包含订阅令牌、节点地址、密码、UUID 和日志信息。项目源码还显示,创建备份时会剥离 WebDAV 凭据,恢复时保留当前环境中的 WebDAV 凭据,但这不代表其他敏感配置可以公开分享。若出现开发分支文案中的 Invalid WebDAV URL format、Failed to list WebDAV backup files 或类似提示,先核对地址格式、账户权限、证书和网络连通性,并保留本地 ZIP 作为回滚副本。
常见问题
Clash Verge Rev 只备份一个 YAML 文件可以吗?
不建议。profiles.yaml 负责配置档案关系,profiles/ 可能包含订阅缓存、覆写和脚本,verge.yaml 记录应用级设置。正常情况下优先使用内置 ZIP;客户端打不开时复制整个应用数据目录。
导入 ZIP 后是不是已经恢复成功?
不是。导入通常只是把 ZIP 复制到本地备份目录并加入记录,之后还要选中该记录执行“恢复”。恢复后应检查配置档案、规则模式、系统代理、TUN、DNS、端口和连接日志。
换电脑后 TUN 为什么没有自动恢复?
TUN 或服务模式依赖目标系统的服务安装、管理员权限或其他系统组件。恢复配置不会自动复制这些系统权限,换机后需要在目标系统重新检查并按当前界面重新安装或授权服务。
Windows PowerShell 测试代理时为什么 curl -x 报错?
PowerShell 5.1 中的 curl 可能是 Invoke-WebRequest 别名,不支持常见 curl 的 -x 和 -I 参数。请使用 curl.exe,例如:<code>curl.exe -x http://127.0.0.1:<端口> https://www.gstatic.com/generate_204 -I</code>。
备份文件可以发给别人帮忙排查吗?
不建议直接发送原始 ZIP。它可能包含订阅链接、个人令牌、节点地址、密码、UUID、WebDAV 信息以及日志中的域名或 IP。应先复制一份进行脱敏,再决定是否分享。
相关阅读
- Clash Verge Rev DNS 设置与恢复后检查
- Clash Verge Rev TUN 模式设置与断网排查
- Clash Verge Rev 代理端口位置与占用检查
- Clash Verge Rev 系统代理失效排查