ORBIT CLICK · TROUBLESHOOTING

网络故障排查中心|六类常见连接与配置异常分步自检

针对订阅导入失败、客户端无法连接、节点超时、DNS错误、系统代理冲突与网页无法打开六种常见情况,提供清晰的本地自检步骤(本页为静态排障手册,不执行任何后台自动测速或远程探测)。

互动式网络问题排查

点击选择当前遇到的网络或客户端现象

本工具为静态分步自检导航(不读取或测试您的真实网络状态)。请点击下方六种常见异常之一,展开对应的产生原因分析与分步排查教程。

配置拉取异常

订阅导入失败 · 排查指南

典型表现:在客户端点击“下载/导入配置”后,提示 Network Error、Invalid Config、YAML 解析失败或长时间卡在拉取状态无法生成节点列表。

常见触发原因

  • 误将服务商的“注册/登录网页地址”当作客户端专属订阅链接填入导入框。
  • 复制订阅链接时遗漏了末尾参数,或前后端夹带了多余的空格与中文标点。
  • 开启了旧的代理开关去拉取订阅,而旧代理本身已失效,导致拉取请求被阻断。
  • 订阅格式与客户端不匹配(例如将其他协议专用的链接直接导入仅支持 YAML 的客户端)。

推荐分步排查顺序

步骤 1:核对链接性质与完整性

确认您复制的是服务后台仪表盘中的“客户端订阅地址(Subscription URL)”,而非注册推广链接。将其粘贴到记事本检查是否完整以 https:// 开头且无空格。

步骤 2:先关闭系统代理再执行导入

在客户端主界面先关闭“系统代理(System Proxy)”与“TUN/VPN 开关”,使用本地纯净直连网络重新点击下载订阅。

步骤 3:切换手机热点辅助拉取

若当前家庭宽带或校园网 DNS 无法解析订阅服务器域名,可临时将设备连接至手机 4G/5G 热点完成首次配置拉取,成功后再切回原 Wi-Fi。

启动报错 / 端口占用

客户端无法连接 · 排查指南

典型表现:客户端虽然已成功导入配置文件,但打开“系统代理”或“启动 VPN”开关时立即自动弹回关闭状态,或提示本地端口(如 7890)被占用、核心进程启动失败。

常见触发原因

  • 电脑或手机后台同时运行了另一款代理工具、加速器或安全过滤软件,占用了相同本地监听端口。
  • 杀毒软件或系统防火墙误拦截了客户端底层转发内核(如 clash-core 或虚拟网卡驱动)。
  • 移动端未授予客户端创建本地 VPN 配置的系统权限,或权限被安全管家重置。

推荐分步排查顺序

步骤 1:排查并关闭冲突进程

打开任务管理器(Windows)或活动监视器(macOS),检查是否有残留的同类代理进程、游戏加速器或抓包软件,将其完全退出后重试。

步骤 2:修改本地混合监听端口

在客户端“常规(General)”设置中,将 Mixed Port / HTTP Port 从默认的 7890 修改为其他未占用端口(例如 7895 或 10808),重启客户端再开启系统代理。

步骤 3:核查防火墙与管理员权限

若需开启 TUN 虚拟网卡模式,请右键客户端图标选择“以管理员身份运行”,并在系统防火墙提示中勾选放行专用与公用网络。

Timeout / 握手失败

节点超时 · 排查指南

典型表现:在客户端策略组点击延迟测试(URL Test)时,大量或全部节点显示红色 Timeout(超时),无法建立有效加密连接。

常见触发原因

  • 设备本地系统时间与标准时间偏差超过 30 秒,导致加密协议 TLS 证书与时间戳校验直接拒绝握手。
  • 套餐月度流量已耗尽或订阅账期已到期,服务端暂停了节点转发权限。
  • 长期未更新订阅配置,原节点入口地址或端口已在服务端完成维护变更。
  • 所处局域网(如部分企业内网、校园网)严格封锁了非标准高危端口或 UDP 流量。

推荐分步排查顺序

步骤 1:校准操作系统时间

进入系统日期与时间设置,开启“自动设置时间”并手动点击一次“立即同步(Sync Now)”,确认时区为 UTC+8 且秒数准确。

步骤 2:登录后台核对剩余流量与有效期

通过浏览器直连登录服务商后台,检查当前套餐(如 100GB / 250GB / 500GB)是否仍有剩余额度,账期是否处于有效状态。

步骤 3:执行订阅更新并切换节点地区

在客户端“配置(Profiles)”界面点击“更新(Update)”按钮同步最新节点参数,随后在策略组中尝试切换不同地区的节点进行对比测试。

域名无法解析

DNS错误 · 排查指南

