TL;DR:先把订阅 URL 从 Clash Verge Rev 里复制出来单独测试。返回内容必须是 Mihomo/Clash YAML,并且包含节点、分组和规则字段;否则更新按钮怎么点都不会变好。URL 正常后,再看 YAML 引用、Mihomo 内核版本、DNS 策略和系统代理状态。

适用场景与不适用场景

适用:

  • Clash Verge Rev 已安装,订阅首次导入或后续更新失败。
  • 更新后节点列表为空、提示 parse errorfailed to fetch、DNS 解析异常。
  • 你想判断问题在订阅链接、YAML、内核还是本机网络配置。

不适用:

  • 你还没有任何订阅地址,只是在选择客户端。
  • 所有设备打开同一订阅 URL 都返回服务端错误。
  • 需要编写复杂脚本覆写 profile,这篇只处理常见排查链路。

先按表现定位

表现更可能原因第一检查点
更新提示网络错误更新请求没有拿到订阅内容浏览器或命令行打开 URL
下载成功但节点为空返回内容不是 Clash/Mihomo YAML看是否有 proxiesproxy-providers
parse errorYAML 缩进、字段或引用错误用编辑器检查行号附近
更新后网页打不开DNS、规则或系统代理接管异常看日志命中的 DNS 与规则
旧配置能用,新配置不能内核不支持新字段或 provider 拉取失败查看内核版本与 provider 日志

第 1 步:验证 URL 返回内容

Windows 可用 PowerShell:

Invoke-WebRequest -MaximumRedirection 5 -Headers @{"User-Agent"="clash-verge"} -Uri "你的订阅URL" -OutFile "$env:TEMP\profile.yaml"

macOS / Linux 可用:

curl -L -A "clash-verge" "你的订阅URL" -o /tmp/profile.yaml

打开文件后看第一屏:正常情况下应该能看到 proxies:proxy-groups:rules:,或者 proxy-providers:。如果看到的是网页登录页、套餐说明、空白页、JSON 包装层或 403/404 文本,就不是 Clash Verge Rev 能直接解析的内容。

如果你的订阅服务提供多种导出格式,Clash Verge Rev 优先选择 Clash/Mihomo YAML。需要重新准备多端导出时,可以使用兼容 Clash / Singbox / V2Ray 的订阅,但导入前仍要确认当前链接的格式。

第 2 步:检查 YAML 关键字段

最小可用结构通常要有节点、分组和规则。provider 写法也可以,但引用名必须一致:

proxy-providers:
  sub-a:
    type: http
    url: https://example.com/profile.yaml
    path: ./providers/sub-a.yaml

proxy-groups:
  - name: Proxy
    type: select
    use:
      - sub-a

常见错误包括:

  1. use 里的 provider 名写错。
  2. proxy-groups 引用了不存在的节点名。
  3. 复制配置时缩进被改成 Tab。
  4. 规则里用了当前内核不支持的字段。
  5. provider 文件下载失败,但主 profile 仍显示更新完成。

第 3 步:核对 Mihomo 内核和 DNS

Clash Verge Rev 是图形客户端,真正处理配置的是 Mihomo 内核。若订阅里使用新字段,旧内核可能启动失败或只加载部分配置。到设置或日志里看当前 core 版本,再对照 Mihomo 文档确认字段支持。

DNS 排查不要和 URL 排查混在一起。建议顺序是:

  1. 关闭 TUN 和系统代理,只测试订阅更新。
  2. 更新成功后再打开系统代理,访问一个国内站点和一个海外服务样本。
  3. 打开日志,查看域名走的是哪条规则、DNS 返回的是 fake-ip 还是真实 IP。
  4. 如果只有浏览器失败,检查浏览器是否有独立代理或 DoH 设置。

验证是否修好

  • Profiles 页面能手动更新,日志没有 parse error 或 provider 下载错误。
  • Proxies 页面能看到节点和分组,分组不是空列表。
  • 访问两个样本网站,日志里能看到对应规则命中。
  • 关闭再打开客户端后,配置仍能自动加载,不依赖旧缓存。

相关阅读

中文长尾问题怎么落到配置?

代理客户端相关搜索往往很直接,比如「Clash 订阅更新失败」「节点全红」「Sing-box JSON 导入不了」「OpenWrt 透明代理没网」。这些词可以保留,但正文要把它们拆成配置、订阅、DNS、规则分流和系统代理几类问题,避免把所有故障都归因到线路。

中文长尾说法优先检查验证方式
订阅导入失败URL、User-Agent、证书、订阅格式浏览器打开订阅地址,看客户端日志
节点全红订阅是否过期、DNS、时间、出口端口换同订阅另一个客户端对照
开了代理没网系统代理、TUN、路由表、DNS先测 IP,再测域名
电视和 NAS 不走代理网关、旁路由、DHCP、分流规则用同一域名做设备对照

这种写法更贴近中文用户搜索习惯,也更容易把订阅配置、客户端日志和线路质量放进真实排查场景里,而不是生硬插入广告。

FAQ

Clash Verge Rev 订阅 URL 在浏览器能打开就一定可以导入吗? 不能只看能打开。要看返回内容是不是 Mihomo/Clash YAML,网页登录页也能打开,但客户端无法解析。

更新失败时先改 DNS 还是先清缓存? 先验证 URL 和 YAML。确认内容正常后再清 profile/provider 缓存,最后才调整 DNS。

为什么同一个订阅在手机能用,电脑不能用? 可能是手机拿到的是 Shadowrocket 或 sing-box 格式,电脑拿到的是另一种格式;也可能是 User-Agent 触发了不同导出。

什么时候需要换客户端? 同一 URL 在其他 Mihomo 客户端能更新,且 Clash Verge Rev 日志指向图形端或服务模式异常时,再考虑换客户端或重装。