HELP DESK
TAG WORKSPACE 网络自检排查手册
遇到节点不通或网页打不开？请勿慌乱。按照我们梳理的8类常见故障场景，对照现象排查原因并执行标准化修复步骤。
排查原则提示： 本手册仅提供通用客户端软件与操作系统网络层面的静态逻辑自检方案。本站不执行任何未经授权的实时网络嗅探或数据探测；排查步骤旨在帮助访客理清本地网关、DNS与代理模式的冲突。
1. 配置链接无法导入 / 格式解析错误
故障典型表现： 点击下载时客户端弹出“Invalid YAML Syntax”、“Unsupported format”或“Connection Refused”。
可能的原因分析
- 误将注册推广网址、购买结账页网址当做客户端订阅链接复制。
- 复制时遗漏了开头的 https:// 或末尾包含授权鉴权的 token 字符串。
- 本地网络直接阻断了托管订阅服务器的域名解析。
推荐排查与解决顺序
- 重新登录订阅服务商的用户控制台，在“我的服务/仪表盘”中点击“复制订阅地址”或“Clash一键导入”。
- 在浏览器地址栏手动粘贴该链接进行测试，确认是否会提示下载一个文本文件或弹出包含 base64 内容的页面。
- 若提示无法连接该域名，可临时开启手机热点或在系统 DNS 中配置 223.5.5.5 后重试。
2. 订阅已导入，但点击更新频繁失败
故障典型表现： 已有节点列表变灰，点击“Update”转圈很久后提示“Network Error”或“Timeout”。
可能的原因分析
- 更新请求本身被客户端自身设置的代理规则死锁拦截。
- 当前所使用的出口节点已全部失效，导致无法访问外部订阅刷新接口。
- 外部 API 服务商实施了短时频控（短时间内被多台设备频繁刷新）。
推荐排查与解决顺序
- 在客户端控制台，将代理模式临时切换为“直连 (Direct)”或关闭“系统代理”，使更新请求绕过本地代理。
- 检查当前订阅是否已过期，若已到期请前往平台续费激活。
- 避开高峰并发期，间隔 5-10 分钟后再次点击手动更新。
3. 节点连接失败、大面积超时 / 测速全红为零
故障典型表现： 节点列表中点击延迟测试全部显示“Timeout”或“-1ms”，客户端提示网络连接失败。
可能的原因分析
- 本地系统时间与国际标准时间偏差超过 90 秒，导致加密 TLS 握手认证被强制拒绝。
- 本地 Wi-Fi 路由器的 UDP/TCP 转发端口被异常占用或挂死。
- 客户端内核核心程序崩溃或被杀毒软件误杀拦截。
推荐排查与解决顺序
- 【极重要】在 Windows 或 Mac 系统设置中，找到“日期与时间”，手动点击“立即同步”以矫正时区与秒数。
- 重启客户端软件；若仍未恢复，重启本地无线路由器与光猫。
- 临时切换至手机 4G/5G 个人热点对比测试，排除运营商光纤突发故障。
4. DNS 解析失败 / 域名无法转换为 IP
故障典型表现： 命令行 ping 域名提示“找不到主机”，浏览器报错“ERR_NAME_NOT_RESOLVED”。
可能的原因分析
- 本地运营商（ISP）实施了 DNS 劫持污染，返回了错误甚至虚假 IP。
- Clash 客户端开启了 TUN 模式但 Fake-IP 模块与本地安全软件冲突。
- 系统网络适配器中残留了失效的历史静态 DNS 服务器地址。
推荐排查与解决顺序
- 进入客户端“DNS 设置”，开启“加密 DNS (DoH/DoT)”，填入阿里公共 DNS (https://dns.alidns.com/dns-query) 或 Cloudflare DNS。
- 在 Windows 终端执行 `ipconfig /flushdns` 刷新本地操作系统 DNS 缓存。
- 若使用 Fake-IP 模式遇到个别内网域名无法打开，在配置文件的 `fake-ip-filter` 排除列表中添加该域名。
5. 系统代理冲突 / 其他扩展程序干扰
故障典型表现： 关闭客户端后整个电脑彻底断网，无法浏览任何国内与国际网页。
可能的原因分析
- 客户端非正常退出，未能成功恢复 Windows 或 macOS 的系统代理注册表设置。
- 浏览器安装了 SwitchyOmega 或某些防关联插件，强制覆写了系统级代理端口。
推荐排查与解决顺序
- 重新打开客户端软件，在设置中手动先开启“系统代理”，随后再正常点击“关闭系统代理”并规范退出。
- 在 Windows“设置 -> 网络和 Internet -> 代理”中，手动将“使用代理服务器”开关切换为“关”。
- 排查浏览器中安装的第三方网络类扩展插件，将其运行模式设为“系统代理”或暂时禁用。
6. 客户端显示连接成功，但网页始终打不开
故障典型表现： 客户端托盘图标正常，节点延迟测试有数字（如 120ms），但浏览器一直转圈加载。
可能的原因分析
- 策略组当前选中的具体节点在远端服务器无外网路由权限或落地机异常。
- 浏览器缓存了失效的 TLS 证书或 HSTS 策略。
- 当前访问的网站触发了严格的地理位置风控防护，直接静默丢弃请求。
推荐排查与解决顺序
- 在客户端的“Proxies / 节点选择”面板中，手动切换至另一个不同国家或地区的节点（例如由香港切换至新加坡或日本）。
- 使用浏览器的“无痕/隐身窗口 (Incognito)”尝试访问，避开本地 Cookie 与缓存冲突。
- 检查当前分流规则：确认访问的目标网站是否落入到了错误的 DIRECT 策略组中。
7. Wi-Fi 网络切换后的连接挂死与异常
故障典型表现： 笔电从公司 Wi-Fi 换到手机热点，或者在不同楼层漫游后，客户端无法自愈连接。
可能的原因分析
- 操作系统的物理网卡 IP 地址与默认网关发生变更，而客户端现存的 TCP Keep-Alive 长连接仍在尝试向旧网关通信。
- TUN 虚拟网卡路由表未随物理网卡的变化完成重新绑定。
推荐排查与解决顺序
- 在客户端界面点击“重置核心”或右下角“断开所有连接 (Close All Connections)”。
- 在系统托盘右键退出客户端，等待 5 秒确认新 Wi-Fi 获取到有效 IP 后，再重新启动客户端。
- 若频繁发生，建议在设置中开启“网络变更时自动重连 (Auto Reconnect)”功能。
8. 工作公司内网的防火墙与协议访问限制
故障典型表现： 手机 4G 可以正常连接，但只要连上公司内网 Wi-Fi，所有节点全部变红失效。
可能的原因分析
- 企业内网网关部署了行为管理设备（深信服、网康等），封锁了非标准 TCP/UDP 端口。
- 公司内网要求强制安装企业自签名安全证书，对外部 TLS 握手进行中间人检测。
推荐排查与解决顺序
- 在客户端节点列表中，挑选标明使用 443 标口或 TLS 协议伪装的节点进行尝试。
- 如果企业内网管控极为严格，请勿强行绕行以避免违反公司信息安全规定；办公业务建议使用公司合规提供的专有通道。
- 日常个人检索可采用手机独立 5G 个人热点隔离网络。