典型表现:客户端显示节点延迟正常,通讯软件可收发纯文本,但浏览器打开网页时报错 DNS_PROBE_FINISHED_NXDOMAIN 或提示找不到服务器 IP 地址。

常见触发原因

  • 本地路由器或运营商默认 DNS 服务器响应缓慢、返回了过期或错误的解析记录。
  • 浏览器内置的“安全 DNS(DNS over HTTPS)”与客户端的 Fake-IP 解析模块发生冲突。
  • 近期频繁切换网络环境(如从公司 Wi-Fi 切换到家庭网络),操作系统缓存了失效的 DNS 记录。

推荐分步排查顺序

步骤 1:清理本机 DNS 解析缓存

在 Windows 命令提示符运行 ipconfig /flushdns(macOS 可运行 sudo killall -HUP mDNSResponder),手机端可开关一次飞行模式刷新网络栈。

步骤 2:调整浏览器安全 DNS 设置

打开 Chrome 或 Edge 浏览器“设置 -> 隐私和安全 -> 安全”,找到“使用安全 DNS”选项,尝试将其关闭或改为使用当前服务提供商,随后重启浏览器。

步骤 3:检查客户端配置中的 DNS 开关

确保未手动破坏订阅配置文件内置的 dns 段落;若使用 TUN 模式,确认客户端内的 DNS 劫持(DNS Hijack)保持默认开启状态。

端口劫持 / 浏览器断网

系统代理冲突 · 排查指南

典型表现:开启客户端后只有部分软件能联网,或者关闭客户端后整个电脑浏览器完全无法打开任何国内与国外网站(提示代理服务器拒绝连接)。

常见触发原因

  • 上次非正常关机或强制结束客户端进程,导致操作系统注册表中的系统代理地址(本地监听端口)未能自动清除。
  • 浏览器安装了 SwitchyOmega、AdGuard 等代理管理扩展,扩展内部指向了错误的本地端口,覆盖了系统级设置。
  • 同时开启了客户端的“系统代理”和另一软件的“全局 VPN”,导致流量在本地形成回环。

推荐分步排查顺序

步骤 1:手动重置操作系统代理设置

打开系统“网络和 Internet -> 代理设置”,若当前未运行客户端,请手动将“使用代理服务器”开关设为“关闭”并保存。

步骤 2:将浏览器代理插件切换为“[系统代理]”

检查浏览器右上角是否有代理扩展图标,将其工作模式切换为“系统代理(System Proxy)”或暂时禁用该扩展,交由桌面客户端统一接管。

步骤 3:规范退出客户端流程

日常关机或退出客户端前,先在客户端主界面取消勾选“系统代理(System Proxy)”,再通过托盘右键菜单选择“退出(Quit)”。

分流规则或策略误选

网页无法打开 · 排查指南

典型表现:客户端连接状态正常、系统代理已开启、其他网站均可正常访问,唯独某一个或某一类特定网站一直转圈无法加载或提示拒绝访问。

常见触发原因

  • 客户端出站模式被误设为了“直连(Direct)”,导致本应走代理的目标网站直接从本地网络发起请求而失败。
  • 在 Clash / ClashParty 策略组中,对应的专项策略组被手动选为了 DIRECT 或 REJECT。
  • 目标网站对当前所选节点的出口 IP 实施了访问频率限制或区域限制。

推荐分步排查顺序

步骤 1:检查客户端顶层出站模式

确认客户端主模式处于“规则(Rule)”模式;若特定新域名尚未收录进分流规则列表,可临时切换至“全局(Global)”模式测试能否打开。

步骤 2:核查客户端实时连接日志(Connections / Logs)

打开客户端的“连接(Connections)”面板,刷新目标网页,观察该域名命中的规则链(Rule Chain)最终指向了哪个策略组与节点。

步骤 3:更换策略组内的不同区域节点

若连接日志显示已走代理但仍被目标网站拒绝,可在对应策略组内切换至其他地区或不同编号的节点,然后用浏览器无痕窗口重新访问。

完整排障手册归档

六项异常现象速查一览表

您也可以直接向下滚动阅读全部六类故障的触发原因与处理流程。

CASE 01 配置拉取异常

订阅导入失败

在客户端点击“下载/导入配置”后,提示 Network Error、Invalid Config、YAML 解析失败或长时间卡在拉取状态无法生成节点列表。

步骤 1:核对链接性质与完整性: 确认您复制的是服务后台仪表盘中的“客户端订阅地址(Subscription URL)”,而非注册推广链接。将其粘贴到记事本检查是否完整以 https:// 开头且无空格。
步骤 2:先关闭系统代理再执行导入: 在客户端主界面先关闭“系统代理(System Proxy)”与“TUN/VPN 开关”,使用本地纯净直连网络重新点击下载订阅。
步骤 3:切换手机热点辅助拉取: 若当前家庭宽带或校园网 DNS 无法解析订阅服务器域名,可临时将设备连接至手机 4G/5G 热点完成首次配置拉取,成功后再切回原 Wi-Fi。
CASE 02 启动报错 / 端口占用

