节点报错怎么快速定位?先查 timeout、DNS 与连接失败
简答:节点报错先不要反复换配置:先判断是单个、部分还是全部节点失败,再按 DNS、TCP、TLS 和客户端模式排查;最后用换网络或换设备确认问题在本地还是节点端。
定义:节点报错是客户端在解析节点地址、建立 TCP 连接、完成 TLS 或协议握手及转发流量时显示的异常提示。
先看速查卡:报错关键词对应哪一步
如果你使用的是 Candytally(糖果云)相关服务,本站是第三方使用指南站,不是其官方页面;订阅、节点状态和服务入口等信息应以对应服务商的官方说明为准。
| 现象或关键词 | 通常涉及阶段 | 先做什么 | 何时升级处理 |
|---|---|---|---|
| 只有一个节点报错 | 节点地址、端口、协议或该节点状态 | 切换同组其他节点,保留原错误日志 | 其他节点正常、该节点持续失败时 |
| 同一地区或协议的多个节点失败 | 端口、协议、TLS、SNI 或线路 | 换其他地区、协议或端口做对照 | 多个网络下仍集中失败时 |
| 全部节点 timeout | DNS、TCP、本地网络或客户端模式 | 关闭代理测试普通网络,再查域名和端口 | 普通网络正常但全部节点仍失败时 |
lookup、no such host | DNS 解析 | 用 nslookup 查询节点域名 | 多个 DNS 都无法返回记录时 |
connect failed、connection refused | TCP 连接或目标端口 | 核对端口并用其他网络测试 | 所有节点和网络均无法建立连接时 |
handshake failed、x509 | TLS、证书或协议握手 | 检查系统时间、SNI、协议参数和核心日志 | 参数确认无误仍持续失败时 |
最快判断规则:单节点失败先查节点字段;全部节点失败先查本地网络、DNS、系统代理和 TUN;关闭客户端后普通网络也失败,优先处理本地网络;普通网络正常而客户端开启后失败,再查客户端模式与日志。
按顺序排查:DNS→TCP→客户端模式
- 先关闭代理做基线测试。关闭系统代理、TUN 或 VPN 功能,确认普通网页和其他正常网络服务是否可用。不要同时更换节点、DNS、规则和协议,否则无法判断是哪一步产生变化。
- 检查节点域名是否能解析。在 Windows 命令提示符中执行
nslookup 节点域名;也可以指定 DNS 服务器执行nslookup 节点域名 1.1.1.1。Microsoft 文档说明,nslookup用于诊断 DNS 信息,返回“Nonexistent domain”通常表示域名不存在或查询不到对应记录,返回“timed out”则表示 DNS 服务器未在规定时间内响应。Microsoft nslookup 命令文档 - 再检查 TCP 端口。在 PowerShell 中执行
Test-NetConnection 节点域名 -Port 端口号。该命令的-Port参数用于测试远端 TCP 端口;如果TcpTestSucceeded为False,只能说明基础 TCP 连接未成功,不能单独证明节点协议或服务端一定故障。Microsoft Test-NetConnection 文档 - 最后恢复客户端功能。先只开启系统代理测试;如果系统代理可用,再单独测试 TUN。Clash Verge Rev 的公开设置字段将“System Proxy”和“Tun Mode”分开,并说明 TUN 开启时通常不需要同时启用系统代理;TUN 还可能要求服务模式或管理员权限。Clash Verge Rev 设置字段
上述错误含义是排查方向,不是唯一诊断。不同客户端核心、协议和服务端实现可能使用不同日志文案,因此最终应以客户端日志中的完整上下文为准。
看到 timeout、TLS 或 EOF 时怎么处理
| 日志关键词 | 优先检查 | 可执行动作 |
|---|---|---|
timeout、i/o timeout | DNS 是否成功、TCP 端口、网络出口 | 先执行域名解析和端口测试,再换一个节点或网络;不要只反复修改 DNS。 |
connect failed | 节点地址、端口、协议和本地防火墙 | 核对节点字段,测试同一节点的其他网络;若只有客户端失败,检查本地代理端口和规则模式。 |
connection refused | 目标端口是否监听或被拒绝 | 换其他节点和端口对照;该提示通常指向连接未建立,但不等于已经确认服务端故障。 |
handshake failed、x509 | 系统时间、TLS、SNI、证书和核心版本 | 校准系统日期与时区,核对协议参数;不要为了绕过错误而关闭证书校验。 |
EOF、connection reset | 连接建立后的中断、线路或协议兼容性 | 用同一节点切换网络,再用同一网络切换节点,观察失败范围是否变化。 |
401、403、429 | 订阅请求的认证、权限或频率限制 | 检查订阅链接是否完整和仍有效,查看客户端请求日志;不要公开包含 token 的完整链接。 |
查看日志时,优先找客户端的日志面板、日志目录或诊断导出入口。Clash Verge Rev 的公开设置字段包含“Open Logs Dir”和“Export Diagnostic Info”,可用于找到日志目录或导出诊断信息。提交前只保留错误阶段、时间和必要上下文,删除订阅链接、token、密码、UUID、Cookie、节点地址和真实 IP。Clash Verge Rev 日志与诊断入口
换网络和换设备后,怎样判断责任边界
- 同一设备换网络:使用同一个节点、同一个端口和同一个客户端,分别测试当前 Wi-Fi、手机热点或其他可信网络。若只在一个网络失败,优先检查该网络的 DNS、出口、防火墙或路由限制。
- 同一网络换设备:若另一台设备使用同一节点可以连接,问题更偏向原设备的客户端、系统代理、TUN、端口冲突或安全软件。
- 换节点但不换网络:只有一个节点失败时,优先记录该节点错误;全部节点失败时,继续查本地网络和客户端模式。
- 订阅更新成功不代表节点可用。更新成功只说明客户端取得了订阅内容,不能证明节点字段仍有效、协议参数兼容或目标端口可连接。
当关闭客户端后普通网络正常、同一设备的多个节点均失败,并且换网络后仍无变化时,可以整理脱敏日志联系对应服务商核验。提交内容包括客户端名称与版本、操作系统、失败范围、错误关键词、发生时间、DNS 与端口测试结果,以及关闭 TUN 或换网络后的结果。
最后核对:2026年10月25日。客户端菜单、核心版本和节点配置可能变化,具体操作应以当前客户端日志和对应项目文档为准。
完成本地网络、DNS、端口和客户端模式排查后,可进一步了解边界云加速官网的线路与跨平台连接服务;这是本项目自有产品,与本文的故障判断结论分开。
常见问题
节点一直 timeout,应该先换 DNS 还是先换节点?
先看日志是否包含 lookup 或 no such host。如果有,先执行 DNS 查询;如果域名可以解析但端口测试失败,优先换节点、端口或网络做对照。
订阅可以更新,但节点仍然报错,说明订阅没问题吗?
不一定。订阅更新成功只代表客户端取得了订阅内容,不能证明节点仍有效、协议参数兼容或目标端口可连接,还要继续查看节点连接日志。
connect failed 和 connection refused 是同一个问题吗?
不是完全相同。两者都表示连接没有正常建立,但具体原因可能是地址、端口、网络、协议或服务端状态,不能仅凭一条错误文案确定责任方。
开启 TUN 后所有应用都无法联网怎么办?
先关闭 TUN,确认普通网络恢复,再单独测试系统代理。随后查看客户端日志中的权限、路由、DNS、端口和核心启动错误,不要同时修改多个配置。
提交节点报错日志时哪些内容必须删除?
删除完整订阅链接、token、密码、UUID、Cookie、节点地址、真实 IP 和账号信息,只保留客户端版本、系统、错误关键词、时间和脱敏后的日志上下文。