专题
更新失败怎么办？版本更新/订阅更新常见问题
快速结论
解决 ClashX 更新失败的最佳方案：1. 开启“更新时使用代理”选项；2. 换个时间点再次尝试；3. 手动前往官网下载最新版本进行覆盖安装。
深度排障：更新为何无法完成？
在 ClashX 的使用中，更新主要分为两类：软件自身的版本更新 和 托管订阅的节点更新。每一类失败都有其特定的技术背景。
1. 软件版本更新失败
ClashX 是一款开源软件，其二进制更新包主要托管在 GitHub 上。
- 原因：受限于网络环境，直接通过软件内置更新功能访问 GitHub 极易发生断连。
- 修复：不要依赖软件自动更新。定期访问 clashx.tech 获取最新的
.dmg安装包，手动拖入应用程序文件夹替换旧版本。
2. 订阅更新失败（Timeout / 403）
这是最让用户头疼的问题。如果你发现点击“更新”后进度条不动，最后弹出红色报错：
- 致命逻辑：很多用户在旧订阅过期、断网后才想起更新，但此时已经由于无法连接机场官网而报错。
- 解决：在 ClashX 的“托管配置”设置中，确保勾选了 “更新时使用代理”。这样它会通过目前还能用的节点去拉取最新的配置文件。
3. 配置文件损坏或无效
如果机场后端在维护，或者你使用的订阅转换链接失效，更新后的 YAML 文件可能只有 0kb 或者包含大量 HTML 代码（报错页）。
- 表现：更新成功但节点全失。
- 对策：检查订阅链接在浏览器中是否能正常打开。如果浏览器也打不开，说明你需要联系服务商。
进阶方案：使用 ClashX Pro 自动维护
如果你不想每天手动点更新，ClashX Pro 提供了一个非常有用的功能：定时自动更新订阅。你可以设置为“每 6 小时更新一次”，即便某个节点偶尔不可用，系统也会在后台自动为你同步最新的节点信息。
仍未解决？
如果多次重试版本更新均告失败，请卸载当前版本并重新通过官网链接进行安装。
常见问题
订阅更新为什么总是提示 Timeout？
这多半是因为你在更新订阅时，ClashX 尝试直连机场服务器但被拦截。请在控制面板里勾选“更新时使用代理”。
软件版本更新下载太慢？
软件更新默认从 GitHub 下载。国内网络环境下建议前往 ClashX 官网 clashx.tech 直接手动下载 dmg 安装包。
为什么更新订阅后节点列表没变？
可能是因为机场服务器内容未更新，或 ClashX 使用了本地缓存。请点击“托管配置 -> 重载配置”强制刷新。
更新时提示“Permission Denied”？
这通常是由于 ClashX 没有修改配置文件夹的权限。请确保配置目录位于当前用户的桌面或文档文件夹中。
如何检查 ClashX 内核是否已更新？
在 ClashX 的“关于”界面可以看到 Core 版本号。如果版本过旧，建议覆盖安装最新发布的 ClashX Pro。
更新失败会导致断网吗？
版本更新失败通常不会影响当前使用；但如果订阅更新失败并删除了旧配置，可能会导致节点列表丢失并断网。