Clash 订阅更新失败怎么办:按层逐个定位原因
Clash 及常用代理客户端拉不下订阅怎么办:从账号权限、HTTP、DNS、TLS、返回内容、配置解析到旧配置保留,一层一层找出卡在哪。
- 发布
- 更新
- 核对
- 门槛
- 新手
- 类别
- 故障排查
最后更新于:2026-11-16
订阅刷不出来,不代表节点坏了。先把报错原文和眼下能用的配置存好,再把账号权限、HTTP 拉取、DNS、TLS、返回格式、客户端解析拆开逐个看。
- 先把现场留住抄下时间、客户端、所在网络、HTTP 状态和整句报错,旧配置别被盖掉。
- 接着逐层找域名解析成功、TLS 握手成功、拿到返回、配置读得懂,是四件不同的事。
- 最后才动手修先重新复制、换服务商给的格式或并排导入;防护别全关,缓存目录别删。
- 账号用户中心提示到期、流量见底或权限不对
先把套餐和账号理顺;服务端权限的毛病,重装客户端解决不了。
- 拉取报的是 HTTP、DNS、TLS 或连接类错误
把状态码和报错原文存下来,域名、连接、证书、返回内容各查各的。
- 解析内容下回来了,客户端却说配置无效
先看拿到的是不是该有的格式,然后再查字段和客户端版本。
先把这些记下来
在刷新或重装之前,先抄好:
- 客户端名字、版本和所用系统
- 出错那条订阅的备注名,完整 URL 不要抄
- 什么时候出的错、当时连的哪个网、有没有开着别的 VPN / 代理
- 整句报错、HTTP 状态码、TLS 报错或日志停在哪一步
- 旧配置上次刷新的时间、有几个节点、现在还能不能连上
- 同一条订阅放进浏览器或另一个你能掌控的环境里会怎样
眼下能用的配置和订阅 URL 各留一份安全的备份。一上来就删订阅、清缓存、覆盖配置,等于把对照样本扔了。
报错代码能说明到哪一步
| 报错 | 能下结论的 | 还下不了结论的 |
|---|---|---|
timeout | 客户端在规定时间里没把请求做完 | 到底是 DNS、路由、防火墙、服务端反应慢还是代理链路的毛病 |
401 / 403 | 服务器或中间层没放行请求 | 就是 token 过期、账号被封或客户端出错 |
404 | 这次请求的路径回了“未找到” | 服务商已经关门 |
429 | 这次请求撞上了频率限制 | 被永久封了,换任何网络都不行 |
5xx | 某台服务器或中间层回了错误 | 问题一定出在服务商主站,或者要持续多长时间 |
connection refused | 目标那头直接拒连,或被某条策略明确拦下 | 就是本机端口、防火墙或对方宕机 |
certificate / TLS | TLS 握手或证书检查没过 | 肯定被人攻击了,或者跳过证书就能好 |
invalid configuration | 客户端不认收到的这份配置 | 一定是客户端太老;返回的也许是 HTML、空白或它读不了的格式 |
HTTP 状态码和报错文字只告诉你从哪查起,不等于病因。还得把请求时间、跳转后的最终 URL、返回类型、服务商通知、换个网络同样操作的结果放在一起看。
逐层排查
第 1 步:看账号和订阅权限
进服务商的用户中心,看清:
- 套餐还在不在有效期
- 流量和设备数还够不够
- 订阅有没有被重置、停用或需要重新生成
- 通知里有没有提到订阅接口在维护或换了域名
用户中心写着“正常”,只是它那边的记录,不能说明订阅请求一定拿到了东西。把用户中心显示的时间记下,再去看客户端真正收到的 HTTP 结果。
第 2 步:重新拿一次订阅地址
- 在用户中心再点一次“复制订阅”,或点和你所用客户端对应的那个导入按钮。
- 贴进本机的纯文本编辑器,看有没有多出换行、头尾空格或粘了两遍。
- 看清楚拿到的是订阅链接,而不是用户中心网页、邀请链接或付款页。
- 别自己动手拼 token、也别擅自换域名;备用域名要以服务商通知或客服回复为准。
可以用好飞机场指南的 订阅链接格式检测工具 在本地看看链接结构对不对。它全程离线,所以 token 有没有失效、服务端会回什么,它看不出来。
第 3 步:分清是拉取失败还是解析失败
就在当前网络下,用浏览器打开订阅链接做个比对:
- 下回来文件或直接显示出配置文字:只能说明浏览器这次拿到了东西,客户端发的请求头未必一样,格式能不能用也还没证明。
- 出来的是登录页、人机验证页或 HTML 错误页:客户端多半也收到了这类不是配置的东西。
- 页面给出 HTTP 状态:把状态码、时间和网页标题记下,别拿状态码直接断定账号出了什么事。
- 浏览器同样超时:往下查 DNS、TCP / TLS 和网络链路。
订阅内容只在自己电脑上看。找客服时,URL、token、二维码、配置全文、命令记录一样都别发;给报错、时间、客户端、系统,再加上服务商那边的订单编号就够。
第 4 步:查 DNS 和连接链路
从订阅 URL 里只截出主机名,路径和 token 都不要,再查它的解析:
Resolve-DnsName subscribe.example.com
Test-NetConnection subscribe.example.com -Port 443macOS / Linux 下可以用:
dig subscribe.example.com
nc -vz subscribe.example.com 443能说明到哪:
- DNS 回了一个地址,只代表这台解析器有答复,地址对不对、HTTPS 通不通都还不知道。
- 换个解析器得到别的地址,可能是 CDN、负载均衡、按地区分配或缓存造成的,单凭这点不能说是“DNS 劫持”。
ping没通也不等于主机连不上;有的服务器就是不回 ICMP,HTTPS 却照常工作。- 443 端口能连,只说明 TCP 那一层握上了手,TLS、HTTP、权限、配置内容有没有问题仍是未知。
换一个靠得住的网络试,可以当作只改了一个条件的对照;不过一次成败说明不了被长期封锁,也说明不了该怪谁。
第 5 步:处理 TLS 和系统时钟
遇到证书或 TLS 报错时:
- 把系统的自动日期、时间、时区都打开,等它同步好。
- 把客户端给出的证书报错、主机名和出错时间存下。
- 对一下你连的主机名,跟服务商现在用的订阅域名是不是同一个。
- 换个靠得住的网络再试,或者去问单位的网管和服务商。
证书检查别关。看到公共 CA、私有 CA 还是单位自己的签发者名字,都不能单凭这个判断“没事”或“被攻击”;公司网络可能有获批的 TLS 审查,心怀不轨的链路也可能挂着公开证书。要看的是主机名、信任链、单位规定和服务商说法能不能对上。
第 6 步:对订阅格式和客户端
一家服务商可能同时给 Clash YAML、mihomo、通用 Base64、Shadowrocket、Surge 好几种返回。客户端名字像,不等于能读彼此的格式:
- 先找到服务商标明给你这个客户端用的那个入口。
- 下回来以后,看清是配置,不是 HTML、验证码页或一片空白。
- 拿客户端项目文档去对协议、传输、TLS、Provider 和规则这些字段。
- 去项目发布页看最新版本和更新说明;“差两个大版本就该升”这种说法别当通用准则。
- 升级之前先备份配置,把迁移说明和已知问题读一遍。
常用的项目发布页:
别想当然认为 Clash 客户端能吃 V2Ray / 通用订阅,在线订阅转换也别当头选;一转换,凭证和节点配置就交到了第三方手里。
第 7 步:稳妥地查防火墙和代理链路
安全软件别一口气全关,也别把整个客户端文件夹长期放进白名单。按下面顺序来更稳:
- 翻安全软件和系统防火墙的事件记录,看它们是不是真的拦了这个进程或域名。
- 确认客户端是从项目发布页下的,再看系统显示的签名或发行者对不对。
- 只针对确实被拦的程序、联网权限或某一条规则做最小的改动,原来的设置记下来。
- 用同一个订阅请求再试一次,不成功就把改动撤回。
- 公司或学校的设备交给管理员去办,别绕开单位规定。
客户端要是借着自己的代理去刷新当前配置,代理链路确实可能干扰请求,不过“代理绕圈”只是个有待证实的猜测。看看客户端有没有给订阅刷新单独设直连 / 代理的开关,同一条 URL 两种走法各试一次;靠来回开关全部代理去猜原因不靠谱。
第 8 步:留着旧配置,重新导入
订阅能拉下来、格式也对,客户端却还显示旧内容时:
- 把旧配置的名字、刷新时间和节点个数记下来。
- 在界面里另建一个临时配置,填上刚重新复制的订阅 URL,和旧的并排导入。
- 把新旧两份的刷新时间、节点和解析报错对一对。
- 新的那份确定能用了,再在界面里把旧的删掉。
别手动去删写死路径的 profiles、应用数据或缓存文件夹。这些位置随客户端版本、系统而不同,手动删掉可能把证书、规则、日志连同唯一能用的配置一起清空。
配置刷新了,Provider 里的节点却没变
用到 proxy-providers 的时候,导入主配置和下载 Provider 是分开的两步。先弄清哪一步没成,省得一遍遍重装客户端。
| 看到的情况 | 先查什么 | 怎样才算好了 |
|---|---|---|
| 主配置的时间更新了,节点还是老的 | 那个 Provider 的刷新时间、下载报错和来源地址 | 该 Provider 刷新成功,想要的节点都出来了 |
| Provider 下回来了,节点延迟检测还是失败 | 健康检查的目标地址、节点连接和检测走的路径 | 检测过了,再去试真正要用的那个应用 |
| 某个组没在用时不自动测速 | 有没有打开 health-check.lazy | 切到这个组或手动点一次检测,再看日志 |
| 浏览器下得动,Provider 却拉不到 | Provider 的 proxy、请求头和客户端真发出的请求 | 同一个 Provider 在指定的路径下顺利下完 |
| 几个 Provider 的内容互相顶掉 | 是不是共用了同一个 path | 每个 Provider 有自己的缓存路径,能各自刷新 |
按照 mihomo 项目的代理集合文档,interval 管集合多久刷新一次,health-check 管延迟检测;proxy 定下载存放的位置,header 能改请求头,手动写的 path 不能重名。health-check.lazy 默认是开着的,集合里的节点没人用时可能就不检测。文档核对日期:2026-10-13。
上面这些属于内核配置;桌面客户端刷新主订阅的设置可能是另一套做法。先从界面和日志里看清到底有没有用 Provider,再去查字段。健康检查通过,不代表套餐没过期、视频能播或 AI 账号有使用资格。
下载成功了,想要的节点却没出现
先分清是“返回里本来就没这些节点”,还是“节点被本地过滤掉了”。在自己电脑上把 Provider 内容和实际生效的配置对着看,按顺序查 filter、exclude-filter 和 exclude-type;前两个是按名称里的字词或正则来挑,最后一个是按配置里的协议类型来剔,用 | 隔开,不支持正则。一次只动一处,记下节点个数的变化,试完要么改回原样,要么留下已经确认有效的修改。
节点换了名字就消失的话,回头看原来按名字过滤的条件还匹不匹配。别为了省事把过滤全放开、直接顶替唯一能用的配置;先在临时配置里试。下载成功、节点被选中、延迟检测通过、应用真能用,这几样要一样样确认。
缓存路径报安全限制
Provider 的 path 被 mihomo 的工作目录 HomeDir 约束;这个目录能用启动参数 -d 来设。换了设备或抄了别的客户端的配置后,原先写的绝对路径可能就用不了了。先看当前客户端的日志和真正的工作目录,尽量用它放行的目录,同时保证几个 Provider 不写同一个文件。
项目还提供了 SAFE_PATHS 这个环境变量,用来额外放行一些路径:Windows 下用分号隔开,别的系统用冒号。它是内核运行时的环境设置,不能当成 YAML 字段贴进配置;桌面客户端怎么把环境变量传进去,要看它自己的文档。别为了让报错消失就放开整块硬盘,正在用的缓存文件也别直接删。
上述过滤和路径规则出自 mihomo 项目的代理集合文档,核对日期 2026-10-25;这是照文档整理的,没有在每个桌面客户端上逐个试过。旧版内核可能和现行文档对不上,动手前先看清自己用的内核版本。
每次只动一个条件的复查记录
先拿同一个客户端、同一条订阅把失败情况留档,然后只换网络,或只换客户端提供的订阅下载走法,把结果记下来。DNS、节点、客户端版本、订阅格式要是一起换,就分不出是哪一处起了作用。
下面这份去掉敏感信息的模板可以直接复制给客服;完整 URL、返回内容和节点列表留在自己电脑上:
时间与时区:
客户端 / 内核版本 / 系统:
失败阶段:主订阅获取 / Provider 下载 / 配置解析 / 节点测试
原始错误(隐藏 URL、IP、凭证和本机路径):
HTTP 状态或 TLS 错误:
旧配置是否还能使用:
对照 A:当前网络、原下载路径 → 结果
对照 B:仅改变一个变量 → 结果
恢复原设置后的结果:改了就好、改回去又坏,说明这个条件值得深挖;不过只比了一次,还不能认定该怪谁。如果每条路都报同样的权限错误,带上时间和报错去找服务商;如果拉下来了却解析不了,回去查格式。
手动下载只拿来缩小范围
浏览器下得到配置、客户端却不行时,可以把文件存到本机一个你管得住的文件夹,用客户端的“从文件导入”试一次能不能解析。要留意:
- 手动导入的文件不会自己刷新
- 文件里可能带着节点地址、密钥和账号
- 别传到网盘、公开代码仓库或在线 YAML 检查网站
- 试完以后照你自己的安全习惯把临时文件删掉
手动导入同样解析不了,就把重心放在返回格式和字段上;手动导入能行、用 URL 刷新却不行,就把重心放在客户端发出的 HTTP 请求、代理链路和订阅设置上。
找客服时给哪些信息
能给的:
- 客户端名字和确切版本号
- 系统和系统版本
- 出错时间和所在时区
- 整句报错,或者遮掉敏感信息的截图
- 现在用的是什么网络,以及换个靠得住的网络后的结果
- 浏览器拉取、客户端拉取、手动导入各自走到了哪一步
- 服务商那边的订单号或工单编号
订阅 URL 的哪怕一小段、token、二维码、配置全文、节点地址、设备锁屏密码、Apple / 服务商账号密码,都不要给。服务商真要认出是哪条订阅,应该让你登录后提交工单、靠账号来对应,而不是叫你把凭证亮出来。
要不要换个客户端
换客户端只能用来看“这份返回换个程序能不能读”,过期、权限、DNS、TLS 或服务端出错,它都治不好。挑一个拿来对照的客户端之前,先看:
- 你的系统它支持
- 从项目发布页下载、而且还有人维护
- 它写明能读你现在的订阅格式和配置字段
- 能和旧客户端同时装着,不会把唯一的配置盖掉
换了能用,只说明另一个程序读得懂这份返回,既不代表原来的客户端没人管了,也不等于你该马上搬家。真要长期换过去,去看 各平台客户端配置 以及各客户端的维护状态说明。