常见问题与排错说明
界面显示、系统组件、TUN、权限、系统代理、订阅状态、自启动与更新异常在这一页分别处理。重点不在功能介绍,而在问题触发条件、排查方向与处理路径。
问题范围与处理边界
常见异常通常可归入四类:界面与组件依赖、系统权限与服务状态、网络接管与代理残留、订阅与更新行为。不同问题虽然表现相似,但触发原因往往分布在不同层面,例如界面空白更接近 WebView2 与组件状态,网络异常更接近 TUN、路由表、防火墙与系统代理,订阅不可选则更可能与系统服务或权限限制有关。
排查顺序通常应从系统层向应用层推进,优先确认系统版本、组件状态、权限与服务,再检查客户端设置、订阅来源、规则行为与启动项残留。网络体验与节点质量评估不属于 FAQ 页面主体范围,因此不与问题诊断混合展开;同样,下载方式、配置结构与策略分流逻辑应分别交由下载页与配置页处理。
处理异常时,应尽量避免一次性同时修改多个组件与设置,以免扩大排查范围。更稳妥的方式通常是按问题类型逐项回退:先确认系统组件,再确认代理状态与服务状态,之后再处理 TUN、订阅、启动项与旧版本残留。这样更容易定位真正的触发条件,也更利于后续复现与修复。
可能原因内核通信失败,或相关网络组件未正常接管。
处理方式先检查防火墙与系统安全软件状态,再确认相关进程未被阻断;必要时重新启用网络组件后再启动客户端。
可能原因系统存在多张网卡、路由冲突、权限限制或安全软件干预。
处理方式先检查默认路由、冗余网卡与防火墙放行状态,再决定是否关闭多余网络接口或调整 TUN 与服务模式设置。
可能原因安装包架构与设备架构不一致。
处理方式优先确认系统架构,再重新选择对应平台与架构的安装包。大多数桌面设备使用 x64 架构。
可能原因WebView2 组件缺失、被禁用,或系统更新状态异常。
处理方式先确认 WebView2 是否可用,再检查 Edge 与系统组件状态;仍无法显示时,可改用带 fixed_webview2 标识的安装包。
可能原因安全软件阻断了服务模式相关进程或驱动安装。
处理方式安装前先确认安全软件未拦截关键进程,必要时暂时关闭拦截行为后再重试安装。
可能原因系统自动更新关闭、组件状态异常或安装源不完整。
处理方式优先恢复系统更新与组件安装能力;仍无法完成安装时,再考虑带有 fixed_webview2 的安装包。
说明较新的客户端与组件依赖通常不再覆盖 Windows 7 环境。
处理方式更适合使用仍被支持的桌面系统版本,以获得组件兼容与安全更新支持。
可能原因启动项被清理、权限状态不一致,或旧版本残留导致启动项冲突。
处理方式在当前使用权限下重新切换一次开机启动设置,并确认历史版本与旧路径已被清理。
可能原因系统代理未被正确关闭,代理残留仍在生效。
处理方式先检查 Windows 代理设置,确认“使用代理服务器”等手动代理选项已经关闭。
症状日志提示访问 socket 的权限受限。
处理方式优先检查 Host Network Service 是否正常运行,必要时重启相关系统服务:
net stop hns
net start hns
也可在系统“服务”中重新启动 Host Network Service。
可能原因旧版本路径残留、目录识别异常或升级链不连续。
处理方式清理历史版本与重复安装路径,再重新安装当前版本,通常更容易恢复更新链路。
可能原因UWP 沙盒默认受本地回环限制,无法直接访问 localhost 端口。
处理方式在支持的 UWP 工具中为对应应用解除回环限制,并保存设置使变更生效。
说明默认地址通常为 127.0.0.1,在跨主机或自定义网络环境下可能不适用。
处理方式可通过系统环境变量设置 CLASH_VERGE_REV_IP 为目标地址,重启应用后再复制 PowerShell 变量。
症状系统代理显示已开启,但应用内部状态与系统设置不一致。
处理方式优先使用较新的版本;若仍存在异常,再检查系统代理相关注册表项与拨号网络配置。
HKEY_CURRENT_USER\Software\Microsoft\Windows\CurrentVersion\Internet Settings\Conn