代理订阅无法更新是什么原因？按报错逐步排查
简答：代理订阅无法更新，先不要反复点击刷新：复制完整订阅链接，用浏览器或另一条网络测试，再根据返回结果区分链接、账号、网络还是客户端问题。浏览器也打不开，优先检查订阅地址、账户状态、DNS 和当前网络；浏览器能打开但客户端失败，则重点检查更新代理、订阅格式、客户端版本和缓存。
定义：代理订阅更新，是客户端重新请求订阅地址并下载配置、节点或规则内容的过程；更新失败不等于节点一定失效，还要区分“请求失败”“更新成功但节点为空”和“节点存在但无法连接”。
先看报错：用一张表判断从哪里开始排查
先记录客户端显示的原始错误，不要只记“更新失败”。如果客户端没有详细提示，可以复制订阅链接到浏览器地址栏，或在同一设备上切换手机热点测试。浏览器返回什么内容，通常比客户端笼统的失败提示更适合做第一轮分诊。
| 现象或提示 | 更可能的方向 | 先做什么 |
|---|---|---|
| 401、403 | 认证凭据、权限或访问策略 | 重新从账户面板复制链接，确认没有使用旧链接；不要把订阅链接公开粘贴 |
| 404 | 地址错误、路径变化或资源不存在 | 核对是否漏字符、带空格、换行或中文标点，并重新生成订阅地址 |
| 429 | 请求频率过高 | 停止连续刷新，等待一段时间后再试；若客户端支持，检查是否存在过短的自动更新间隔 |
| timeout、Failed to fetch | 当前网络、DNS、代理链路或服务器响应超时 | 先用浏览器和手机热点测试，再切换“通过代理更新”或“直连更新” |
| TLS、证书错误 | 系统时间、证书校验、网络中间设备或客户端兼容性 | 校准系统时间，升级客户端；不要为了绕过报错而关闭证书校验 |
| Parse Error、无效 YAML、节点为 0 | 返回内容不是客户端支持的格式，或服务端返回了错误页面 | 在浏览器检查返回内容，再确认订阅格式与客户端类型匹配 |
HTTP 状态码只是判断入口，不代表单凭一个代码就能确定责任方。根据 HTTP 状态码说明，401 通常表示缺少有效认证信息，404 表示服务器找不到请求资源，429 表示请求过于频繁；具体处理仍要结合订阅服务的账户面板和客户端日志。
- 复制完整链接，粘贴到纯文本编辑器，检查前后是否多了空格、换行或中文引号。
- 在浏览器中打开链接，观察是下载配置文本、返回登录页，还是出现 401、403、404 等错误。
- 关闭客户端后，用手机热点重复一次；如果热点成功而原网络失败，优先排查本地网络、DNS 或网络策略。
浏览器能打开和打不开，处理路径完全不同
浏览器也打不开订阅链接
先重新生成或复制订阅链接。订阅地址可能已经被重置、账户状态发生变化，或者复制时混入了不可见字符。若返回 401 或 403，检查登录账户、访问权限和是否误用了旧链接；401 与 403 的区别可参考 MDN 对 401 的说明。
若返回 404，重点检查域名、路径和链接尾部参数。404 只能说明当前请求没有找到对应资源，并不能单独证明账户已经到期；可以回到账户面板重新复制，而不是手动猜测链接。相关状态码含义见 MDN 对 404 的说明。
若浏览器一直超时，依次测试另一条网络、修改为系统自动 DNS 或可信 DNS、暂时关闭会拦截 HTTPS 的安全软件，再观察结果。不要同时改动很多设置，否则难以判断究竟是哪一步起效。
浏览器能打开，但客户端更新失败
这通常说明订阅地址至少能被当前网络访问，下一步应检查客户端的请求方式。部分客户端会提供“通过代理更新”“直连更新”或类似选项：如果当前代理已经断开，选择通过代理更新可能形成代理死锁；如果订阅域名只能经由当前代理访问，直连更新又可能失败。因此可以两种方式各试一次，并查看日志中的请求结果。
还要确认浏览器得到的确实是配置内容，而不是登录页、验证码页或 HTML 错误页。客户端能访问 URL，不代表一定能解析返回内容；如果返回格式与客户端支持的订阅类型不匹配，就可能表现为 Parse Error、配置无效或节点数量为 0。
推荐的三步分诊
- 同设备浏览器测试：确认链接是否有响应，以及响应是否像配置文件。
- 换网络测试：使用手机热点或另一条 Wi-Fi，判断是否为本地网络、DNS 或出口问题。
- 换客户端测试：只使用维护中的客户端和其官方发布渠道；如果多个客户端都失败，优先回到链接、账户和网络方向排查。
按客户端处理：更新入口和兼容性检查
下面的菜单名称可能随版本变化，请以当前界面为准。订阅链接、配置文件和单节点链接不是同一种输入：优先使用服务面板提供的专用订阅或一键导入，不要把单节点链接当成整份订阅地址。
Windows、macOS、Linux：Clash Verge Rev
- 打开配置或订阅页面，找到订阅管理区域，重新粘贴完整链接并保存。
- 在订阅条目右侧选择更新；若失败，分别尝试直连更新和通过代理更新。
- 打开日志，确认返回的是配置内容而不是 HTML 错误页；更新后检查更新时间和节点数量。
该项目的官方 GitHub Releases 页面持续提供桌面版本和变更说明，更新前可先核对当前版本与发布说明：Clash Verge Rev 官方 Releases。如果旧版本无法解析新格式，优先升级到官方发布的较新版本，不要从不明镜像下载。
Windows、macOS、Linux：v2rayN
- 进入订阅分组或订阅设置，检查 URL 是否完整，再保存订阅。
- 执行更新订阅；如果客户端提供“通过代理更新”选项，分别测试开启和关闭。
- 查看日志中的 HTTP 状态、TLS 错误和解析错误，更新后确认节点列表是否实际刷新。
v2rayN 官方仓库说明其桌面版本支持 Windows、Linux 和 macOS，并提供 Wiki 与 Releases 入口；可从 v2rayN 官方仓库或官方 Releases核对安装包和使用资料。客户端能打开订阅地址，不代表订阅内容一定适合当前内核，仍需以返回格式和日志为准。
iPhone、iPad：Shadowrocket
- 在配置或订阅管理页面添加订阅链接，检查名称和 URL 是否完整。
- 保存后手动执行更新；若存在代理更新选项，先用直连测试，再用已有可用配置测试。
- 更新后分别检查配置数量、节点列表和实际网页访问，不要只看“更新时间”是否变化。
App Store 页面显示该应用支持配置与代理管理，并提醒它本身不提供代理服务或服务器资源；安装和更新应以 App Store 页面为准。若更新成功但列表为空，回到订阅格式、返回内容和账户状态继续排查。
更新成功但节点为空、节点不变或全部超时，分别这样判断
节点为空：客户端完成了请求，但解析后没有可用条目。先在浏览器检查返回内容是否为配置文本，再确认订阅格式和客户端类型是否匹配；如果浏览器返回登录页或错误页，问题仍在链接或账户侧。
节点不变：可能是更新请求没有真正成功，也可能服务端返回的内容没有变化。看客户端的最后更新时间、日志状态码和配置文件大小，不能只凭列表外观判断。
节点全部超时：这已经不是单纯的订阅下载问题。先确认节点列表确实刷新，再按“本地网络→系统时间→订阅状态→节点→DNS/MTU→系统代理或 TUN 权限”的顺序排查。验证时应以能访问目标网站且出口 IP 按预期变化为准；规则模式下，部分国内网站显示本地 IP 可能是正常现象。
如果只有公司网络失败，先确认是否存在网页认证、代理网关、DNS 拦截或 HTTPS 检查；如果手机热点和家庭网络均失败，则更应回到订阅地址、账户状态和客户端日志，而不是继续调整 MTU。
安全提醒与更新后的验收清单
订阅链接应按敏感配置处理，不要公开发到群聊、工单截图或帖子中；如果链接已经暴露，优先在账户面板重置或重新生成。也不要为了通过 TLS 报错而关闭证书校验，因为这样会削弱对连接对象的验证。
更新完成后，按下面清单验收：
- 订阅条目的更新时间已经刷新。
- 节点数量与预期大致一致，没有突然变成 0。
- 随机选择一个节点，客户端延迟测试能够返回结果。
- 打开目标网站，确认页面能正常加载。
- 如果需要验证出口变化，在连接前后分别查看出口 IP，并记录使用的是规则模式还是全局模式。
- 关闭客户端后重新打开，确认配置不会立即消失或重复报错。
如果仍无法定位，向服务提供方提交客户端名称、系统版本、错误原文、出现时间和是否更换网络测试成功；不要提交完整订阅链接、密码或令牌。
结尾推荐框为本站商业推广。
常见问题
为什么浏览器能打开订阅链接，客户端还是更新失败？
常见原因是客户端使用了不同的更新代理、User-Agent、请求头或解析器，也可能浏览器拿到的是 HTML 页面而不是配置内容。先检查客户端日志，再把浏览器实际返回内容与客户端支持的格式进行对照。
订阅更新失败是不是一定代表账户到期？
不是。401、403、404、超时、TLS 错误和解析错误分别指向不同方向，账户状态只是其中一种可能。先做浏览器测试和换网络测试，再查看账户面板中的订阅状态。
更新时应该打开代理，还是关闭代理？
没有适用于所有网络的固定答案。如果当前代理已经不可用，打开“通过代理更新”可能造成代理死锁；如果订阅域名在直连网络下无法访问，关闭代理又会失败。两种方式各测试一次，并以日志结果判断。
节点数量没有变化，算更新成功吗？
不能只看节点数量。还要确认更新时间、HTTP 状态、返回内容、节点参数和实际连接结果；服务端内容没有变化时，成功更新后列表也可能看起来不变。
出现证书错误时，能不能关闭证书校验？
不建议。先校准系统时间、换网络、检查安全软件或企业网络的 HTTPS 检查，再升级客户端。若仍失败，保留完整错误信息并向服务提供方求证。
常见问题
为什么浏览器能打开订阅链接，客户端还是更新失败？
重点检查客户端的更新代理、请求头、解析器和订阅格式，并确认浏览器返回的是配置内容而不是登录页或错误页面。
订阅更新失败是不是一定代表账户到期？
不是。401、403、404、超时、TLS 和解析错误对应不同方向，应先做浏览器测试、换网络测试，再查看账户面板。
更新时应该打开代理，还是关闭代理？
分别测试直连更新和通过代理更新。代理已经断开时可能形成代理死锁，订阅域名无法直连时则可能需要通过已有配置更新。
节点数量没有变化，算更新成功吗？
不能只看数量，还要检查更新时间、日志状态、返回内容和实际连接结果。
出现证书错误时，能不能关闭证书校验？
不建议。先校准系统时间、换网络、检查安全软件或企业网络环境，并升级客户端。