检查策略
确认当前模式和节点选择符合预期。全局策略仍为直连时，应先纠正这一项。
连接遇到问题，从现象开始。
Clash Mi，
让排查有迹可循。
先确认发生了什么，再检查对应设置。
这里整理维护者文档中的常见处理方向，以及可信的客户端下载入口。
你遇到的是哪一种？
CASE 01 / CONFIGURATION
配置加不进去，
先检查格式和来源。
Clash Mi 需要 Clash 格式配置，常见扩展名为 .yml 或 .yaml。非 Clash 格式的订阅，即使能够在浏览器打开，也不代表可以直接导入。
- 确认链接有效。检查是否复制完整，以及服务提供方是否仍提供该地址。
- 确认返回格式。请求 Clash YAML，而不是其他客户端专用的订阅。
- 检查 UserAgent。部分服务方根据客户端标识返回不同格式，按其要求设置。
如果错误信息包含 YAML 行号，应处理对应配置内容；反复重新安装通常无法修复同一份错误配置。
CASE 02 / NO TRAFFIC
开关已打开，
不代表代理策略已选好。
如果使用全局模式，检查「代理 → GLOBAL」。官方文档指出默认选项可能是直连，需要将其切换为有效节点或相应策略组。
检查 TUN
流量为零时再核对 TUN 的启用及覆写设置；Windows 出现权限错误时，以管理员身份重新启动应用。
CASE 03 / IOS DISCONNECT
立即断开，
也可能与规则规模有关。
官方 FAQ 将 iOS 连接后立即断开的一种原因归于 VPN 扩展的内存使用限制。维护者建议减少 geosite、geoip 等规则数量，或改用 MRS 格式规则集。
这是一条排查方向，不是对所有断开情况的统一诊断。先记录错误表现及配置变更，再参照官方说明处理；不要一次删除所有配置而失去比较依据。
MORE TROUBLESHOOTING NOTES
具体问题，具体处理。
连接开关打开了，流量一直为零，先看哪里？
官方 FAQ 建议检查 TUN 是否覆写并启用；Windows 启用 TUN 时需要管理员权限。如果 TUN 配置完全来自订阅，应先确认订阅配置是否正确，避免把不同来源的设置混为一谈。
只有部分手机应用无法联网，是什么方向？
检查「附加 HTTP 代理到 VPN」设置。官方说明部分应用对系统代理的处理不同，可能需要关闭，也可能需要开启；每次只调整一个选项并重新连接验证。
Geo Ruleset 可以手动更新吗？
官方 FAQ 说明 Geo Ruleset 不支持手动更新，可在核心设置中的 Geo Ruleset 更新时间间隔配置自动更新。不要反复点击面板里不可用的更新操作。
macOS 自动更新后应用打不开怎么办？
官方 FAQ 提供的一种处理方式是从官网重新下载 DMG 后安装。先核对官方来源和系统要求，不要将未知来源的修复脚本作为常规解决办法。
可以更换延迟测试地址吗？
可以。官方列出的入口是「应用设置 → 延迟测试 URL」。如果测试结果异常，先检查该地址本身是否可访问，再判断节点是否存在问题。
非本机访问面板需要什么？
官方说明 Clash Mi 强制使用设备唯一的面板 secret。即使允许非本机访问，访问方也必须提供有效 secret。不要公开该凭据；只在确有需要时开放访问。
如何让别人更容易复现问题？
记录系统版本、Clash Mi 版本、出现问题的具体操作与原始错误信息，并说明最近是否修改配置或更新应用。公开反馈前去掉订阅令牌、口令和个人账号信息。
GET THE ORIGINAL CLIENT
需要安装或更新 Clash Mi？
从维护者渠道获取应用。
先留存可恢复的配置，再更换版本。
iPhone / iPad
iOS 15+
官方 App Store 页面
电脑与 Android
Windows 10+ · macOS 12+ · Android 8+
Linux：amd64，内核 6+
检查版本变化
latest 指向正式发行记录。
Pre-release 表示测试版本。
仍然没有解决？
把系统、版本、操作步骤与脱敏后的报错整理到一起，再查阅项目 Issue，能让沟通更有效。