ERR-CASE 01
订阅无法导入 / 拉取配置文件失败
典型现象表现： 客户端提示网络超时、无法解析订阅域名、或提示 Invalid Profile YAML 格式错误。
推荐阶梯排查动作
- 检查复制的订阅链接是否含有首尾多余空格或换行符，核对 Token 是否完整。
- 临时关闭设备上的其他代理软件或系统全局代理，避免拉取请求被错误回环拦截。
- 在手机上尝试切换为蜂窝移动网络（4G/5G）重新导入，排查本地 Wi-Fi 路由拦截。
- 登录服务平台控制台，确认当前账户是否处于正常有效状态，尝试点击「重置订阅链接」。
ERR-CASE 02
节点连接超时 / 全部节点测速显示 Timeout
典型现象表现： 客户端节点测速列表全红，所有节点显示毫秒数超时，无法连通任何海外服务。
推荐阶梯排查动作
- 核对本机系统时间是否与互联网北京时间精确同步（时间偏差大于 30 秒会导致 TLS 握手彻底失败）。
- 在客户端内执行配置「Update/更新」，重新拉取节点列表以获取最新服务器 IP 和端口。
- 确认本地宽带是否正常，尝试在命令行 ping 本地网关或访问国内基础网站。
- 检查所选套餐流量配额是否已用尽（如岚图 150GB、梦图 300GB 或星图 600GB 是否到达账单上限）。
ERR-CASE 03
DNS 解析失败 / ERR_NAME_NOT_RESOLVED
典型现象表现： 能够连通 IP 地址，但浏览器打开任何域名均报错 DNS_PROBE_FINISHED_NXDOMAIN。
推荐阶梯排查动作
- 在 Windows 打开终端执行 ipconfig /flushdns 命令，彻底清空本机操作系统 DNS 解析缓存。
- 在客户端 DNS 配置中启用加密 DNS 解析（DoH 协议），填入 1.1.1.1 或 8.8.8.8。
- 检查客户端是否启用了 Fake-IP 模式，若与本地某些特殊开发环境冲突可临时切换为 Redir-Host 模式。
- 检查本地 C:\Windows\System32\drivers\etc\hosts 文件是否被残留注入了错误映射。
ERR-CASE 04
客户端显示已连接，但网页完全无法打开
典型现象表现： 节点延迟显示正常（绿色几百毫秒），但浏览器打不开任何网页，提示连接被拒绝。
推荐阶梯排查动作
- 检查系统代理是否生效：确认客户端内的「System Proxy」开关已处于开启状态。
- 检查本地端口占用：默认 HTTP/SOCKS 端口为 7890，排查是否有其他软件占用了该端口。
- 检查分流模式设置：确保运行模式为「Rule（规则分流）」而非「Direct（全部直连）」。
- 如果是 Windows 平台且仅 UWP 商店应用无法联网，使用客户端内置的「UWP Loopback」工具一键豁免。
ERR-CASE 05
系统代理冲突 / 关闭软件后电脑完全断网
典型现象表现： 退出或卸载客户端后，电脑所有浏览器均提示“无法连接到代理服务器”。
推荐阶梯排查动作
- 原因：客户端非正常退出，未能自动将 Windows 注册表的系统代理开关复原。
- 解决步骤 1：打开 Windows「设置 - 网络和 Internet - 代理」，关闭「使用代理服务器」开关。
- 解决步骤 2：或重新打开客户端，在界面内正常点击开启再关闭「System Proxy」即可自动修复注册表。
- 解决步骤 3：在浏览器设置中检查是否有第三方扩展插件强行锁定了 PAC 代理脚本。
ERR-CASE 06
网络环境切换异常 / Wi-Fi 与蜂窝网络切换后断连
典型现象表现： 手机从无线 Wi-Fi 离开切换到 5G 移动蜂窝数据，或电脑从有线网拔出后网络卡死。
推荐阶梯排查动作
- 移动端由于 IP 路由变更，虚拟网卡（VpnService）需要重新握手，手动开关一次客户端即可秒级恢复。
- 在 Android 客户端设置中勾选「网络变更自动重启路由」选项。
- 在公司或校园网环境下，确认当前局域网是否部署了严格的 802.1X 认证或深层网络审查。