ClashX 无法连接怎么办？从 0 开始排查
快速结论
ClashX 无法连接的修复步骤：1. 检查订阅是否过期；2. 同步 macOS 系统时间；3. 开启全局模式（Global）测试；4. 更新至 ClashX 最新版。
ClashX 连接失败的深度剖析
当你发现 ClashX 开启后，不仅国外网站打不开，连节点测速也全是红色或 Timeout 时，说明你的代理链条在某个环节断裂了。
第一步：检查基础环境
- 节点可用性：进入控制面板，观察节点名称后的延迟数值。如果全是
Timeout，说明你的订阅链接可能已失效，或当前网络无法通达代理服务器。 - 系统时间同步：ClashX 所使用的协议对时间同步要求极高。如果 macOS 的系统时间与真实时间偏差超过 30 秒，连接将直接失败。请在“系统设置”中重新同步时间。
- 端口冲突：默认情况下，ClashX 使用 7890 端口。如果有其他程序占用了该端口，ClashX 将无法启动代理服务。
第二步：检查代理模式
- 全局模式测试：将出站模式切换为“全局（Global）”，并手动选择一个确定有效的节点。如果此时可以上网，说明你的“规则（Rule）”配置有误，或者分流策略没有正确匹配。
- 直连测试：如果切换到“直连（Direct）”也无法上网，说明 ClashX 强行接管了流量但解析失败。请查看 ClashX 没网排查指南。
第三步：查阅日志寻找线索
日志是解决问题的终极武器。点击 ClashX 菜单栏图标 -> 控制面板 -> 日志（Logs）。
context canceled：通常是连接建立时被中断。handshake error：可能是协议参数（如加密方式、UUID）配置不正确。connection reset by peer：连接被远端服务器或防火墙重置。
解决无法连接的进阶建议
如果你多次尝试修复仍未成功，可能是由于 ClashX 基础版在处理某些复杂网络环境时的局限性。
切换至 ClashX Pro
ClashX Pro 提供了更强大的 TUN 模式。它不依赖于 macOS 的系统代理设置，而是虚拟出一块网卡。这种方式能强制捕获所有流量，绕过绝大多数由第三方软件冲突引起的“无法连接”问题。
重置配置文件
有时 config.yaml 文件会因为非法字符或缩进错误导致解析异常。尝试删除原有配置，重新通过 URL 导入或手动粘贴。
仍未解决？
如果节点依然显示无法连接，建议尝试下载最新的安装包进行覆盖安装，以修复可能损坏的底层二进制文件。
常见问题
这通常由节点失效、配置语法错误或系统时间不对引起。请首先更新订阅并同步 macOS 系统时间。
打开控制面板，对所有节点进行延迟测试（Ping）。如果全部超时（Timeout），多半是配置或网络权限问题。
这是服务器拒绝连接。请检查订阅链接是否过期，或账号流量是否已耗尽。
请确保没有其他代理软件（如 V2RayU, Surge）同时开启，它们会竞争 macOS 的系统代理控制权。
是的，macOS 自带防火墙或第三方安全软件（如 Little Snitch）可能拦截 ClashX 的出站连接。请将 ClashX 加入白名单。
如果基础连接没通，导入远程配置会失败。建议先手动导入本地 YAML 文件建立初始连接。