Clash Verge Rev YAML 配置文件怎么导入?
简答: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 开头的订阅地址 | 远程订阅导入 | 不要先下载成不完整片段再当订阅地址使用 |
- 准备一个来源明确的完整配置文件,确认文件扩展名为
.yaml或.yml,并先复制一份备份。 - 打开 Clash Verge Rev,进入配置、订阅或配置文件管理页面。不同版本的菜单文字可能不同,判断标准是页面能看到配置文件列表或配置卡片。
- 优先尝试把本地 YAML 文件拖到配置列表区域。如果拖拽没有反应,改用“新建配置文件”或类似的本地文件选择入口。
- 选择文件并保存。官方文档说明,本地配置可以通过新建配置文件或拖拽方式导入;拖拽导入至少要求 Clash Verge Rev v1.6.2,当前安装版本需自行在客户端或发布页核对。
- 导入完成后,点击该配置卡片的启用、选中或设为当前配置入口。仅看到文件名不代表它已经在运行。
- 进入代理页面检查是否出现代理节点和策略组,再选择一个可用节点进行连接测试。
官方文档还说明,通过新建配置文件导入后,客户端会复制一份文件到 profiles 目录,因此原文件后续被移动或删除,通常不会影响已经复制到客户端目录中的配置副本。查看官方导入说明。
Windows、macOS、Linux 分别怎么操作
Windows
- 打开 Clash Verge Rev 主窗口,进入配置文件列表。
- 将资源管理器中的 YAML 文件拖到配置列表;如果窗口不接受拖拽,使用本地文件选择功能。
- 看到新的配置卡片后,点击它使其成为当前配置,再进入代理页面检查节点。
如果导入后需要确认文件是否已经复制,可以从客户端提供的配置目录入口进入;不要直接修改未知目录中的文件,以免改错正在使用的配置。官方文档列出了 Windows 的配置工作目录和 profiles 目录,但不同安装方式可能存在目录差异,具体以客户端实际目录为准。查看官方目录说明。
macOS
- 在 Finder 中找到本地 YAML 文件。
- 打开 Clash Verge Rev 的配置文件页面,尝试拖拽到配置列表。
- 如果拖拽不生效,使用页面中的新建或选择本地文件入口。
- 导入后选中配置,检查代理节点和策略组。
macOS 的窗口权限、文件访问权限和客户端版本可能影响拖拽行为。遇到无反应时,先把文件移动到当前用户可读的普通文件夹,再改用文件选择方式,不要一开始就修改系统目录权限。
Linux
- 从文件管理器打开本地配置文件所在目录。
- 在 Clash Verge Rev 的配置页面使用拖拽导入;失败时改用新建配置文件。
- 保存后选中当前配置,并检查代理页面是否出现节点和策略组。
Linux 下不同桌面环境对拖拽支持可能不同。若拖拽无法判断是否成功,直接使用文件选择入口更容易确认结果;官方目录说明中,Linux 的配置与配置文件目录也可能因安装方式不同而不同。查看官方安装与系统支持说明。
导入前检查:文件能否被客户端识别
导入动作成功,不等于 YAML 内容一定可以运行。导入前可以做以下快速检查:
- 文件是否完整:完整配置通常不只是几个节点片段,还应包含客户端能够识别的配置结构。只有单独的节点列表、订阅文本片段或被截断的内容,可能无法直接作为完整配置使用。
- 扩展名是否真实:Windows 可能隐藏扩展名,文件看似是
config.yaml,实际可能是config.yaml.txt。开启显示文件扩展名后再确认。 - 编码和缩进是否正常:YAML 对缩进、冒号和列表层级敏感。不要用会自动替换英文标点的编辑器批量修改。
- 协议和内核是否兼容:配置里使用的代理协议、字段或特性需要当前客户端内置的 mihomo 内核支持;仅凭文件扩展名不能判断兼容性。
- 敏感信息是否需要保护:配置可能包含订阅令牌、服务器地址、密码、UUID 或其他连接凭据,不要公开上传、截图或发到不可信群组。
如果文件来自远程订阅地址,建议先确认地址来源和权限范围。官方隐私说明指出,添加远程配置时,客户端会从用户提供的 URL 下载配置;订阅提供方能够看到相关请求信息。查看官方隐私说明。
导入后不生效:按现象分流排查
| 现象 | 优先检查 | 处理方法 |
|---|---|---|
| 配置列表没有新文件 | 导入入口和文件权限 | 不要把本地文件粘贴到远程订阅 URL 框;改用拖拽或新建配置文件,必要时把文件移到当前用户可读目录。 |
| 有文件名但节点为空 | 文件内容是否完整 | 用文本编辑器检查文件是否被截断、缩进是否错乱,并确认它不是只有节点片段。 |
| 节点有了但没有连接 | 当前配置是否已选中、节点是否已选择 | 先确认配置卡片处于当前状态,再在代理页面选择策略组和节点,之后重新测试。 |
| 网页仍然打不开 | 系统代理是否开启 | 先区分“客户端有节点”和“系统流量已接管”。系统代理开关只影响支持系统代理的程序,TUN 则是另一种接管方式,不能把二者混为一谈。 |
| 提示 YAML 解析错误 | 语法、缩进、特殊字符 | 回滚到备份文件,逐步删除最近修改的内容;不要在未备份时直接覆盖原配置。 |
官方快速入门将“导入订阅”“选择节点和模式”“打开系统代理或 TUN 模式”作为不同步骤,说明配置导入、节点选择和流量接管并不是同一个动作。遇到“配置已导入但应用仍无法访问”的情况,应按这三个层次分别复测。查看官方快速入门。
复测与回滚:确认问题到底解决没有
- 复测配置:重新打开配置列表,确认导入的文件仍存在并处于当前选中状态。
- 复测节点:进入代理页面,确认节点、代理组或策略组能够显示;如果列表为空,优先回到文件结构检查。
- 复测连接:先用一个明确支持系统代理的浏览器或应用测试,不要同时开启多个代理客户端。
- 复测系统设置:如果客户端内有节点但浏览器不通,检查系统代理开关;如果只有不支持系统代理的程序不通,再单独判断是否需要 TUN,且注意 TUN 可能涉及虚拟网卡和系统权限。
- 回滚:如果新配置导致异常,切回之前可用的配置文件,关闭刚开启的系统代理或 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 导入失败时,原来的配置会被覆盖吗?
按官方文档,本地导入会复制一份配置到客户端的配置目录。为降低风险,仍建议在导入前复制备份,并在异常时切回旧配置,而不是直接覆盖原文件。
相关阅读
参考资料
- 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 GitHub:隐私政策