最后更新于:2026-11-16

SUBSCRIPTION TRIAGE

订阅刷不出来,不代表节点坏了。先把报错原文和眼下能用的配置存好,再把账号权限、HTTP 拉取、DNS、TLS、返回格式、客户端解析拆开逐个看。

  • 先把现场留住抄下时间、客户端、所在网络、HTTP 状态和整句报错,旧配置别被盖掉。
  • 接着逐层找域名解析成功、TLS 握手成功、拿到返回、配置读得懂,是四件不同的事。
  • 最后才动手修先重新复制、换服务商给的格式或并排导入;防护别全关,缓存目录别删。
订阅刷新先看卡在了哪一层
  1. 账号用户中心提示到期、流量见底或权限不对

    先把套餐和账号理顺;服务端权限的毛病,重装客户端解决不了。

  2. 拉取报的是 HTTP、DNS、TLS 或连接类错误

    把状态码和报错原文存下来,域名、连接、证书、返回内容各查各的。

  3. 解析内容下回来了,客户端却说配置无效

    先看拿到的是不是该有的格式,然后再查字段和客户端版本。

🚫
订阅 URL、二维码、配置文件里往往藏着长期有效的 token。整条链接别外发,“开头那一截”也别发;截图前把地址栏、二维码、节点地址、账号和返回正文里的凭证都遮住。

先把这些记下来 ​

在刷新或重装之前,先抄好:

  • 客户端名字、版本和所用系统
  • 出错那条订阅的备注名,完整 URL 不要抄
  • 什么时候出的错、当时连的哪个网、有没有开着别的 VPN / 代理
  • 整句报错、HTTP 状态码、TLS 报错或日志停在哪一步
  • 旧配置上次刷新的时间、有几个节点、现在还能不能连上
  • 同一条订阅放进浏览器或另一个你能掌控的环境里会怎样

眼下能用的配置和订阅 URL 各留一份安全的备份。一上来就删订阅、清缓存、覆盖配置,等于把对照样本扔了。

报错代码能说明到哪一步 ​

报错能下结论的还下不了结论的
timeout客户端在规定时间里没把请求做完到底是 DNS、路由、防火墙、服务端反应慢还是代理链路的毛病
401 / 403服务器或中间层没放行请求就是 token 过期、账号被封或客户端出错
404这次请求的路径回了“未找到”服务商已经关门
429这次请求撞上了频率限制被永久封了,换任何网络都不行
5xx某台服务器或中间层回了错误问题一定出在服务商主站,或者要持续多长时间
connection refused目标那头直接拒连,或被某条策略明确拦下就是本机端口、防火墙或对方宕机
certificate / TLSTLS 握手或证书检查没过肯定被人攻击了,或者跳过证书就能好
invalid configuration客户端不认收到的这份配置一定是客户端太老;返回的也许是 HTML、空白或它读不了的格式

HTTP 状态码和报错文字只告诉你从哪查起,不等于病因。还得把请求时间、跳转后的最终 URL、返回类型、服务商通知、换个网络同样操作的结果放在一起看。

逐层排查 ​

第 1 步:看账号和订阅权限 ​

进服务商的用户中心,看清:

  • 套餐还在不在有效期
  • 流量和设备数还够不够
  • 订阅有没有被重置、停用或需要重新生成
  • 通知里有没有提到订阅接口在维护或换了域名

用户中心写着“正常”,只是它那边的记录,不能说明订阅请求一定拿到了东西。把用户中心显示的时间记下,再去看客户端真正收到的 HTTP 结果。

第 2 步:重新拿一次订阅地址 ​

  1. 在用户中心再点一次“复制订阅”,或点和你所用客户端对应的那个导入按钮。
  2. 贴进本机的纯文本编辑器,看有没有多出换行、头尾空格或粘了两遍。
  3. 看清楚拿到的是订阅链接,而不是用户中心网页、邀请链接或付款页。
  4. 别自己动手拼 token、也别擅自换域名;备用域名要以服务商通知或客服回复为准。

