奈思云-naisii.shop返回首页

Clash Verge Rev 配置文件在哪?导入、备份与恢复教程

更新于 2026-10-24 · naisii.shop

简答:订阅更新后规则消失、换电脑找不到配置或导入 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.yamlProfile 列表索引,帮助客户端记录已导入或管理的配置建议备份
profiles/保存订阅配置和已导入的配置内容建议备份
扩展配置与扩展脚本在订阅原文基础上覆写或修改配置,旧界面常称 Merge 和 Script有自定义内容时必须备份

最稳妥的备份清单:verge.yaml、profiles.yaml、profiles/,以及你单独保存的原始 YAML、扩展配置和扩展脚本。官方隐私政策说明,代理配置可能包含订阅链接、节点地址、端口、密码和 UUID,备份文件不适合直接公开。可参考 Clash Verge Rev 隐私政策。

远程订阅和本地 YAML 怎么导入?

导入远程订阅链接

  1. 打开 Clash Verge Rev,进入配置或 Profiles 页面。
  2. 选择订阅链接导入,将你从合法来源获得的订阅 URL 粘贴到输入框。
  3. 保存后等待配置条目出现,再点击该配置进行启用或切换。
  4. 进入代理页面,确认节点和代理组已经加载;需要让其他应用使用时,再检查系统代理或 TUN 设置。

官方文档列出三种远程订阅方式:订阅链接导入、订阅链接配置和 URL Schemes。若出现 client error(Connect),先改用另一种导入方式;如果仍提示连接错误,文档提供了“允许无效证书(危险)”的重试选项。只有确认订阅来源可信并理解跳过证书校验的风险时,才应启用该选项。详情见 Clash Verge Rev 订阅导入文档。

导入本地 YAML 文件

  1. 准备扩展名为 .yaml 或 .yml 的本地配置文件。
  2. 在配置页面选择“新建配置文件导入”,选择文件后保存。
  3. 也可以将文件拖拽到配置区域;官方文档注明,拖拽导入要求 Clash Verge Rev 至少为 v1.6.2。
  4. 导入后点击配置条目,检查节点、代理组和规则是否显示,再启用配置。

官方说明指出,新建配置文件导入会把选中的文件复制到 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 扩展配置与脚本文档。

在哪里打开?

  1. 进入配置页面,找到目标订阅或本地配置卡片。
  2. 右键配置卡片,选择“编辑扩展/脚本”。
  3. 根据需要选择扩展配置或扩展脚本,保存后重新加载该配置。
  4. 查看配置结果和日志,确认新增字段没有覆盖掉原有的节点、代理组或规则。

扩展配置示例:只覆写明确字段

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 使用“前往文件夹”,复制整个应用数据目录
Linuxverge.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 卸载软件与相关文件目录。

手动备份

  1. 先关闭 Clash Verge Rev,确认托盘菜单中也已退出。
  2. 打开客户端设置中的配置目录,或按上表路径定位应用数据。
  3. 复制 verge.yaml、profiles.yaml、profiles/,同时保留扩展配置、扩展脚本和原始订阅文件。
  4. 将备份放到受信任的本地磁盘,不要上传包含订阅 token、密码或节点信息的完整 YAML。

使用 WebDAV 备份

Clash Verge Rev 支持 WebDAV 配置备份和同步。官方隐私政策说明,WebDAV 备份会上传包含 profiles、profiles.yaml、config.yaml、DNS 配置和 verge.yaml 的 ZIP 压缩包;profiles 中的节点信息、密码和订阅链接不会被自动去除。因此,只应使用你信任的 WebDAV 服务器,并把备份当作敏感文件处理。可参考 WebDAV 备份说明。

换电脑迁移:从旧设备复制到新设备

  1. 旧设备先备份:退出客户端,复制 verge.yaml、profiles.yaml、profiles/ 以及扩展配置和脚本;也可以使用客户端的 WebDAV 备份。
  2. 新设备安装:在 Windows、macOS 或 Linux 上安装对应版本的 Clash Verge Rev,首次启动后退出客户端,避免文件被占用或自动生成新配置。
  3. 覆盖对应数据:将备份文件放回新设备的对应应用数据目录。Linux 需要同时检查 ~/.config 和 ~/.local/share 两处。
  4. 重新启动:打开客户端,检查配置列表、订阅名称、节点、代理组和扩展配置是否存在。
  5. 重新确认权限:如果使用 Windows 服务模式或 TUN,迁移后重新检查服务状态和系统授权;macOS、Linux 也要确认系统允许应用访问所需网络接口。
  6. 最后测试:先选一个节点测试,再检查系统代理或 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。

相关阅读

参考资料

  1. Clash Verge Rev Docs:简介(clashverge.dev)
  2. Clash Verge Rev Docs:订阅导入(clashverge.dev)
  3. Clash Verge Rev Docs:扩展配置与脚本(clashverge.dev)
  4. Clash Verge Rev Docs:自定义规则脚本(clashverge.dev)
  5. Clash Verge Rev Docs:卸载软件与相关文件目录(clashverge.dev)
  6. Clash Verge Rev Docs:隐私政策与 WebDAV 备份(clashverge.dev)
  7. Clash Verge Rev Docs:Windows 常见问题(clashverge.dev)
  8. Mihomo Docs:Configuration
  9. Mihomo Docs:Route Rules