冲浪猫官网

Clash Verge Rev YAML 配置文件怎么导入?

更新于 2026-11-03 · clmgw.site

简答:Clash Verge Rev 导入本地 YAML 配置,通常应进入配置或订阅管理页面,使用“新建配置文件”选择本地 .yaml/.yml 文件,或将文件拖入客户端;导入后还要选中该配置并启用,最后检查节点、策略组和连接状态。远程订阅 URL 不等于本地 YAML 文件,二者应使用不同的导入方式。

定义:Clash Verge Rev YAML 配置导入,是把本地的 Clash/Mihomo 配置文件复制到客户端配置目录,再选中它作为当前运行配置的过程。

先试这一步:本地 YAML 文件的最短导入流程

本文为第三方使用指南,不代表 Clash Verge Rev 官方。以下步骤针对已经安装并能正常打开客户端的情况;截至 2026-11-03,具体按钮名称可能随客户端版本变化,遇到界面不同应以客户端实际显示和官方订阅导入文档为准。

你手里的内容应使用的方式不要混用
本地 .yaml 或 .yml 文件本地配置中的“新建配置文件”或拖拽导入不要把文件路径当成远程订阅 URL
以 http 或 https 开头的订阅地址远程订阅导入不要先下载成不完整片段再当订阅地址使用
  1. 准备一个来源明确的完整配置文件,确认文件扩展名为 .yaml 或 .yml,并先复制一份备份。
  2. 打开 Clash Verge Rev,进入配置、订阅或配置文件管理页面。不同版本的菜单文字可能不同,判断标准是页面能看到配置文件列表或配置卡片。
  3. 优先尝试把本地 YAML 文件拖到配置列表区域。如果拖拽没有反应,改用“新建配置文件”或类似的本地文件选择入口。
  4. 选择文件并保存。官方文档说明,本地配置可以通过新建配置文件或拖拽方式导入;拖拽导入至少要求 Clash Verge Rev v1.6.2,当前安装版本需自行在客户端或发布页核对。
  5. 导入完成后,点击该配置卡片的启用、选中或设为当前配置入口。仅看到文件名不代表它已经在运行。
  6. 进入代理页面检查是否出现代理节点和策略组,再选择一个可用节点进行连接测试。

官方文档还说明,通过新建配置文件导入后,客户端会复制一份文件到 profiles 目录,因此原文件后续被移动或删除,通常不会影响已经复制到客户端目录中的配置副本。查看官方导入说明。

Windows、macOS、Linux 分别怎么操作

Windows

  1. 打开 Clash Verge Rev 主窗口,进入配置文件列表。
  2. 将资源管理器中的 YAML 文件拖到配置列表;如果窗口不接受拖拽,使用本地文件选择功能。
  3. 看到新的配置卡片后,点击它使其成为当前配置,再进入代理页面检查节点。

如果导入后需要确认文件是否已经复制,可以从客户端提供的配置目录入口进入;不要直接修改未知目录中的文件,以免改错正在使用的配置。官方文档列出了 Windows 的配置工作目录和 profiles 目录,但不同安装方式可能存在目录差异,具体以客户端实际目录为准。查看官方目录说明。

macOS

  1. 在 Finder 中找到本地 YAML 文件。
  2. 打开 Clash Verge Rev 的配置文件页面,尝试拖拽到配置列表。
  3. 如果拖拽不生效,使用页面中的新建或选择本地文件入口。
  4. 导入后选中配置,检查代理节点和策略组。

macOS 的窗口权限、文件访问权限和客户端版本可能影响拖拽行为。遇到无反应时,先把文件移动到当前用户可读的普通文件夹,再改用文件选择方式,不要一开始就修改系统目录权限。

Linux

  1. 从文件管理器打开本地配置文件所在目录。
  2. 在 Clash Verge Rev 的配置页面使用拖拽导入;失败时改用新建配置文件。
  3. 保存后选中当前配置,并检查代理页面是否出现节点和策略组。

Linux 下不同桌面环境对拖拽支持可能不同。若拖拽无法判断是否成功,直接使用文件选择入口更容易确认结果;官方目录说明中,Linux 的配置与配置文件目录也可能因安装方式不同而不同。查看官方安装与系统支持说明。

导入前检查:文件能否被客户端识别

导入动作成功,不等于 YAML 内容一定可以运行。导入前可以做以下快速检查:

  • 文件是否完整:完整配置通常不只是几个节点片段,还应包含客户端能够识别的配置结构。只有单独的节点列表、订阅文本片段或被截断的内容,可能无法直接作为完整配置使用。
  • 扩展名是否真实:Windows 可能隐藏扩展名,文件看似是 config.yaml,实际可能是 config.yaml.txt。开启显示文件扩展名后再确认。
  • 编码和缩进是否正常:YAML 对缩进、冒号和列表层级敏感。不要用会自动替换英文标点的编辑器批量修改。
  • 协议和内核是否兼容:配置里使用的代理协议、字段或特性需要当前客户端内置的 mihomo 内核支持;仅凭文件扩展名不能判断兼容性。
  • 敏感信息是否需要保护:配置可能包含订阅令牌、服务器地址、密码、UUID 或其他连接凭据,不要公开上传、截图或发到不可信群组。