可以用好飞机场指南的 订阅链接格式检测工具 在本地看看链接结构对不对。它全程离线,所以 token 有没有失效、服务端会回什么,它看不出来。

第 3 步:分清是拉取失败还是解析失败 ​

就在当前网络下,用浏览器打开订阅链接做个比对:

  • 下回来文件或直接显示出配置文字:只能说明浏览器这次拿到了东西,客户端发的请求头未必一样,格式能不能用也还没证明。
  • 出来的是登录页、人机验证页或 HTML 错误页:客户端多半也收到了这类不是配置的东西。
  • 页面给出 HTTP 状态:把状态码、时间和网页标题记下,别拿状态码直接断定账号出了什么事。
  • 浏览器同样超时:往下查 DNS、TCP / TLS 和网络链路。

订阅内容只在自己电脑上看。找客服时,URL、token、二维码、配置全文、命令记录一样都别发;给报错、时间、客户端、系统,再加上服务商那边的订单编号就够。

第 4 步:查 DNS 和连接链路 ​

从订阅 URL 里只截出主机名,路径和 token 都不要,再查它的解析:

powershell
Resolve-DnsName subscribe.example.com
Test-NetConnection subscribe.example.com -Port 443

macOS / Linux 下可以用:

bash
dig subscribe.example.com
nc -vz subscribe.example.com 443

能说明到哪:

  • DNS 回了一个地址,只代表这台解析器有答复,地址对不对、HTTPS 通不通都还不知道。
  • 换个解析器得到别的地址,可能是 CDN、负载均衡、按地区分配或缓存造成的,单凭这点不能说是“DNS 劫持”。
  • ping 没通也不等于主机连不上;有的服务器就是不回 ICMP,HTTPS 却照常工作。
  • 443 端口能连,只说明 TCP 那一层握上了手,TLS、HTTP、权限、配置内容有没有问题仍是未知。

换一个靠得住的网络试,可以当作只改了一个条件的对照;不过一次成败说明不了被长期封锁,也说明不了该怪谁。

第 5 步:处理 TLS 和系统时钟 ​

遇到证书或 TLS 报错时:

  1. 把系统的自动日期、时间、时区都打开,等它同步好。
  2. 把客户端给出的证书报错、主机名和出错时间存下。
  3. 对一下你连的主机名,跟服务商现在用的订阅域名是不是同一个。
  4. 换个靠得住的网络再试,或者去问单位的网管和服务商。

证书检查别关。看到公共 CA、私有 CA 还是单位自己的签发者名字,都不能单凭这个判断“没事”或“被攻击”;公司网络可能有获批的 TLS 审查,心怀不轨的链路也可能挂着公开证书。要看的是主机名、信任链、单位规定和服务商说法能不能对上。

第 6 步:对订阅格式和客户端 ​

一家服务商可能同时给 Clash YAML、mihomo、通用 Base64、Shadowrocket、Surge 好几种返回。客户端名字像,不等于能读彼此的格式:

  1. 先找到服务商标明给你这个客户端用的那个入口。
  2. 下回来以后,看清是配置,不是 HTML、验证码页或一片空白。
  3. 拿客户端项目文档去对协议、传输、TLS、Provider 和规则这些字段。
  4. 去项目发布页看最新版本和更新说明;“差两个大版本就该升”这种说法别当通用准则。
  5. 升级之前先备份配置,把迁移说明和已知问题读一遍。

常用的项目发布页:

别想当然认为 Clash 客户端能吃 V2Ray / 通用订阅,在线订阅转换也别当头选;一转换,凭证和节点配置就交到了第三方手里。

第 7 步:稳妥地查防火墙和代理链路 ​

