疑难解答中心：快速排查常见问题
这里汇集了用户最常遇到的错误与解决方法，涵盖连接异常、配置故障、安装报错及性能调优等场景。您可以通过搜索或分类标签快速定位答案。
首先检查托盘图标是否为活跃状态（绿色或蓝色），确认节点延迟正常。其次排查系统代理设置是否被其他软件篡改，可尝试在设置中开启“代理守卫”功能。若问题依旧，请在日志中查看是否有 DNS 解析错误或 TUN 模式冲突。
- macOS：检查“系统偏好设置 → 网络 → 高级 → 代理”中是否被正确配置为 127.0.0.1:7890。
- Windows：检查“Internet 选项 → 连接 → 局域网设置”中代理开关状态。
这通常是因为规则配置未涵盖目标域名，或者节点被目标网站屏蔽。请检查“规则”面板中的实时日志，确认请求是否被正确匹配。您可以手动为这些域名添加 DOMAIN-SUFFIX 规则，或切换至其他节点尝试。
请确认订阅链接是否有效且未过期。ClashX 支持标准的 Clash 配置格式，若链接返回非标准内容会解析失败。可尝试在浏览器中直接打开链接测试，或使用二维码扫描导入。若链接需要 User-Agent 校验，请在订阅设置中自定义请求头。
规则匹配从上到下，命中即停止。请检查规则顺序，将更具体的规则放在前面。使用“规则”面板中的实时日志查看流量匹配情况，确认目标域名或IP是否被正确捕获。另外，请确保规则语法无误，如逗号后无多余空格。
这是开源软件的常见现象，因为未购买昂贵的商业代码签名证书。请点击“更多信息”然后选择“仍要运行”。所有安装包均通过 GitHub Actions 自动构建，您可以在发布页面核对 SHA-256 指纹以确保文件完整性。
前往“系统偏好设置 → 安全性与隐私 → 通用”，点击底部的“仍要打开”。或者在终端执行 sudo spctl --master-disable 允许任何来源后再次尝试打开。
可能是规则集过大或日志级别设置过高导致。尝试精简规则数量，关闭不必要的脚本引擎，并在设置中将日志等级调整为“警告”或“错误”。更新至最新版本通常能修复已知的性能缺陷。如果开启了 TUN 模式，可尝试调整 MTU 值。
TUN 模式需要管理员权限，请确保已安装服务模式。若虚拟网卡冲突，可尝试重启电脑或在设备管理器中清理旧虚拟适配器。同时检查防火墙/安全软件是否拦截了 ClashX 的网络活动。在 Linux 上，请确认内核已加载 tun 模块。