客户端无法连接

客户端虽然已成功导入配置文件,但打开“系统代理”或“启动 VPN”开关时立即自动弹回关闭状态,或提示本地端口(如 7890)被占用、核心进程启动失败。

步骤 1:排查并关闭冲突进程: 打开任务管理器(Windows)或活动监视器(macOS),检查是否有残留的同类代理进程、游戏加速器或抓包软件,将其完全退出后重试。
步骤 2:修改本地混合监听端口: 在客户端“常规(General)”设置中,将 Mixed Port / HTTP Port 从默认的 7890 修改为其他未占用端口(例如 7895 或 10808),重启客户端再开启系统代理。
步骤 3:核查防火墙与管理员权限: 若需开启 TUN 虚拟网卡模式,请右键客户端图标选择“以管理员身份运行”,并在系统防火墙提示中勾选放行专用与公用网络。
CASE 03 Timeout / 握手失败

节点超时

在客户端策略组点击延迟测试(URL Test)时,大量或全部节点显示红色 Timeout(超时),无法建立有效加密连接。

步骤 1:校准操作系统时间: 进入系统日期与时间设置,开启“自动设置时间”并手动点击一次“立即同步(Sync Now)”,确认时区为 UTC+8 且秒数准确。
步骤 2:登录后台核对剩余流量与有效期: 通过浏览器直连登录服务商后台,检查当前套餐(如 100GB / 250GB / 500GB)是否仍有剩余额度,账期是否处于有效状态。
步骤 3:执行订阅更新并切换节点地区: 在客户端“配置(Profiles)”界面点击“更新(Update)”按钮同步最新节点参数,随后在策略组中尝试切换不同地区的节点进行对比测试。
CASE 04 域名无法解析

DNS错误

客户端显示节点延迟正常,通讯软件可收发纯文本,但浏览器打开网页时报错 DNS_PROBE_FINISHED_NXDOMAIN 或提示找不到服务器 IP 地址。

步骤 1:清理本机 DNS 解析缓存: 在 Windows 命令提示符运行 ipconfig /flushdns(macOS 可运行 sudo killall -HUP mDNSResponder),手机端可开关一次飞行模式刷新网络栈。
步骤 2:调整浏览器安全 DNS 设置: 打开 Chrome 或 Edge 浏览器“设置 -> 隐私和安全 -> 安全”,找到“使用安全 DNS”选项,尝试将其关闭或改为使用当前服务提供商,随后重启浏览器。
步骤 3:检查客户端配置中的 DNS 开关: 确保未手动破坏订阅配置文件内置的 dns 段落;若使用 TUN 模式,确认客户端内的 DNS 劫持(DNS Hijack)保持默认开启状态。
CASE 05 端口劫持 / 浏览器断网

系统代理冲突

开启客户端后只有部分软件能联网,或者关闭客户端后整个电脑浏览器完全无法打开任何国内与国外网站(提示代理服务器拒绝连接)。

步骤 1:手动重置操作系统代理设置: 打开系统“网络和 Internet -> 代理设置”,若当前未运行客户端,请手动将“使用代理服务器”开关设为“关闭”并保存。
步骤 2:将浏览器代理插件切换为“[系统代理]”: 检查浏览器右上角是否有代理扩展图标,将其工作模式切换为“系统代理(System Proxy)”或暂时禁用该扩展,交由桌面客户端统一接管。
步骤 3:规范退出客户端流程: 日常关机或退出客户端前,先在客户端主界面取消勾选“系统代理(System Proxy)”,再通过托盘右键菜单选择“退出(Quit)”。
CASE 06 分流规则或策略误选

网页无法打开

客户端连接状态正常、系统代理已开启、其他网站均可正常访问,唯独某一个或某一类特定网站一直转圈无法加载或提示拒绝访问。

步骤 1:检查客户端顶层出站模式: 确认客户端主模式处于“规则(Rule)”模式;若特定新域名尚未收录进分流规则列表,可临时切换至“全局(Global)”模式测试能否打开。
步骤 2:核查客户端实时连接日志(Connections / Logs): 打开客户端的“连接(Connections)”面板,刷新目标网页,观察该域名命中的规则链(Rule Chain)最终指向了哪个策略组与节点。
步骤 3:更换策略组内的不同区域节点: 若连接日志显示已走代理但仍被目标网站拒绝,可在对应策略组内切换至其他地区或不同编号的节点,然后用浏览器无痕窗口重新访问。