安全软件别一口气全关,也别把整个客户端文件夹长期放进白名单。按下面顺序来更稳:

  1. 翻安全软件和系统防火墙的事件记录,看它们是不是真的拦了这个进程或域名。
  2. 确认客户端是从项目发布页下的,再看系统显示的签名或发行者对不对。
  3. 只针对确实被拦的程序、联网权限或某一条规则做最小的改动,原来的设置记下来。
  4. 用同一个订阅请求再试一次,不成功就把改动撤回。
  5. 公司或学校的设备交给管理员去办,别绕开单位规定。

客户端要是借着自己的代理去刷新当前配置,代理链路确实可能干扰请求,不过“代理绕圈”只是个有待证实的猜测。看看客户端有没有给订阅刷新单独设直连 / 代理的开关,同一条 URL 两种走法各试一次;靠来回开关全部代理去猜原因不靠谱。

第 8 步:留着旧配置,重新导入 ​

订阅能拉下来、格式也对,客户端却还显示旧内容时:

  1. 把旧配置的名字、刷新时间和节点个数记下来。
  2. 在界面里另建一个临时配置,填上刚重新复制的订阅 URL,和旧的并排导入。
  3. 把新旧两份的刷新时间、节点和解析报错对一对。
  4. 新的那份确定能用了,再在界面里把旧的删掉。

别手动去删写死路径的 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、返回内容和节点列表留在自己电脑上:

text
时间与时区:
客户端 / 内核版本 / 系统:
失败阶段:主订阅获取 / Provider 下载 / 配置解析 / 节点测试
原始错误(隐藏 URL、IP、凭证和本机路径):
HTTP 状态或 TLS 错误:
旧配置是否还能使用:
对照 A:当前网络、原下载路径 → 结果
对照 B:仅改变一个变量 → 结果
恢复原设置后的结果:

改了就好、改回去又坏,说明这个条件值得深挖;不过只比了一次,还不能认定该怪谁。如果每条路都报同样的权限错误,带上时间和报错去找服务商;如果拉下来了却解析不了,回去查格式。

手动下载只拿来缩小范围 ​

浏览器下得到配置、客户端却不行时,可以把文件存到本机一个你管得住的文件夹,用客户端的“从文件导入”试一次能不能解析。要留意:

  • 手动导入的文件不会自己刷新
  • 文件里可能带着节点地址、密钥和账号
  • 别传到网盘、公开代码仓库或在线 YAML 检查网站
  • 试完以后照你自己的安全习惯把临时文件删掉

手动导入同样解析不了,就把重心放在返回格式和字段上;手动导入能行、用 URL 刷新却不行,就把重心放在客户端发出的 HTTP 请求、代理链路和订阅设置上。

找客服时给哪些信息 ​

能给的:

  1. 客户端名字和确切版本号
  2. 系统和系统版本
  3. 出错时间和所在时区
  4. 整句报错,或者遮掉敏感信息的截图
  5. 现在用的是什么网络,以及换个靠得住的网络后的结果
  6. 浏览器拉取、客户端拉取、手动导入各自走到了哪一步
  7. 服务商那边的订单号或工单编号

订阅 URL 的哪怕一小段、token、二维码、配置全文、节点地址、设备锁屏密码、Apple / 服务商账号密码,都不要给。服务商真要认出是哪条订阅,应该让你登录后提交工单、靠账号来对应,而不是叫你把凭证亮出来。

要不要换个客户端 ​

换客户端只能用来看“这份返回换个程序能不能读”,过期、权限、DNS、TLS 或服务端出错,它都治不好。挑一个拿来对照的客户端之前,先看:

  • 你的系统它支持
  • 从项目发布页下载、而且还有人维护
  • 它写明能读你现在的订阅格式和配置字段
  • 能和旧客户端同时装着,不会把唯一的配置盖掉

换了能用,只说明另一个程序读得懂这份返回,既不代表原来的客户端没人管了,也不等于你该马上搬家。真要长期换过去,去看 各平台客户端配置 以及各客户端的维护状态说明。

延伸阅读 ​