导入前:确认拿到的是订阅地址还是单个节点
Clash Verge Rev 的配置页用于管理配置文件。远程订阅是一个能够返回配置内容的地址;客户端访问该地址,下载配置,再交给内核加载。订阅服务负责提供节点与相关配置,客户端负责获取、解析和使用,两者不是同一个对象。
先看服务提供方给出的导出类型。优先选择标注为「Clash」「Clash Meta」或「mihomo」的订阅,并确认适用于当前内核。Clash Verge Rev 使用 mihomo 内核,但这不代表它能把任意协议链接或所有客户端的配置自动转换成可用 YAML。
- 以
https://开头:可能是订阅地址,也可能只是账户页面。是否可用,要看请求返回的实际内容。 - 以
ss://、vmess://或trojan://开头:通常是单个节点分享链接,不等于完整的 Clash 配置。 - 以
.yaml或.yml结尾的文件:可能是配置文件,但扩展名本身不能证明内容完整、语法正确。 - 二维码:只是文本的承载方式。码里可能放订阅地址、单节点链接,也可能放打开其他客户端的专用链接。
方式一:在配置页粘贴订阅 URL
远程 URL 适合长期使用:节点变动后,可以通过原地址重新获取。操作前先复制完整地址,不要把网页按钮旁的说明文字一并选中,也不要删掉问号后面的参数。
- 打开 Clash Verge Rev,进入左侧「配置」页。
- 找到订阅链接输入框,粘贴服务提供方给出的 Clash 或 mihomo 订阅地址。
- 点击「导入」,等待配置卡片生成。按钮位置可能随客户端版本调整,以当前界面的名称为准。
- 选中新导入的配置卡片,使其成为当前使用的配置。仅出现卡片,不代表已经完成切换。
- 进入「代理」页,检查策略组与节点是否出现,再按需要选择节点或自动选择组。
导入成功后,分别验证配置与流量
第一步检查配置能否加载:日志中不应持续出现 YAML 解析错误或策略组引用不存在的节点。第二步再检查流量入口:普通浏览器通常需要开启「系统代理」;不遵循系统代理的应用,可能需要单独设置代理或使用 TUN 模式。不要把「网页打不开」直接等同于「订阅没导入」。
测试时可先只启用一种流量接管方式,减少排查变量。在「连接」页查看目标请求命中了哪个规则、使用了哪个策略组。节点延迟测试有结果,只能说明对应测试请求的情况,不代表所有网站、协议和应用都正常。
方式二:导入本地 YAML 配置文件
本地文件适合离线转移、保留一份已知可用的配置,或调试手写规则。在「配置」页使用「新建」或文件导入入口,选择本地类型并导入文件;具体入口名称随版本变化。若当前版本支持文件拖入,也可以按界面提示操作,不要把拖拽当作所有版本都具备的固定入口。
- 从可信来源获取 YAML 文件,用文本编辑器确认它是配置文本,而不是登录页、错误提示或下载说明。
- 保留原始副本,检查文件中是否有
proxies、proxy-groups、rules等实际需要的配置段。 - 导入后选中该配置,再查看日志与代理页。遇到解析错误,优先检查缩进、冒号和策略组名称。
本地配置通常没有可供定时拉取的远程来源。服务商新增节点或更改密码后,旧文件不会自行变成新内容,需要重新获取并导入。文件内部若配置了远程 proxy-providers,这些提供者可以按各自设置更新,但那是文件内部资源更新,不是整个本地文件被替换。
用最小配置理解 YAML 结构
下面是用于辨认字段与缩进的最小示例,全部连接走直连,不提供代理节点。7897 是示例混合端口,实际监听值以客户端「设置」中的端口配置及最终生效配置为准。
mixed-port: 7897
allow-lan: false
mode: rule
log-level: info
proxies: []
proxy-groups:
- name: 手动选择
type: select
proxies:
- DIRECT
rules:
- MATCH,手动选择
YAML 通过缩进表达层级。这里使用两个空格,不能用制表符代替缩进。rules 中引用的「手动选择」必须与策略组名称一致;改了组名却没改规则,会导致引用错误。在线订阅文件还可能受到客户端覆写设置影响,编辑原文件前应先确认修改是否会在下次更新时被覆盖。
方式三:扫描二维码后识别内容再导入
扫码的核心是取得文本,并不是一种独立的配置格式。若当前桌面版本没有扫码入口,可以使用手机或本地二维码识别工具读取文本,再将订阅 URL 通过可信方式传到电脑,回到「配置」页粘贴导入。不要把含令牌的二维码上传到陌生在线识别网站。
- 结果是 HTTPS 订阅地址:确认域名与服务提供方一致,再按 URL 导入流程处理。
- 结果是单节点 URI:回到服务提供方选择 Clash 或 mihomo 订阅导出。不要把单节点地址直接当成完整 YAML。
- 结果是客户端专用唤起链接:确认目标客户端与操作内容。没有对应协议处理程序时,浏览器无法完成唤起,可以改用原始订阅地址。
从手机复制到电脑后,检查地址是否被聊天工具截断,是否带入换行、中文标点或尾部空格。二维码识别成功只说明文本可读,不能证明订阅仍有效,也不能证明返回格式适合 Clash Verge Rev。
YAML 与 Base64:配置结构和编码方式的区别
Clash YAML 是有字段层级的配置文本,能够描述节点、策略组、规则和 DNS 等内容。Base64 则是一种编码方式,不是一种代理协议,也不等于加密。常见的「Base64 订阅」解码后,是多行节点分享链接;它通常不包含完整的 Clash 策略组和分流规则。
| 检查项 | Clash YAML | 常见 Base64 节点列表 |
|---|---|---|
| 文本形态 | 字段、冒号、缩进与列表 | 编码文本,解码后常为多行 URI |
| 节点定义 | 通常在 proxies 或代理提供者中 | 通常由每条分享链接描述 |
| 策略与规则 | 可包含 proxy-groups 与 rules | 通常需要另行生成 |
| 导入处理 | 确认内核支持字段与协议后加载 | 优先向来源获取 Clash 格式导出 |
| 隐私风险 | 可能含节点密码与远程资源地址 | 解码即可读取,不应公开分享 |
不要通过改扩展名进行格式转换
把 Base64 文本保存为 subscription.yaml,不会生成 proxies 和 rules。同样,把文件名从 .txt 改成 .yaml,也不会修复语法。判断依据始终是内容,而不是文件名、下载按钮上的图标或 URL 的结尾。
同一个订阅服务可能根据导出选项、请求参数或 User-Agent 返回不同内容。浏览器看到节点列表,而客户端得到 YAML,并不一定是异常。应优先使用服务提供方明确给出的 Clash 导出地址。确需转换时,应选择可信且理解其数据处理方式的工具;转换服务能够接触订阅中的敏感信息,不能随意提交。
更新间隔:区分远程配置与代理提供者
远程配置的更新频率在配置卡片的编辑界面设置。操作路径通常为「配置」→ 对应卡片菜单或右键菜单 →「编辑」,查找更新间隔字段。不同版本的字段名称与单位可能不同,填写前先读标签:如果单位是分钟,360 表示六小时;如果单位是秒,六小时应填 21600。不要直接照搬另一个版本截图里的数值。
一般可以从六小时一次开始,根据服务提供方建议调整。节点短期不变时没有必要每分钟拉取;过于频繁可能触发请求限制。手动点击一次「更新」并检查结果,再观察自动更新是否按预期工作。自动更新通常依赖客户端运行与网络可用,电脑关机或休眠时不能按普通在线任务理解。
proxy-providers 的 interval 使用秒
mihomo 配置中的 HTTP 代理提供者可以使用 interval 控制更新周期,其单位是秒。例如 interval: 3600 表示每小时获取一次提供者内容。它只作用于该提供者,不等同于客户端每小时重新下载整份远程配置。提供者的健康检查又有单独的间隔,用于测试节点,不应与订阅更新混为一谈。
导入失败:按请求、内容、加载三层排查
- 先看请求是否成功。连接超时先检查网络与订阅域名解析;HTTP
401或403要确认令牌、授权状态与服务端访问限制;429表示请求过于频繁,应等待后降低更新频率。不要连续点击导入。 - 再看返回内容。HTTP
200也可能返回登录页或错误页面。若内容以<!DOCTYPE html>开头,应检查是否复制了账户页面,或请求是否被重定向到验证页面。 - 然后看配置解析。出现 YAML 行号错误时检查该行及上一行的缩进、引号与冒号。出现节点类型不支持时,核对导出目标和当前内核能力,而不是反复修改监听端口。
- 最后看配置是否启用。代理页没有预期节点时,先确认当前选中的配置,再检查它是否只引用了尚未成功下载的代理提供者。
导入、更新和代理连接是三个阶段。订阅下载失败时,开启 TUN 并不必然解决问题;节点连接失败时,重新导入同一份配置也未必有效。先记录失败时间、当前操作与日志中的关键错误,再只改变一个设置,比较前后结果。
完成后可做一次简短复核:配置卡片已选中,代理页有预期策略组,手动更新能够完成,实际请求能在连接页看到正确去向。新用户还可以对照客户端上手教程检查系统代理与首次连接步骤。