Clash无法连接:常见报错对应哪个阶段

下载配置阶段

当你在客户端粘贴订阅链接并点击“下载/导入”时遭遇报错,意味着网络通信尚未到达本地核心,问题完全出在你与订阅分发服务器之间的 HTTP 会话中:

典型错误日志关键字 技术根因分析 立即修复操作方案
connect: connection refused 订阅服务器域名解析错误,或服务端 80/443 端口未开放 检查订阅 URL 域名拼写,确认订阅服务器是否处于维护状态
certificate has expired / x509: certificate 订阅服务器 HTTPS 证书过期,或本机系统时间与网络标准时间相差超过 5 分钟 同步本机操作系统时钟(Windows/Mac 开启自动同步时间)
status code: 502 / 504 Bad Gateway 机场订阅后端 Nginx 无法连通分发集群 联系机场客服,或等待订阅服务商重启集群缓存
empty response / EOF 该订阅链接遭遇本地运营商阻断,或账户已欠费停机 使用手机热点尝试下载,或登录机场官网后台检查套餐流量是否耗尽

加载配置阶段

配置下载成功,但在客户端点击激活或启动核心时,弹出红色警告无法启动:

典型错误日志关键字 技术根因分析 立即修复操作方案
bind: address already in use 本地 mixed-port 端口(如 7890)已被其他旧版 Clash、v2rayN 或系统服务占用 在任务管理器中彻底结束残留的 clash/mihomo 进程,或在设置中将端口改为 7895
yaml: line X: mapping values are not allowed here YAML 格式缩进语法错误(例如使用了中文全角空格,或冒号后缺少半角空格) 定位报错行数,使用标准代码编辑器将缩进修正为 2 个半角空格
proxy [xxx] not found in proxy-group [yyy] 策略组引用的节点名称在 proxies 列表中不存在(拼写不一致) 核对组内 proxies 数组中的名字与上方声明的节点名称是否逐字吻合

节点连接与目标请求阶段

客户端显示正常运行,但浏览器提示“无法访问此网站 / ERR_CONNECTION_RESET / 500 Internal Error”。 此时需要进入 Clash 控制面板的“连接(Connections)”与“日志(Logs)”界面:

典型错误日志关键字 技术根因分析 立即修复操作方案
dial proxy xxx error: i/o timeout 你与该机场中继服务器之间的 TCP/UDP 链路超时,该节点已离线或当前网络阻断 在策略组中切换至其他低延迟可用节点
handshake failed: bad password / crypto error 客户端核心与服务端协议握手认证失败,密码或 UUID 凭据失效 在客户端重新刷新拉取最新订阅,更新节点密钥
DNS timeout / NXDOMAIN 上游 nameserver 无响应,导致域名无法生成 Fake-IP 映射 在 DNS 设置中将 nameserver 改为公共 DNS(如 223.5.5.5 与 119.29.29.29)

用最小示例核对概念

通过调用 Clash 核心的本地日志接口,可直观捕获报错发生在握手还是目标响应阶段:

核心错误日志实时捕获与复现

            
1 # 通过核心 external-controller 实时监听错误日志流
2 curl -s "http://127.0.0.1:9090/logs?level=error"
{"type":"error","payload":"[TCP] dial [示例-香港IPLC-01] (103.145.12.88:8388) to google.com:443 error: dial tcp 103.145.12.88:8388: i/o timeout"}
{"type":"error","payload":"[DNS] resolve fallback domain failed: context deadline exceeded"}
📖 互补阅读计划

理解错误词义后,若遇到配置语法正确但规则依然不生效的复杂场景,可参考规划链接:
https://clashknow.blog/config-check/(核对实际加载和覆盖配置)。本链接为互补规划链接,目标在正式上线并核对正文后全面启用。