Clash Verge logo Clash Verge开源跨平台代理客户端

疑难排解

常见报错速查手册

发布于 · 更新于 · 2 分钟读完

收藏这一页。左边是你看到的报错,右边是原因和解法,需要展开的都给了详细教程链接。

大多数报错都有固定的成因,对表处理即可
大多数报错都有固定的成因,对表处理即可

启动与界面

现象 / 报错原因与处理
窗口白屏、界面空白WebView2 运行时缺失或损坏。装 Evergreen 运行时或改用 fixed_webview2 安装包,见 Windows 安装
SmartScreen「已保护你的电脑」未签名开源软件的正常提示,更多信息 → 仍要运行。前提是从官方来源下载,见辨别官方包
macOS「已损坏,无法打开」Gatekeeper 隔离标记,执行 xattr 命令移除,见 macOS 安装
开机没有自动启动启动项被系统或安全软件禁用,见自启设置

内核与配置

现象 / 报错原因与处理
Port xxxx is already in use端口被其他程序占用,见端口冲突
yaml: unmarshal errors / 配置加载失败YAML 语法错误,通常是 Merge 缩进问题,见扩展配置
unsupported proxy type内核版本不认识订阅里的新协议,升级/切换内核
rule-provider ... initial error规则集拉取失败或 behavior 类型写错,见规则集
内核频繁崩溃重启先切回稳定版内核;仍崩则清空 Merge/Script 逐段排查

网络功能

现象 / 报错原因与处理
TUN 开关灰色 / 打开报错服务模式未安装或损坏,见服务修复
订阅更新 401/403/超时订阅失效或域名被阻断,见订阅排查
代理开着但无法上网五步排查法,见完整清单
UWP 应用断网回环限制,见 UWP 豁免
提示

表里没有的报错,把「日志」页里的原文(英文部分)复制去 GitHub 仓库的 Issues 搜索,大概率已有现成答案。

还没有安装 Clash Verge?

Windows 64 位安装包 · v2.5.1 · 免费开源

下载 v2.5.1