先区分下载、解析和配置启用
远程订阅导入分为取回内容、读取配置和启用配置。三步可能出现在同一个界面,却不是同一种故障。先记下报错发生在点击导入、手动更新,还是切换到新配置时。以 Clash Verge Rev 为例,可从侧栏「订阅」操作配置,从「日志」查看切换配置后内核给出的错误。不同版本的按钮位置可能有变化;下载失败时也应保留订阅页的提示,因为请求可能在内容交给内核前就已失败。
| 报错或现象 | 先检查 |
|---|---|
| HTTP 401、403、404 或 410 | 服务端拒绝访问或路径不可用;核对当前订阅地址和账户状态。 |
no such host 或 lookup … timeout | 订阅域名的解析及当前网络的 DNS 状态。 |
certificate has expired or is not yet valid | 设备时钟、证书有效期和报错涉及的域名。 |
yaml: line 12 一类提示 | 返回正文是否为 YAML,再检查本地副本第 12 行及其前几行。 |
| 配置已导入,启用时提示找不到策略组 | 规则目标、组名及合并配置后的引用关系。 |
订阅链接过期、失效或返回登录页
- 在订阅提供方的账户页核对服务状态,重新复制对应客户端的订阅地址。核对开头是否为预期的
https://,确认复制时没有带入引号、换行或整段分享说明。不要手动删掉查询参数。 - 确认提供方近期是否重置过订阅令牌。账户有效期与链接有效性是两回事;账户仍有效,旧链接也可能因重置而失效。先保留可用的旧配置,再按提供方说明更新地址或新建一项验证。
- 对照服务状态与 HTTP 返回。
401常指向认证问题,403表示服务器拒绝请求,可能与访问策略有关;404也可能只是路径写错。429提示请求过多,有Retry-After时按其指示等待,避免持续点击刷新。
HTTP 200 只表示取到了响应。登录页、公共 Wi-Fi 的认证页和服务端错误提示也可能以 200 返回。若服务方支持在本地保存响应,可用文本编辑器查看开头;出现 <!doctype html> 或 <html> 时,应先查为什么取到了网页,而不是改 YAML。浏览器可能携带登录 Cookie,客户端请求通常不共享这份会话,因此浏览器打开成功不能单独证明订阅可导入。
网络超时、DNS 与证书报错
先确认请求能否到达订阅服务
HTTPS 地址没有显式指定端口时,通常连接 TCP 443。no such host 出现在域名解析阶段;dial tcp 后跟连接超时,则要看日志是否已列出目标 IP。单独一个 timeout 不足以判断是 DNS、连接建立还是服务端响应慢。先完成当前网络要求的登录,再用一条有权限使用的可信网络做一次对照,只改变网络,不同时换链接和配置。
如果日志明确写着无法连接 127.0.0.1 的某个端口,先将该端口与本机客户端实际显示的监听端口对照。系统代理可能还指向已退出的客户端,或者订阅更新被设置为通过一个尚未启动的代理。先记录原设置,恢复本机正常联网后再重试。开启 TUN 不能修复过期令牌或错误文件格式,也不宜作为首次导入失败的默认处理步骤。
核对设备时间,再区分证书错误
在 Windows 11 中打开「设置 → 时间和语言 → 日期和时间」,检查「自动设置时间」并使用「立即同步」。同时确认显示的日期与时区。时间同步后若仍提示证书过期,应通过服务方确认订阅域名的证书状态。若提示 certificate signed by unknown authority,则应检查系统信任链或由管理员确认受管网络的证书策略。不要关闭证书校验来完成订阅导入。
YAML 解析错误与 Clash、mihomo 格式差异
订阅是一种交付方式,不代表固定格式。同一提供方可能分别提供 Clash 配置、面向 mihomo 的配置和通用节点列表。由单条节点 URI 组成的文本,或者编码后的节点列表,不能当作完整 Clash YAML 直接导入。只有 proxies 列表的文件也可能是供 proxy-providers 引用的数据,而非预期包含代理组和规则的主配置。优先在提供方选择与客户端及内核匹配的输出。
- 语法错误:本地编辑过配置时,检查报错行和上一段的缩进层级、列表项前的连字符及未闭合的引号。用空格缩进。
mapping values are not allowed in this context往往指向结构问题,报出的行不一定是最先写错的位置。 - 字段或协议不支持:Clash Meta 后续以 mihomo 为名维护。原版 Clash 与 mihomo 的配置支持范围不同;例如原版 Clash 不支持
hysteria2节点。遇到不支持的代理类型,查看实际运行的内核与版本,不能只看客户端名称,也不能把类型名改成别的协议来通过校验。 - 引用错误:配置能读入仍可能无法启用。比如规则
MATCH,手动选择引用名为「手动选择」的策略,合并覆写后若该策略被改名或删除,内核就可能在加载时报告找不到它。检查最终生效配置,而不是只检查远程源文件。
只有原始订阅确实是配置文件时,才适合对本地副本做语法诊断。若客户端支持导入本地文件,可用原样副本对照:本地能启用、远程仍失败,优先查下载链路与响应差异;两者都报同一行语法错误,优先查源文件。远程更新可能覆盖本地修改,验证通过后应把问题反馈给提供方,或将必要改动保存在客户端支持的独立覆写中。
更新失败但旧配置还在:怎样复测
旧配置仍显示节点,说明客户端可能在使用上一次保存的内容,不能据此判断本次更新成功。反过来,新配置已启用却没有可用节点,也不一定是订阅导入失败:如果配置通过 proxy-providers 另取节点,主配置 URL 和提供者 URL 是两次独立请求。先看日志报错对应哪一项,再决定检查主订阅还是提供者。
- 保留当前可用配置,记录这次操作的时间、客户端与内核版本、失败阶段和第一条具体错误。
- 每轮只改一个条件,例如换成账户页新复制的链接,或校准时间。随后手动更新一次,核对是否出现新的成功记录。
- 确认启用的是刚更新的配置。检查预期策略组与节点来源是否加载;节点延迟测试放在配置成功启用之后。延迟超时需要另查节点或测试目标,不能倒推出订阅已过期。
仍无法定位时,向订阅提供方或客户端维护者提交脱敏记录:说明首次导入还是更新失败、是否能在另一条可信网络复现,以及本地副本是否报相同错误。这些信息比单独描述“导入不了”更能缩小故障范围。