排错大全
所有常见问题与修复路径的汇总入口。
无法连接
从 0 开始排查连接失败问题。
开启后没网
最常见的 10 个原因与解决方案。
DNS 问题
解析慢、打不开的定位与修复。
规则不生效
分流错误、直连失效的排查路径。
导入失败
配置或订阅无法导入的修复方向。
更新失败
版本更新或订阅更新的常见问题与解决。
配置不生效
配置更新后不生效：缓存与刷新该怎么做。
解析错误
配置导入失败/YAML 解析错误的 8 个常见原因。
订阅节点为空
订阅导入后没有节点的排查方法。
订阅更新失败
订阅更新失败的常见原因与修复。
TUN 模式没网
开启 TUN 后没网/断流的排查清单。
TUN DNS 问题
TUN 模式下 DNS 解析慢/打不开的设置建议。
TUN 权限提示
TUN 模式与系统权限提示的处理方法。
TUN 是否生效
如何确认 TUN 模式是否正常工作。
常见问题
为什么开启 ClashX 后无法上网？
通常是系统代理设置未正确应用。请检查'设置为系统代理'选项是否勾选，并确保节点连接测试通过。
软件提示无法启动内核怎么办？
这通常是权限问题。请在'安全与隐私'中授予 ClashX 必要权限，或重新安装。
节点显示延迟很高或超时？
可能是节点不稳定或本地网络干扰。建议切换节点或更换 DNS 配置。
卸载后系统依然无法连网？
系统代理开关没关。进入 macOS 设置 → 网络 → 代理，手动关闭 HTTP 和 HTTPS 代理。
M1/M2 芯片的 Mac 兼容吗？
完全兼容。ClashX 提供了 Apple Silicon 版本，运行流畅。
Dashboard 控制面板打不开？
请确认 ClashX 正在运行。检查配置文件中 External Controller 端口是否被占用。