如果文件来自远程订阅地址,建议先确认地址来源和权限范围。官方隐私说明指出,添加远程配置时,客户端会从用户提供的 URL 下载配置;订阅提供方能够看到相关请求信息。查看官方隐私说明。

导入后不生效:按现象分流排查

现象优先检查处理方法
配置列表没有新文件导入入口和文件权限不要把本地文件粘贴到远程订阅 URL 框;改用拖拽或新建配置文件,必要时把文件移到当前用户可读目录。
有文件名但节点为空文件内容是否完整用文本编辑器检查文件是否被截断、缩进是否错乱,并确认它不是只有节点片段。
节点有了但没有连接当前配置是否已选中、节点是否已选择先确认配置卡片处于当前状态,再在代理页面选择策略组和节点,之后重新测试。
网页仍然打不开系统代理是否开启先区分“客户端有节点”和“系统流量已接管”。系统代理开关只影响支持系统代理的程序,TUN 则是另一种接管方式,不能把二者混为一谈。
提示 YAML 解析错误语法、缩进、特殊字符回滚到备份文件,逐步删除最近修改的内容;不要在未备份时直接覆盖原配置。

官方快速入门将“导入订阅”“选择节点和模式”“打开系统代理或 TUN 模式”作为不同步骤,说明配置导入、节点选择和流量接管并不是同一个动作。遇到“配置已导入但应用仍无法访问”的情况,应按这三个层次分别复测。查看官方快速入门。

复测与回滚:确认问题到底解决没有

  1. 复测配置:重新打开配置列表,确认导入的文件仍存在并处于当前选中状态。
  2. 复测节点:进入代理页面,确认节点、代理组或策略组能够显示;如果列表为空,优先回到文件结构检查。
  3. 复测连接:先用一个明确支持系统代理的浏览器或应用测试,不要同时开启多个代理客户端。
  4. 复测系统设置:如果客户端内有节点但浏览器不通,检查系统代理开关;如果只有不支持系统代理的程序不通,再单独判断是否需要 TUN,且注意 TUN 可能涉及虚拟网卡和系统权限。
  5. 回滚:如果新配置导致异常,切回之前可用的配置文件,关闭刚开启的系统代理或 TUN,再重新启动相关应用。确认旧配置恢复后,再复制新文件进行逐项修改。

不要把“配置卡片出现”“节点列表出现”“某个网页能打开”当成同一个成功标准。分别确认配置已选中、节点可见、系统流量已按预期接管,才能定位是文件、节点还是系统网络层的问题。

本页结论

Clash Verge Rev YAML 配置文件的正确主线是:准备完整本地文件 → 在本地配置入口导入 → 选中并启用 → 检查节点和策略组 → 再按系统代理或 TUN 方式复测。远程订阅 URL 与本地 YAML 文件不要混用;具体菜单名称、版本要求和目录位置以当前客户端实际显示及官方文档为准。

常见问题

Clash Verge Rev 可以直接导入 .yml 文件吗?

官方文档将本地配置描述为配置文件导入,并未在该页面单独限制只能使用某一种扩展名。通常应以客户端实际接受的文件类型和导入结果为准;如果 .yml 无法识别,可以复制文件后确认内容是完整的 Clash/Mihomo 配置,再通过新建配置文件入口尝试。

本地 YAML 文件应该粘贴到订阅链接框吗?

不应该。订阅链接框用于远程 URL,本地 YAML 应使用本地配置的新建或拖拽导入。两者混用时,常见结果是客户端把本地路径或文本当成 URL 处理。

导入配置后为什么节点列表为空?

先确认导入的文件不是只有节点片段,也没有被截断或破坏缩进;再确认当前选中的确实是刚导入的配置。若仍为空,文件可能与当前客户端内核或配置格式不兼容,建议回滚到备份并换用来源明确的完整配置。

导入成功但浏览器无法访问,是否需要开启 TUN?

不一定。先确认系统代理是否开启并检查浏览器是否使用系统代理;只有需要接管不支持系统代理的程序时,才进一步评估 TUN。系统代理和 TUN 是不同的流量接管方式,不能仅凭配置导入成功就判断必须开启 TUN。

Clash Verge Rev 导入失败时,原来的配置会被覆盖吗?

按官方文档,本地导入会复制一份配置到客户端的配置目录。为降低风险,仍建议在导入前复制备份,并在异常时切回旧配置,而不是直接覆盖原文件。

相关阅读

参考资料

  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 GitHub:隐私政策