Clash 文档中心中文使用手册

订阅更新失败,先分清请求和解析

根据 HTTP 返回、HTML 内容与 YAML 错误,定位配置下载在哪一步失败。

更新于 2026/9/30

一次订阅更新会经过请求、下载、解析和激活。失败提示出现在哪一步,决定接下来该检查链接、账户还是配置语法。

收到什么内容

HTTP 401 或403表示这次请求被拒绝,可能涉及令牌、账户或访问限制,不能仅凭状态码判断账户到期。404先检查路径是否复制完整。HTTP 200只说明请求返回了内容,如果正文是登录网页,客户端仍然无法把它当作配置。

从服务方提供的 Clash/Mihomo 入口重新复制链接,不复制浏览器里的账户首页。粘贴时注意首尾空格和聊天软件附带的标点。完整订阅地址常带令牌,公共截图应遮挡。

解析失败之后

出现 YAML 行号时保留文件副本和错误原文。缩进、特殊字符或客户端支持的字段都可能影响解析。配置既可能直接包含节点,也可能引用提供商文件;主配置成功加载之后,引用文件仍可能下载失败。

不要把网页保存为 .yaml 后继续尝试。扩展名改变不了文件内容。服务方提供多种导出格式时,选择当前客户端明确支持的格式。

保留原来可用的配置

新建条目导入,先保留旧条目。更新失败后确认旧配置仍在使用,再记录失败时间、客户端版本、状态码或脱敏日志。等新配置完成解析和一次目标请求验证后,再决定是否移除旧配置。

资料:Mihomo 配置文档、Clash Verge Rev 入门。完整入门顺序见使用教程。

返回文章索引使用教程