检修分诊台 · 症状归类 · 逐层定位
Clash 新版客户端
故障检修与排查路径
故障检修最怕的不是问题复杂，而是从错误的地方开始查。 这一页先按症状分诊，把问题归到四类里，再沿对应路径逐层定位—— 每一步都有可观察的结果，查到哪一步不对，问题就在那里。
Triage · 症状分诊
四类症状，对应四条不同的排查起点
同一句「连不上」，背后的原因可能完全不同。先看清自己属于哪一类，再进对应的排查路径—— 这一步做对，后面的排查会顺很多。
联网失败
客户端显示运行中，但浏览器与软件都打不开网页，或时通时断。
- 模式是否为规则
- 订阅是否拉到节点
- 端口是否被占用
- 系统代理是否开启
节点失效
客户端能开，出口 IP 也变了，但所有节点测速全红、延迟显示超时。
- 订阅是否已过期
- 节点是否已下线
- 系统时间是否准确
- 网络环境是否受限
启动闪退
双击图标后界面一闪而过，或进程起来几秒后自动退出，看不到主界面。
- 架构是否匹配
- 权限是否给足
- 旧版残留是否冲突
- 安装包是否完整
界面卡顿
客户端能用，但切换页面迟滞、测速时界面冻结、操作响应变慢。
- 日志级别是否过高
- 配置复杂度是否过大
- 资源占用是否异常
- 规则集是否过大
Diagnosis Path · 排查路径
四条路径，每一步都有可观察的结果
排查的关键在于「不要跳步」。下面的每条路径都按顺序排列，每一步做完都应该有个看得见的结果—— 对不上就停在那一步解决，不必回头重来。
联网失败：从模式查到端口
典型症状：客户端在运行，但浏览器打不开网页，或部分软件直连。
确认运行模式是否为规则模式
客户端如果停留在直连模式，所有流量都不走代理，看起来就是「连不上」。切回规则模式，再试一次。
✓ 模式切回 RULE 后重试确认订阅是否拉到节点
打开配置页看节点数量与更新时间。如果为 0 或更新时间是很久以前，说明订阅没拉到，先更新订阅，再回到这一步。
✓ 节点列表非空且更新时间新鲜确认端口是否被占用
客户端面板里会显示当前端口。端口被其他程序占用时，客户端可能仍显示运行中，但代理实际不生效。换一个空闲端口，重启客户端。
✓ 端口无冲突提示确认系统代理是否已开启
部分客户端需要手动开启系统代理开关。如果只启动内核但没接管系统代理，浏览器不会走代理。在客户端面板里确认开关状态。
✓ 系统代理开关为开启状态确认出口 IP 是否已改变
如果以上四步都正常，打开查询出口 IP 的页面。若地区已变，说明代理生效，问题可能在被访问的目标站点；若仍是本地 IP，说明流量没走代理，回到第 3 步重新检查。
✓ 出口 IP 地区与节点一致节点失效：从订阅查到时间
典型症状：出口 IP 已变但所有节点测速全红，延迟显示超时。
先更新订阅，排除节点过期
节点下线是常见原因。在配置页手动触发一次订阅更新，看节点列表是否有变化。如果更新后仍然全红，进入下一步。
✓ 订阅更新时间已刷新检查系统时间是否准确
部分协议对时间偏差敏感，系统时间不准会导致握手失败。开启系统自动同步时间，等同步完成后重新测速。
✓ 系统时间已自动同步换一个网络环境试试
部分网络环境会干扰特定协议。如果手机热点下节点可用、当前网络下不可用，说明问题出在当前网络，而不是客户端。
✓ 换网络后节点恢复正常看日志里是否有握手失败记录
把日志级别临时调到 debug，重新测速一次。日志里会出现具体失败原因：是超时、被拒绝，还是协议协商失败。这比盲猜快得多。
✓ 日志中定位到具体失败原因启动闪退：从架构查到残留
典型症状：双击图标无反应，或界面一闪而过，进程自动退出。
先确认架构是否匹配
Windows 看系统类型是 x64 还是 ARM64，macOS 看芯片是 Intel 还是 Apple Silicon。架构不匹配的典型表现就是双击无反应，不会报出明确错误。重新下载对应架构的安装包。
✓ 安装包架构与系统一致确认权限是否给足
部分客户端启动时需要管理员权限来创建虚拟网卡或写入配置目录。Windows 右键「以管理员身份运行」；macOS 在隐私与安全性中允许应用；Linux 检查可执行权限。
✓ 以管理员权限启动可正常打开排查旧版本残留冲突
旧版本卸载不干净时，残留的配置目录或内核文件会与新版本冲突。彻底卸载旧版本、清理配置目录，再重新安装新版本。
✓ 清理残留后重装可正常启动核对安装包是否完整
下载中断留下的半包，体积看起来差不多，但安装到一半会失败或启动时崩溃。对照发布页的体积与哈希值重新校验一次。
✓ 体积与哈希均与发布页一致界面卡顿：从日志查到配置
典型症状：客户端可用，但切换页面迟滞、测速时界面冻结、操作响应慢。
先把日志级别调回 info
debug 级别会持续写入大量日志，长时间开启会明显拖慢运行。排查完问题后记得切回 info，这一步常被忽略，却是卡顿的常见原因。
✓ 日志级别为 info检查配置复杂度是否过高
规则集过大、策略组嵌套过深、节点数量过多，都会让界面渲染变慢。可以临时换一份精简配置测试，确认是否与配置相关。
✓ 精简配置下卡顿明显缓解观察资源占用是否异常
打开系统任务管理器，观察客户端进程的内存与 CPU 占用。若持续偏高，可能是某个规则集在反复拉取，或订阅更新间隔设置过短。
✓ 资源占用回归正常区间确认版本本身是否稳定
如果以上都正常，可能是当前版本本身的问题。回退到上一个稳定版本，或换用稳定版分支，通常能直接解决。
✓ 换版本后界面恢复流畅Quick Fix · 速修台
六个动作，覆盖大半故障
很多故障不需要逐层排查，几个标准动作就能解决。下面按「出现频率」排序， 从最常见的开始试，通常前两三个就能命中。
更新订阅并重启客户端
节点下线和订阅过期是最高频的原因。手动触发订阅更新后重启客户端，多数「突然连不上」到此结束。
切换运行模式再切回规则
有时候是模式状态异常。切到全局、再切回规则，相当于让规则引擎重新加载一次，能解决不少「规则不生效」的问题。
换一个空闲端口
多代理工具共存时容易端口抢占。在参数设置里换一个未被占用的端口，重启后重新验证出口 IP。
重置系统代理开关
先关闭系统代理，等两秒再重新打开。这个动作会强制重写系统代理设置，解决「客户端显示已连接但浏览器不走代理」的问题。
同步系统时间
时间偏差会直接导致协议握手失败。在系统设置里开启自动同步，或手动同步一次，然后再测速。
备份配置后彻底重装
以上都无效时，先导出配置文件备份，然后彻底卸载、清理配置目录、重启系统、重新安装。这一步能解决绝大多数难以定位的残留冲突。
先备份，再卸载，别反过来Evidence · 日志取证
查不到原因时，先收集三样证据
故障排查最浪费时间的情况，是「说不清现象」。下面三样证据按顺序收集，通常一分钟内就能完成，却能让后续排查效率翻倍——无论是自己继续查，还是向他人求助。
第一样是出口 IP。打开任意查询出口 IP 的页面，记录当前显示的地区。这是判断「流量到底走没走代理」最直接的依据。很多问题在拿到这一条之后，答案就已经浮出来了。
第二样是内核日志。把日志级别临时调到 debug，重现一次故障，然后把日志导出。日志里会记录每条连接命中了哪条规则、握手在哪一步失败——这比反复猜测快得多。排查完记得把级别切回 info。
第三样是配置文件。导出当前使用的配置文件。多数情况下，问题就藏在某条规则或某个策略组的写法里。有了配置文件，可以在精简配置下对照测试，快速定位到具体是哪一段引起的。
log-level: debug → 重现故障 → 导出日志 → 切回 info
Audit · 修复复核
修完之后，回头核这四件事
问题暂时消失不等于已经解决。下面四道复核题，修完花一分钟过一遍， 能挡掉大多数「过两天又坏了」的情况。
问题现象是否完全消失
不只是「现在能用了」，而是原本复现故障的操作路径能稳定通过。建议用触发故障的同一个操作再试一次，确认不是偶然恢复。
根因是否已经明确
如果只是「重启了一下就好了」，而不知道具体原因，问题很可能再次出现。能说清是哪一步解决了问题，才算真正修完。
有没有留下临时改动
排查过程中可能改过日志级别、换过端口、切过模式。把临时改动恢复到正常状态，尤其是 debug 级别的日志，不切回来会持续拖慢运行。
配置有没有备份
无论问题是否解决，养成导出配置备份的习惯。下次遇到难以定位的问题时，可以直接用精简配置对照测试，排查效率会高很多。
Quick Check · 四个高频问题
检修时最常被问到的四件事
重启之后好了，还需要继续查吗？
如果只是偶发一次，可以观察。若同一问题反复出现，说明根因没找到，建议按对应路径逐层排查一次，避免临时恢复掩盖真正的问题。看排查路径 →
为什么强调「先分诊再排查」？
因为不同症状的排查起点完全不同。联网失败要从模式与订阅查起，启动闪退要从架构与权限查起。分诊做对，能省掉一半无效操作。看症状分诊 →
日志级别调高会影响使用吗？
排查期间短暂开启没问题，但 debug 级别会持续写入大量日志，长时间开启会明显拖慢客户端。排查完记得切回 info。看速修台 →
彻底重装会不会丢配置？
会，除非提前备份。正确顺序是：先导出配置文件，再卸载清理，最后重装并导入备份。顺序反了就得重新配置订阅与规则。看修复复核 →
Field Notes · 检修笔记
最新文章
连不上网的五步排查：从模式到出口 IP
按顺序走一遍，每一步都有可观察的结果，多数连接问题在第三步前就能定位。
节点失效所有节点全红：从订阅到系统时间的四条线索
订阅过期、节点下线、时间偏差、网络受限——四种原因对应四种处理方式。
运行报错启动闪退的三种原因：架构、权限与残留
双击没反应不一定是安装包坏了，先按这三条排除，再考虑重装。
性能界面卡顿的四个来源：日志、配置、资源与版本
从最容易忽略的日志级别开始查，多数卡顿问题不需要换客户端。
取证debug 日志怎么看：三条关键记录定位故障
握手失败、规则命中、DNS 解析——日志里最重要的三类信息各看什么。
进阶TUN 模式失效排查：权限、驱动与路由三处检查
开关拨了但没效果，多半卡在授权环节或驱动未安装，逐项确认即可。