排错三要素铁律：先看系统时间，次查端口占用，再测备用节点
在执行任何复杂操作前，请先核验这三点：① 本地设备系统时间是否精准同步北京时间；② 本地 7890 代理端口是否冲突；③ 是否已在策略组中切换备用节点测试。
订阅拉取
1. 订阅导入失败（Invalid Config / Fetch Failed）
【故障现象】
在客户端粘贴链接点击拉取后，提示“网络请求失败”、“Invalid YAML”或解析错误。
【常见诱因】
- 误将带有推广参数的商业注册网页 URL 直接填入客户端。
- 订阅链接中的鉴权 Token 被本地网络运营商的明文 DNS 或防火墙拦截阻断。
- 服务商后台服务器正在进行维护，临时无法返回节点数据。
【标准排查步骤】
- 第一步：打开浏览器无痕模式，将复制的订阅链接直接粘贴至地址栏并回车访问。若页面返回一大段包含 server、port 等字样的纯文本或 Base64 编码，说明链接本身正常；若返回 HTML 网页，说明复制错了链接。
- 第二步：在手机或电脑上切换至手机移动热点再次尝试拉取，排除家庭宽带 DNS 解析故障。
- 第三步：登录泰山机场控制台，重新点击“复制订阅地址”或在“我的服务”中尝试点击“重置订阅 Token”。
订阅更新
2. 订阅更新失败（Update Subscription Error）
【故障现象】
之前能正常使用，但点击“更新订阅”时提示连接超时，节点未刷新。
【常见诱因】
- 更新时开启了系统代理，但当前选中的节点已失效，导致订阅更新请求本身无法发出。
- 订阅周期到期导致 Token 鉴权被服务器注销。
【标准排查步骤】
- 第一步：先在客户端中临时关闭“系统代理”或将出站模式切换为“直连模式（Direct）”，再点击更新订阅。
- 第二步：登录后台控制台，检查当前套餐的到期时间与剩余流量配额是否正常。
- 第三步：检查客户端是否设置了过于频繁的自动更新策略，被服务商接口频控拦截（建议设为12小时或24小时一次）。
客户端运行
3. 客户端无法启动或内核报错退出
【故障现象】
点击客户端图标后闪退，或提示“Core Process Exited Unexpectedly”。
【常见诱因】
- 配置文件中存在语法错误（如缺少缩进或冒号格式不合规范）。
- 杀毒软件误将 Clash 内核核心二进制组件隔离或删除。
【标准排查步骤】
- 第一步：检查本地杀毒软件或 Windows Defender 的“保护历史记录”，查看核心可执行文件（如 clash-meta.exe）是否被拦截隔离，如存在请添加信任。
- 第二步：进入客户端配置文件目录，临时删除最后导入的一份 YAML 配置，重启客户端拉取纯净配置。
- 第三步：重新从官方正规 Release 页面解压或覆盖安装客户端核心。
连接超时
4. 节点连接超时（Timeout / 延迟显示为 -1ms）
【故障现象】
点击延迟测速按钮，所有节点全部标红并提示 Timeout。
【常见诱因】
- 本地设备系统时钟与标准互联网北京时间存在严重偏差（超过60秒即会导致TLS鉴权握手失败）。
- 本地网络完全断开，或路由器防火墙封锁了高位加密端口。
【标准排查步骤】
- 第一步：进入 Windows 或手机“日期和时间设置”，关闭“自动设置时间”后再重新打开，点击“立即同步”。这是引发全节点超时的最常见元凶！
- 第二步：查看客户端控制台日志，确认是否有类似“handshake error: context deadline exceeded”报错。
- 第三步：尝试断开当前 Wi-Fi，切换为手机蜂窝移动网络热点，观察节点是否恢复延迟显示。
域名解析
5. DNS解析错误与域名污染（DNS Resolve Failed）
【故障现象】
能正常 Ping 通纯数字 IP 地址，但在浏览器中键入目标域名时提示找不到服务器。
【常见诱因】
- 本地操作系统 DNS 缓存污染或上游运营商递归 DNS 故障。
- 客户端 Fake-IP 模式与本地内网特定私有域名解析冲突。
【标准排查步骤】
- 第一步：在 Windows 命令提示符（CMD）中运行
ipconfig /flushdns命令清空本地 DNS 缓存。 - 第二步：在客户端的“常规/DNS”设置中，将上游 DNS 服务器指定为公共加密 DNS（如 223.5.5.5、119.29.29.29 或 8.8.8.8）。
- 第三步：若使用的是 TUN 模式，可在客户端设置中勾选开启“严格路由（Strict Route）”防止 DNS 旁路泄漏。
端口冲突
6. 系统代理冲突（127.0.0.1:7890 端口占用）
【故障现象】
开启系统代理提示“bind: address already in use”，或关闭客户端后所有浏览器无法打开任何国内网页。
【常见诱因】
- 此前异常退出或强行关机，导致旧的客户端进程在后台静默运行并死锁了 7890 端口。
- 退出客户端时，程序未能顺利将 Windows 系统代理还原为关闭状态。
【标准排查步骤】
- 第一步：打开任务管理器，在“详细信息”中查找是否存在名为 clash.exe、clash-meta.exe 或其他代理软件的残留进程，右键点击“结束任务”。
- 第二步：打开 Windows“设置 -> 网络和 Internet -> 代理”，在“手动设置代理”中确认是否残留开启了代理。若不想用代理，手动关闭“使用代理服务器”开关即可立即恢复上网。
- 第三步：在客户端高级设置中，将 Mixed Port 端口由 7890 更改为其他未被占用的端口（如 7892 或 10808）。
链路受阻
7. 连接显示成功但网页依然无法打开
【故障现象】
客户端小猫图标变色且有微弱上下行流量，但浏览器打开网页提示“无法连接至互联网”。
【常见诱因】
- 当前选中的节点虽能与测试服务器握手，但该节点机房的上游国际出口发生波动或阻断。
- 出站模式误选成了“直连模式（Direct）”且目标站点原本即不可直连。
【标准排查步骤】
- 第一步：检查客户端出站模式，确保选中的是“规则模式（Rule）”或临时切换至“全局模式（Global）”测试。
- 第二步：在策略组中手动挑选另一个不同地区的节点（例如由香港节点切换至日本或新加坡节点）。详见策略组选择指南。
- 第三步：清理浏览器当前选项卡的缓存，或在浏览器中打开无痕窗口重试。
移动网络
8. 移动网络与Wi-Fi切换导致异常断连
【故障现象】
手机在出门断开 Wi-Fi 自动接入 5G/4G 移动蜂窝网络后，客户端处于“假死”状态，无任何数据流经。
【常见诱因】
- 网络底层切换时，手机分配到了全新的本地私网 IP 与默认网关路由表，导致原先由 VpnService 维持的虚拟套接字连接中断。
【标准排查步骤】
- 第一步：等待约 5 至 8 秒，现代客户端通常会在检测到网络跃点变化后自动发起重连。
- 第二步：若超过 15 秒未恢复，在客户端界面点击关闭开关，停留 2 秒后再重新点亮启动。
- 第三步：下拉手机控制中心，开启“飞行模式”保持 3 秒后关闭，强制手机基带向基站重新协商网络套接字。