Clash Verge无法更新订阅怎么办？按错误类型排查并恢复
简答：Clash Verge无法更新订阅，最快的判断方法是先把订阅链接放到浏览器或下载工具中验证：打不开，多半先查链接、网络或服务端；能打开但客户端失败，切换“通过代理更新”或“使用系统代理更新”；更新成功但节点没变化，则检查当前配置是否切换以及远端内容是否真的改变。不要先反复重装，先看日志中的具体错误。
定义：Clash Verge订阅更新失败，是客户端无法从远程订阅地址重新下载、解析或应用配置文件的状态。
先做一分钟分流：不要把三种问题混在一起
本站是第三方使用指南站，不是 Clash Verge Rev 项目官网。Clash Verge Rev 的远程配置更新请求会访问你填写的订阅地址，并可按配置选择直连、系统代理或客户端自身代理；配置文件、订阅地址和日志通常保存在本机，因此排查时不要公开完整链接、token、节点地址或未脱敏日志。项目隐私说明 github.com
| 你看到的现象 | 先判断什么 | 下一步 |
|---|---|---|
| 点击更新后立即失败 | 订阅链接是否能在浏览器打开 | 重新复制完整链接，检查网络、有效期和链接是否被重置 |
| 浏览器能打开，客户端失败 | 客户端采用哪条更新路径 | 依次尝试直连、通过 Clash 代理、使用系统代理更新 |
| 显示更新成功，但节点没变化 | 是否切换到了刚更新的配置 | 重新选择当前 Profile，查看更新时间和节点列表 |
| 已有节点，但代理仍不能用 | 更新问题是否已经结束 | 转查系统代理、模式、规则、TUN 或节点本身 |
成功标准：客户端显示新的更新时间，配置内容能被解析，节点数量或节点信息符合预期；随后选中该配置中的节点，并通过实际目标连接验证，而不是只看“更新成功”提示。
第1步：复制订阅链接，先在浏览器验证返回内容
- 入口：打开订阅提供方的账户、订阅或配置页面，重新复制完整订阅链接。不要手动删改参数，也不要把链接粘贴到不必要的第三方转换网站。
- 操作：在浏览器地址栏打开链接，或使用浏览器下载该地址。若浏览器已经启用代理，可分别关闭浏览器代理后再试一次，用于区分直连网络和代理路径。
- 预期结果：能看到或下载一份 Clash/Mihomo 可识别的配置内容，而不是登录页、HTML 错误页、空白响应或需要再次登录的页面。
- 判读：浏览器也打不开，优先检查复制是否完整、订阅是否到期、流量或账户状态是否异常、链接是否被重置，以及当前网络能否访问订阅域名。若这些都正常仍失败，应向订阅提供方核实，不能仅凭客户端判断服务端状态。
- 回滚或下一步：保留原来的 Profile，不要立即删除；确认新链接有效后，再在 Clash Verge Rev 中编辑原 Profile 的 Subscription URL。
订阅提供方决定远程内容的格式和可用性。项目维护者在讨论中也建议，遇到订阅导入或刷新问题时先联系订阅提供方，确认是否为特殊格式或与 Mihomo Core 不兼容，而不是把所有问题归因于客户端。项目讨论区的处理建议 github.com
第2步：在 Profile 中切换更新方式
不同版本的界面文字可能略有差异，常见入口是左侧 Profiles 或“订阅”页面，在目标 Profile 卡片上点击刷新按钮，或打开右键菜单选择更新方式。
- 先试直连更新：点击 Profile 刷新按钮，等待结果。适合订阅地址本身可直连、但当前代理配置可能还未启动的情况。
- 再试通过 Clash 代理更新：右键 Profile，选择类似“Update via proxy/通过代理更新”的选项。适合订阅域名在当前直连网络下无法访问，但现有配置和客户端代理仍可用的情况。
- 最后试系统代理更新：在 Profile 编辑项中查找类似“Use System Proxy/使用系统代理”的选项，确认系统代理已经由其他可用客户端正确提供，再重新更新。
- 每次只改变一个变量：记录是哪一种方式成功，避免同时打开多个代理软件、TUN 和系统代理，导致无法判断请求实际经过哪条路径。
Clash Verge Rev 源码显示，更新流程会在不同失败情况下尝试直连、客户端代理和系统代理路径；界面语言文件也包含“Update”和“Update via proxy”等 Profile 操作项。更新流程源码、Profile 操作项 github.com
第3步：按日志关键词处理，不要只看弹窗
如果前两步没有解决，打开 Clash Verge Rev 的日志或配置更新记录，复制错误类型和必要上下文，但先遮盖订阅 token、节点地址、密码、UUID 和访问域名中的敏感部分。项目隐私说明明确提醒，日志可能包含请求域名、IP 地址和连接元数据。日志与配置隐私说明 github.com
| 日志表现 | 通常说明的层级 | 可执行动作 |
|---|---|---|
| timeout、连接超时或 error sending request | 订阅地址无法在规定时间内完成请求 | 切换直连/通过代理更新，换手机热点或其他网络，再验证订阅链接 |
| TLS、certificate、handshake | HTTPS 建立或证书校验阶段失败 | 检查系统日期时间、系统更新和网络是否被中间设备干扰；不要把“允许无效证书”当作默认解决方案 |
| HTTP 状态码或返回内容异常 | 服务器已响应，但可能返回拒绝、登录页或错误页 | 在浏览器核对返回内容，确认订阅权限、链接完整性和账户状态 |
| 解析、YAML、profile invalid | 内容已下载，但不符合客户端可解析的配置格式 | 重新复制原始订阅链接，向提供方确认格式是否兼容 Mihomo；保留旧配置作为回滚 |
| 522 或类似网关超时 | 请求在网络链路或上游响应阶段超时 | 更换网络并分别测试直连与代理；若浏览器也复现，向订阅提供方核实 |
项目 Issue 中曾出现 TLS verifier 失败并自动尝试系统代理的日志，也有 522 远程配置获取失败的公开案例；这些只能说明相应故障类型存在，不能据此判断你当前订阅一定是同一原因。TLS 更新失败案例、522 更新失败案例 github.com
第4步：更新成功但节点没变化，检查 Profile 是否真的生效
- 看更新时间：在 Profile 卡片或详情中确认最后更新时间发生变化，而不是只看到“刷新”按钮转了一下。
- 重新选中配置：确认当前使用的是刚刚更新的远程 Profile，而不是旧的本地 YAML 或另一个同名配置。
- 比较节点列表：如果远端内容没有变化，节点数量不变并不代表更新失败；如果浏览器下载的内容已变化，而客户端列表不变，可能是配置未重新加载或仍使用旧 Profile。
- 重新导入前先备份：编辑原 Profile 前记录名称和更新方式；若删除后重新添加，必须重新粘贴完整订阅链接，并重新选择该配置。
- 验证实际连接：在 Proxies 页面选择节点后，再检查系统代理或 TUN 的状态，并访问一个明确的目标页面。节点出现在列表中，只能证明配置被解析，不能单独证明代理链路可用。
第5步：什么时候才考虑升级或重装客户端
如果同一订阅链接在浏览器能正常返回兼容配置，直连、客户端代理和系统代理都失败，而且日志指向客户端请求或解析异常，再考虑更新客户端。下载时应以项目 GitHub Releases 页面列出的安装包和说明为准，不要把搜索结果中的镜像页面当作项目官方发布源。Clash Verge Rev GitHub Releases github.com
- 记录当前 Profile 名称、订阅地址是否仍有效，以及系统和 CPU 架构。
- 备份配置前先检查文件中是否含 token、密码、UUID 和节点地址，不要把原文件直接公开上传。
- 从 Releases 选择匹配系统的安装包，升级后先确认 App Directory 或配置目录仍指向原位置。
- 首次启动后只测试一个 Profile，先验证下载与解析，再恢复其他配置，避免一次恢复多个变量。
如果升级后仍只有某一个订阅失败，而其他远程配置正常，优先回到订阅链接、格式和提供方状态排查；如果所有订阅都失败，再保留日志向项目 Issue 或订阅提供方分别反馈。
故障自查清单：按顺序打勾
- 链接：订阅地址是否完整，是否误复制了空格、换行或登录页地址？
- 权限：账户、套餐、流量和订阅有效期是否需要在提供方页面确认？
- 网络：浏览器直连是否能打开，手机热点是否能复现？
- 更新路径：是否分别测试了直连、通过 Clash 代理和系统代理？
- 冲突：是否同时运行了其他 VPN、代理客户端、TUN 或系统代理？
- 格式：下载内容是否是可识别的 Clash/Mihomo 配置，而不是 HTML 或错误文本？
- 生效：是否选中了刚更新的 Profile，并完成了实际目标连接验证？
- 隐私：日志和截图是否遮盖了 token、节点地址、密码、UUID 与完整订阅链接？
常见问题
Clash Verge无法更新订阅，应该先重装吗？
通常不建议先重装。先在浏览器验证订阅链接，再分别测试直连、通过 Clash 代理和系统代理更新，并查看日志。只有确认链接有效、格式可解析且所有更新路径都失败时，才考虑升级或重装。
浏览器能打开订阅链接，但Clash Verge仍然更新失败怎么办？
先确认浏览器拿到的是 Clash/Mihomo 配置内容，而不是登录页或 HTML 错误页。然后在 Profile 中切换更新方式，依次尝试直连、通过 Clash 代理和使用系统代理，并检查是否有其他代理软件造成冲突。
Clash Verge显示更新成功，但节点列表没有变化，算更新失败吗？
不一定。先比较远端下载内容是否真的变化，再确认当前选中的是否是刚更新的 Profile，并查看最后更新时间。如果远端内容没有变化，节点列表不变可能是正常结果。
日志出现TLS或certificate错误，能否直接打开允许无效证书？
不建议把允许无效证书作为默认方案。先检查系统日期时间、系统更新和当前网络，再切换更新路径。只有在你明确知道订阅地址和网络环境可信、并理解风险时，才根据当前版本界面决定是否临时测试。
排查时可以把完整订阅链接和日志发到论坛吗？
不建议。订阅链接可能包含个人 token，配置和日志还可能包含节点地址、密码、UUID、请求域名或 IP 信息。分享前应彻底遮盖敏感字段，只保留错误类型、时间和必要的脱敏上下文。