1 分钟定位故障来源
按顺序做下面 4 步，能区分是订阅本身有问题、网络问题、还是客户端解析问题。
-
1浏览器粘贴订阅链接，看返回什么
把订阅链接（完整 URL）粘贴到浏览器地址栏访问，观察返回内容：
- 看到一大段 YAML 文本（含 proxies:、proxy-groups: 等字段）：订阅本身正常，问题在客户端解析或 UA 校验，跳到第 3 步。
- 看到一串看似乱码的 Base64 字符：订阅是 V2Ray 格式，Clash 客户端无法直接使用。看下面"原因 #4"。
- 页面打不开 / 超时 / DNS 错误：订阅服务器不可达，看下面"原因 #2"。
- 返回欢迎页 / 客服信息 / "套餐已过期" 等文字：订阅过期或被限速，看下面"原因 #1"。
-
2尝试用 curl 模拟 Clash 的 User-Agent
如果浏览器看到的不是 YAML，但你确认是 Clash 订阅，可能是机场强制要求 UA。终端执行：
curl -A "clash-verge" "你的订阅链接" | head -50如果这次返回了 YAML，说明是 UA 校验，看下面"原因 #6"。
-
3看客户端日志
打开客户端的"日志"页（部分客户端在"设置 → 日志"），关键字搜：
error/failed— 直接显示原因yaml/parse— 解析错误timeout— 网络超时
-
4用 工具页 校验订阅内容
如果是 Base64 内容，可在工具页解码看看里面是 vmess / ss / trojan 等 V2Ray 类协议链接，确认是 V2Ray 格式而非 Clash 格式。
6 大常见原因 + 解决方案
按出现概率从高到低排列。前 3 个能覆盖绝大多数情况。
最常见的原因。机场通常会在订阅过期或流量用完时，把订阅响应替换为欢迎页或纯文本提示。客户端解析后自然得到 0 个节点。
订阅服务器域名或 IP 被你当前的网络运营商屏蔽。表现为浏览器打开订阅链接超时、DNS_PROBE_FINISHED_NXDOMAIN、ERR_CONNECTION_RESET 等。
- 切换 DNS 到 Cloudflare (1.1.1.1) 或 Google (8.8.8.8)
- 使用机场提供的备用订阅链接（多数机场提供 2~3 个域名）
- 切换网络环境（家庭宽带 ↔ 手机热点）验证
- 在客户端订阅设置里启用"通过当前代理更新订阅"（需要先有可用节点）
机场通常在用户面板提供多个订阅链接：Clash、Clash Meta、V2Ray、Shadowrocket、Quantumult 等。如果复制了 V2Ray 链接到 Clash Verge Rev，导入后无法识别。
浏览器打开订阅是一大段 dm1lc3M6Ly8... 这种没法读懂的字符。这是 V2Ray 通用订阅，本质是 Base64 编码的多行 vmess:// / ss:// / trojan:// 链接。
机场模板被维护错（缩进错、字段拼错），或本地手工编辑过的配置。Clash 内核遇到 YAML 解析错误会跳过整段，但客户端可能不报错只显示"导入成功"。
- 客户端的"日志"页看是否有
yaml parse error类信息 - 把订阅内容粘贴到任意 YAML Linter 工具（如 yamllint.com）验证语法
- 联系机场客服反馈模板问题
部分机场用 UA 区分客户端：浏览器访问返回欢迎页，User-Agent: clash 才返回 YAML，User-Agent: v2ray 返回 Base64。如果客户端发送的 UA 不匹配机场期望，会拿到错误格式。
clash-verge/v2.5.1ClashMetaForAndroidclash/Clash
按平台的额外排查要点
- • Defender 可能临时拦截订阅请求
- • 检查
hosts文件是否屏蔽机场域名 - • 配置目录：
%APPDATA%\io.github.clash-verge-rev.clash-verge\
- • 检查"系统设置 → 网络 → DNS"是否被改
- • Wi-Fi 切换后强制刷新订阅
- • 配置目录：
~/Library/Application Support/io.github.clash-verge-rev.clash-verge/
- • 终端
curl -v "订阅链接"看完整 HTTP 交互 - • 检查
/etc/resolv.conf与 systemd-resolved - • 配置目录：
~/.config/clash-verge/
- • 4G/5G 与 Wi-Fi 切换后重试
- • 部分机场对移动端 UA 有限制，需手动指定
- • 不同浏览器（Chrome / 系统浏览器）访问订阅返回内容可能不同
向机场客服 / 社区求助前
按下面这份模板整理信息，能极大提高解决效率，避免来回拉扯。
**客户端**：Clash Verge Rev v2.5.1
**系统**：Windows 11 23H2 / macOS 14.5 / ...
**订阅类型**：机场 / 自建 (注明协议如 Clash Meta)
**症状**：
- 浏览器打开订阅链接，看到的内容是 ___
- curl -A "clash-verge" 测试，返回的是 ___
- 客户端"日志"页看到的关键报错：___
- 已尝试过的方法：___- 订阅链接里通常含 token，不要原样贴出来，用
https://xxx.com/api/v1/client/subscribe?token=*****代替 - 日志截图前模糊掉节点名（可能含用户名 / 套餐名）
- 不要把整段 YAML 贴公开论坛，里面含节点 IP 与密码
- 只贴关键报错行 + 上下文 1~2 行