Clash Verge Rev 配置文件在哪?导入、备份与恢复教程
简答:订阅更新后规则消失、换电脑找不到配置或导入 YAML 报错时,先分清文件类型,再备份 verge.yaml、profiles.yaml 和 profiles/,最后按平台路径与错误类型排查。
定义:Clash Verge Rev 配置文件是客户端或 Mihomo 内核读取的远程订阅、本地 YAML、应用设置及扩展覆写文件,不同文件的用途和恢复方式并不相同。
先看速查卡:配置文件分几类,最该备份什么?
Clash Verge Rev 是 Clash Verge 的延续,采用 Tauri 图形界面并内置 Mihomo 内核;它同时管理订阅、本地配置、应用设置以及扩展配置和脚本。因此,搜索“Clash Verge Rev 配置文件”时,最容易把订阅文件和客户端主配置混为一谈。官方简介将配置文件管理、Merge/Script 增强、语法提示和 WebDAV 备份列为功能。可参考 Clash Verge Rev 官方文档简介。
| 文件或对象 | 作用 | 是否建议备份 |
|---|---|---|
| 订阅链接 | 远程 URL,客户端通过它获取节点或配置内容 | 建议单独保存,但不要公开,因为可能带个人 token |
| 远程配置条目 | 配置页中保存的订阅名称、地址、更新信息和本地引用 | 建议随 profiles.yaml 一起备份 |
| 本地 YAML | 下载或手动编写的节点、代理组、规则等配置文件 | 建议保留原始副本 |
| verge.yaml | 客户端自身设置,例如界面、系统代理及部分应用选项 | 建议备份 |
| profiles.yaml | Profile 列表索引,帮助客户端记录已导入或管理的配置 | 建议备份 |
| profiles/ | 保存订阅配置和已导入的配置内容 | 建议备份 |
| 扩展配置与扩展脚本 | 在订阅原文基础上覆写或修改配置,旧界面常称 Merge 和 Script | 有自定义内容时必须备份 |
最稳妥的备份清单:verge.yaml、profiles.yaml、profiles/,以及你单独保存的原始 YAML、扩展配置和扩展脚本。官方隐私政策说明,代理配置可能包含订阅链接、节点地址、端口、密码和 UUID,备份文件不适合直接公开。可参考 Clash Verge Rev 隐私政策。
远程订阅和本地 YAML 怎么导入?
导入远程订阅链接
- 打开 Clash Verge Rev,进入配置或 Profiles 页面。
- 选择订阅链接导入,将你从合法来源获得的订阅 URL 粘贴到输入框。
- 保存后等待配置条目出现,再点击该配置进行启用或切换。
- 进入代理页面,确认节点和代理组已经加载;需要让其他应用使用时,再检查系统代理或 TUN 设置。
官方文档列出三种远程订阅方式:订阅链接导入、订阅链接配置和 URL Schemes。若出现 client error(Connect),先改用另一种导入方式;如果仍提示连接错误,文档提供了“允许无效证书(危险)”的重试选项。只有确认订阅来源可信并理解跳过证书校验的风险时,才应启用该选项。详情见 Clash Verge Rev 订阅导入文档。
导入本地 YAML 文件
- 准备扩展名为
.yaml或.yml的本地配置文件。 - 在配置页面选择“新建配置文件导入”,选择文件后保存。
- 也可以将文件拖拽到配置区域;官方文档注明,拖拽导入要求 Clash Verge Rev 至少为
v1.6.2。 - 导入后点击配置条目,检查节点、代理组和规则是否显示,再启用配置。
官方说明指出,新建配置文件导入会把选中的文件复制到 profiles 目录,原文件之后被移动或删除不会影响这份已保存的副本。因此仍建议保留原始 YAML,以便在配置损坏或订阅更新异常时回滚。操作依据见 订阅导入:本地配置。
最小 YAML 示例:用于理解结构和检查格式
下面是一份教学用的最小配置。节点地址、端口、密码均为占位内容,不能直接提供连接;使用时必须替换成你拥有且确认来源可信的节点参数。Mihomo 的常规配置字段可参考 Mihomo 配置文档。
mixed-port: 7890
mode: rule
log-level: info
proxies:
- name: "示例节点"
type: ss
server: example.com
port: 443
cipher: aes-128-gcm
password: "请替换为真实密码"
proxy-groups:
- name: "代理"
type: select
proxies:
- "示例节点"
- DIRECT
rules:
- DOMAIN-SUFFIX,example.com,DIRECT
- MATCH,代理| 字段 | 用途 | 检查重点 |
|---|---|---|
mixed-port | 同时提供 HTTP(S) 与 SOCKS5 的混合入口 | 实际使用端口以客户端设置页为准 |
mode | 选择规则、全局或直连等工作模式 | 规则模式通常写为 rule |
proxies | 定义节点 | 节点名称必须与代理组引用的名称一致 |
proxy-groups | 定义节点选择逻辑 | 组内引用的节点必须真实存在 |
rules | 按顺序匹配请求并决定去向 | 建议用 MATCH 明确未命中流量的处理策略 |
Mihomo 文档说明,规则从上到下匹配,MATCH 可以匹配所有没有被前面规则命中的请求。因此,更准确的写法是“建议以 MATCH 结尾,明确未命中流量的去向”,而不是说没有 MATCH 就一定无法处理。规则字段和匹配顺序见 Mihomo 路由规则文档。
Merge、Script 和扩展配置怎么用?
新版文档将原来的 Merge 配置改称为“扩展配置”,将 Script 配置改称为“扩展脚本”。扩展配置使用 YAML 对订阅结果进行覆写或合并,扩展脚本使用 JavaScript 修改配置对象;它们不等同于订阅文件,也不应直接覆盖 verge.yaml。官方说明还指出,扩展配置和扩展脚本可以分为全局扩展与订阅扩展。详情见 Clash Verge Rev 扩展配置与脚本文档。
在哪里打开?
- 进入配置页面,找到目标订阅或本地配置卡片。
- 右键配置卡片,选择“编辑扩展/脚本”。
- 根据需要选择扩展配置或扩展脚本,保存后重新加载该配置。
- 查看配置结果和日志,确认新增字段没有覆盖掉原有的节点、代理组或规则。
扩展配置示例:只覆写明确字段
dns:
enable: true
ipv6: true
tcp-concurrent: true扩展配置不是简单的逐行拼接。官方文档说明,列表和普通值,例如 rules、tcp-concurrent,可能整体替换;嵌套对象则按字段合并。因此,不要把一份只包含几条规则的文件直接写成顶层 rules 并期待自动追加。
扩展脚本示例:把规则追加到原有规则前面
const prependRules = [
"DOMAIN-SUFFIX,example.com,DIRECT"
];
function main(config) {
const oldRules = config.rules || [];
config.rules = prependRules.concat(oldRules);
return config;
}官方自定义脚本文档使用 main(config) 修改配置对象,并展示了通过新旧数组合并实现规则前置的方法。若只是为某个订阅增加规则,优先使用该订阅的扩展脚本,避免影响所有配置。可参考 Clash Verge Rev 自定义规则脚本。
Windows、macOS、Linux 配置文件位置与备份方法
不同系统的文件位置不完全相同。官方卸载说明列出了主配置和 profiles 目录,隐私政策则进一步说明了 profiles.yaml、config.yaml 与订阅内容属于应用数据。若实际安装方式、环境变量或便携版改变了路径,优先在客户端设置中使用“配置目录”入口确认,不要只凭网上固定路径判断。
| 系统 | 官方列出的主要位置 | 操作建议 |
|---|---|---|
| Windows | %APPDATA%\io.github.clash-verge-rev.clash-verge-rev\verge.yaml 与 profiles\ 位于该工作目录 | 退出客户端后复制整个目录,至少确认包含 verge.yaml、profiles.yaml 和 profiles\ |
| macOS | ~/Library/Application Support/io.github.clash-verge-rev.clash-verge-rev/ | 在 Finder 使用“前往文件夹”,复制整个应用数据目录 |
| Linux | verge.yaml:~/.config/io.github.clash-verge-rev.clash-verge-rev/profiles\:~/.local/share/io.github.clash-verge-rev.clash-verge-rev/ | 按官方目录分别检查;如果客户端提供“打开配置目录”,以该入口显示的位置为准,并同时备份相关目录 |
Linux 的配置文件和工作目录在官方卸载页面中分列为两个位置,因此不要把所有文件默认当成只在 ~/.local/share 或只在 ~/.config。路径依据见 Clash Verge Rev 卸载软件与相关文件目录。
手动备份
- 先关闭 Clash Verge Rev,确认托盘菜单中也已退出。
- 打开客户端设置中的配置目录,或按上表路径定位应用数据。
- 复制
verge.yaml、profiles.yaml、profiles/,同时保留扩展配置、扩展脚本和原始订阅文件。 - 将备份放到受信任的本地磁盘,不要上传包含订阅 token、密码或节点信息的完整 YAML。
使用 WebDAV 备份
Clash Verge Rev 支持 WebDAV 配置备份和同步。官方隐私政策说明,WebDAV 备份会上传包含 profiles、profiles.yaml、config.yaml、DNS 配置和 verge.yaml 的 ZIP 压缩包;profiles 中的节点信息、密码和订阅链接不会被自动去除。因此,只应使用你信任的 WebDAV 服务器,并把备份当作敏感文件处理。可参考 WebDAV 备份说明。
换电脑迁移:从旧设备复制到新设备
- 旧设备先备份:退出客户端,复制
verge.yaml、profiles.yaml、profiles/以及扩展配置和脚本;也可以使用客户端的 WebDAV 备份。 - 新设备安装:在 Windows、macOS 或 Linux 上安装对应版本的 Clash Verge Rev,首次启动后退出客户端,避免文件被占用或自动生成新配置。
- 覆盖对应数据:将备份文件放回新设备的对应应用数据目录。Linux 需要同时检查
~/.config和~/.local/share两处。 - 重新启动:打开客户端,检查配置列表、订阅名称、节点、代理组和扩展配置是否存在。
- 重新确认权限:如果使用 Windows 服务模式或 TUN,迁移后重新检查服务状态和系统授权;macOS、Linux 也要确认系统允许应用访问所需网络接口。
- 最后测试:先选一个节点测试,再检查系统代理或 TUN,查看连接日志中是否命中预期策略,并对比启用前后的出口 IP。
如果新设备启动后配置列表为空,不要立即删除备份。先退出客户端,确认复制的是应用数据目录而不是只有桌面上的原始 YAML,再检查 profiles.yaml 是否存在。配置文件、订阅索引和客户端设置缺一项,都可能造成“文件还在但列表不显示”的现象。
导入失败、节点为空、更新后消失:按现象排查
| 现象 | 优先检查 | 处理步骤 |
|---|---|---|
client error(Connect) | 订阅 URL、网络连通性和导入方式 | 改用订阅链接配置;只有确认来源可信时,才考虑允许无效证书并重试 |
| 提示无效证书 | 订阅服务器证书链 | 优先联系订阅提供方或改用有效证书地址;确认风险后再使用“允许无效证书(危险)” |
| 导入后节点为空 | 文件内容和格式 | 用文本编辑器检查是否存在 proxies、proxy-providers 或有效节点内容,再重新导入 |
| YAML 格式错误 | 缩进、Tab、冒号、引号和列表层级 | 统一使用空格,不使用 Tab;逐段检查代理组引用的名称是否存在 |
| 订阅更新后自定义规则消失 | 是否直接修改了会被更新覆盖的订阅文件 | 恢复备份,把自定义内容移动到扩展配置或扩展脚本;规则追加使用脚本数组合并方式 |
| 配置列表消失 | profiles.yaml 和 profiles/ 是否完整 | 退出客户端后恢复这两项,再启动并检查配置目录 |
| 配置启用但应用仍直连 | 系统代理、TUN、代理端口和应用行为 | 先确认配置已启用,再查看设置页端口、连接日志命中策略和出口 IP |
| 端口被占用 | 其他程序是否使用同一端口 | 在设置页查看实际端口;常见默认为 7897 或 7890,但以设置页为准 |
Windows 的 TUN 服务模式、macOS 的系统放行和 Linux 的权限问题属于运行权限,不等同于 YAML 文件格式错误。遇到“配置能打开但 TUN 起不来”,应单独检查服务模式、系统授权和日志,不要反复改 YAML。Windows 服务模式与权限排查可参考 Clash Verge Rev Windows 常见问题。
提交日志或截图前,应删除订阅 URL、token、密码、节点地址、个人用户名和访问过的域名。官方隐私政策明确提醒,配置与日志可能暴露这些信息。
常见问题
Clash Verge Rev 配置文件和 verge.yaml 是一回事吗?
不是。配置页中的订阅或本地 YAML 通常用于节点、代理组和规则,verge.yaml 主要保存客户端自身设置;profiles.yaml 则用于记录 Profile 列表。三者用途不同,不能互相替换。
没有订阅链接,可以自己创建 YAML 吗?
可以,但必须拥有完整且合法的节点参数。只有端口、模式和规则的 YAML 只能用于理解结构,缺少服务器、端口和认证信息时不能提供可用连接。
为什么拖拽 YAML 没有反应?
先检查文件扩展名和 YAML 格式,再确认 Clash Verge Rev 至少满足官方文档列出的 v1.6.2 拖拽导入要求。如果仍无反应,改用“新建配置文件导入”,并查看配置页是否出现解析错误。
为什么订阅更新后手动规则不见了?
常见原因是直接修改了会被订阅更新覆盖的内容。恢复原始配置后,将自定义规则放入扩展配置或扩展脚本;需要追加规则时,用脚本读取旧规则并合并新规则,不要直接用不完整的顶层 rules 替换原配置。
换电脑后文件都复制了,为什么配置列表还是空的?
检查是否复制了 profiles.yaml 和 profiles/,以及文件是否放回正确的数据目录。Linux 还要分别检查 ~/.config 与 ~/.local/share 两处;恢复前必须退出客户端。
导入成功但浏览器仍然直连,配置文件坏了吗?
不一定。先确认配置已启用,再检查系统代理开关、客户端设置页显示的端口以及应用是否遵守系统代理。最后查看连接日志中命中的策略,或对比启用前后的出口 IP。
常见问题
Clash Verge Rev 配置文件和 verge.yaml 是一回事吗?
不是。订阅或本地 YAML 用于节点、代理组和规则,verge.yaml 主要保存客户端设置,profiles.yaml 用于记录配置列表,三者不能互相替换。
没有订阅链接,可以自己创建 YAML 吗?
可以,但需要完整且合法的节点参数。只有端口、模式和规则的 YAML 只能帮助理解结构,不能直接提供可用连接。
为什么拖拽 YAML 没有反应?
检查扩展名、YAML 格式和客户端版本。官方文档要求拖拽导入至少使用 v1.6.2,也可以改用新建配置文件导入。
为什么订阅更新后手动规则不见了?
直接修改订阅内容可能被更新覆盖。恢复备份后,把自定义规则放进扩展配置或扩展脚本,需要追加规则时使用脚本合并旧规则。
换电脑后配置列表为空怎么办?
确认已恢复 verge.yaml、profiles.yaml 和 profiles/,并将文件放回正确的数据目录。Linux 需要同时检查 .config 与 .local/share 两处。
导入成功但浏览器仍然直连,配置文件坏了吗?
不一定。检查配置是否启用、系统代理和端口是否正确,再查看连接日志命中的策略或对比出口 IP。
相关阅读
参考资料
- Clash Verge Rev Docs:简介(clashverge.dev)
- Clash Verge Rev Docs:订阅导入(clashverge.dev)
- Clash Verge Rev Docs:扩展配置与脚本(clashverge.dev)
- Clash Verge Rev Docs:自定义规则脚本(clashverge.dev)
- Clash Verge Rev Docs:卸载软件与相关文件目录(clashverge.dev)
- Clash Verge Rev Docs:隐私政策与 WebDAV 备份(clashverge.dev)
- Clash Verge Rev Docs:Windows 常见问题(clashverge.dev)
- Mihomo Docs:Configuration
- Mihomo Docs:Route Rules