客户端常见报错对照表：timeout、TLS、证书、DNS 解析失败怎么处理

先给结论：客户端的报错措辞会因软件和版本而不同，但背后的原因大致就那么几类：网络不通、域名解析失败、时间不对、协议不匹配、订阅失效。先识别报错属于哪一类，再对应排查，比反复换节点有效得多。

说明：下表里的英文提示是常见的写法示例，实际显示可能略有差异。判断时看关键词即可。

报错对照表

常见提示（关键词）	通常的含义	先查什么
`i/o timeout`、`context deadline exceeded`、`timeout`	连接超时，一直没等到对方回应	本地网络是否正常；节点是否暂时不可达；换同地区其他节点
`connection refused`	对方明确拒绝了连接	节点端口可能已关闭或变更；更新订阅后重试
`no such host`、`lookup ... failed`、`dns resolve failed`	域名解析失败，找不到对应 IP	本地 DNS 是否异常；订阅里的节点域名是否能解析；见 DNS 泄露
`x509: certificate`、证书错误、`certificate has expired`	证书校验失败	先校准系统时间；确认不是被中间人干扰；不要忽略证书警告
`tls: handshake failure`、`handshake timeout`	TLS 握手没成功	换节点或换协议；检查客户端版本；排除网络干扰
`EOF`、`unexpected EOF`、`connection reset`	连接被中途断开或重置	节点不稳定或网络被重置；换节点，多观察几次
`unsupported proxy type`、`unknown proxy type`	客户端内核不支持节点用的协议	升级客户端；换支持该协议的内核
`yaml: unmarshal errors`、`parse failed`、`profile parse failed`	配置格式不对，解析失败	订阅内容是否完整；格式是否与客户端兼容，见 Clash 导入报错
订阅更新 `401` / `403`	没有权限或链接被拒绝	链接是否完整；是否被重置或封禁；联系客服
订阅更新 `404`	找不到这个订阅地址	链接是否已失效、是否复制错误；重新获取
订阅更新 `429`、`too many requests`	更新太频繁被限制	稍等一段时间再更新，别反复点击
`network is unreachable`、`no route to host`	本地网络本身不通	先排查本机网络、Wi-Fi、路由器

通用排查顺序

不管报错是什么，都可以按这个顺序走一遍：

先不开代理，确认本机能正常上网；
校准系统时间（时间偏差会导致证书和部分协议失败）；
更新订阅，确认节点列表正常；
升级客户端到较新版本；
换一个节点，同地区再试一个；
换协议或换模式（规则 / 全局）；
重启客户端和设备；
仍然不行，联系服务商客服。

系统性的排查流程见机场连不上、网页打不开怎么排查。

一类一类说清楚

超时类（timeout）

超时意味着“没等到回应”。可能是你的网络问题，也可能是节点暂时不通，还可能是线路拥堵。如果所有节点都超时，多半是本地网络、系统时间或订阅过期；如果只有个别节点超时，换节点就行。

DNS 解析类（no such host）

节点往往用域名，客户端先要把域名解析成 IP。解析失败时，先换一个可靠的 DNS，或检查是否因为代理未启动而无法解析节点域名。更新订阅有时也需要先让客户端能访问订阅地址。

证书与 TLS 类

证书错误最常见的原因是系统时间不对：设备时间偏差很大，证书会被判断为“还没生效”或“已过期”。其次才是网络干扰。不要为了“能连上”而关闭证书校验，这会带来安全风险。

协议不匹配类（unsupported / unknown proxy type）

节点用了较新的协议，而客户端内核较旧。升级客户端通常就能解决；协议基础见机场协议对比。

订阅失效类（401 / 403 / 404）

这类问题的根源在订阅链接本身：被重置、过期、复制不完整、被限制。先登录服务商后台，确认套餐状态并重新复制订阅链接，再导入。

联系客服时请带上这些信息

把下面的信息一起发给客服，能大幅缩短排查时间：

报错的原文或截图（遮住订阅链接和令牌）；
使用的客户端名称与版本，设备和系统；
出现问题的时间、持续多久、是否固定在某个时段；
具体是哪个节点，换节点后是否仍然如此；
是否开启了系统代理或 TUN 模式；
你已经尝试过的步骤。

不要这样做

把完整的订阅链接发给陌生人“帮忙看看”；
为了绕过报错而关闭证书校验；
下载来源不明的“修复工具”，见梯子软件下载安全；
反复高频更新订阅，容易触发限制。