1. 安装前:系统要求与 WebView2 运行时
Clash Verge 的 Windows 客户端使用 WebView2 渲染设置界面。系统缺少 WebView2 Runtime 时,应用会启动失败或显示空白窗口,这是安装阶段最常见的第一个坑。
坑 1:WebView2 运行时缺失
症状:双击应用图标后窗口空白,或弹出缺少 WebView2 Runtime 的提示后闪退。
原因:Windows 11 与 2022 年后的 Windows 10 更新通常已内置 WebView2;更早的 Windows 10 版本需要手动安装。
处理:从 Microsoft 官网下载 WebView2 Runtime 的 x64 离线安装包,安装后重新打开 Clash Verge,无需重启系统。
系统要求:
- Windows 10 版本 1809(内部版本 17763)及以上,或 Windows 11
- Intel / AMD 设备选 x64 安装包,ARM 设备选 arm64 安装包
- 运行时内存占用约 200 MB,4 GB 内存即可流畅使用
安装包只从官方发布页下载。第三方下载站的文件版本旧、来源不明,不要使用。
2. 安装 Clash Verge:路径、权限与服务模式
安装步骤:
- 运行安装包,选择安装目录,勾选「创建桌面快捷方式」
- 点击安装,等待进度条完成
- 首次启动后进入「设置」→「服务模式」,点击「安装」
坑 2:安装路径含中文或空格
症状:服务模式安装失败,或 TUN 模式开启后无法创建虚拟网卡。
原因:Windows 服务注册与虚拟网卡驱动对非 ASCII 路径支持不完整。
处理:使用默认路径 C:\Program Files\Clash Verge,或自定义为纯英文、无空格的路径。已装在中文路径下的,卸载后重装。
坑 3:服务模式安装失败
症状:点击「安装服务模式」后提示「权限不足」或「安装失败」。
原因:当前账户不是管理员,或安全软件拦截了服务注册行为。
处理:右键 Clash Verge 图标,选择「以管理员身份运行」,再进入「设置」→「服务模式」重试。仍失败时,临时关闭安全软件的系统防护,安装完成后重新开启。
服务模式让 mihomo 内核以 Windows 服务方式运行。TUN 模式依赖服务模式,开启后不需要每次启动都弹 UAC 授权窗口,这一步不要跳过。
3. 导入订阅:链接格式与解析失败排查
在「订阅」页点击「新建」,填写订阅名称,粘贴订阅链接,点击「确认」。客户端会拉取链接内容并解析为节点列表。
坑 4:订阅解析失败
症状:导入后提示「解析失败」「订阅为空」,或节点列表为 0。
按顺序排查:
- 链接是否过期:用浏览器直接打开订阅链接。返回 401、403 或「已过期」提示,去机场后台重新生成链接
- 返回内容是否为 YAML:浏览器打开后应看到以
proxies:开头的文本。若返回 JSON 或 sing-box 格式,在机场后台切换为 Clash Meta 订阅格式,重新导入 - 网络能否访问订阅域名:部分网络环境无法直连订阅服务器。先开启系统代理,再点订阅卡片上的「更新」重试
订阅链接格式一般为:
https://example.com/api/v1/client/subscribe?token=xxxxxxxx订阅链接只在导入与手动更新时拉取。机场后台更换套餐、重置链接后,需要在订阅卡片上点「更新」重新拉取,节点列表才会变化。
导入成功后,在「代理」页选择节点或策略组。Clash Verge 使用 mihomo 内核,proxy-providers、rule-providers 等 Clash Meta 扩展字段都能正常解析。
4. 开启系统代理:端口占用与浏览器扩展
Clash Verge 默认混合端口为 7897,同时提供 HTTP 与 SOCKS5 代理。开启方式:「设置」→「系统代理」→ 打开开关。系统代理写入 Windows「Internet 选项」,读取系统代理的应用都会走代理。
坑 5:系统代理已开启,浏览器仍直连
原因 1:浏览器安装了 SwitchyOmega 等代理扩展,扩展接管了代理设置,系统代理被忽略。
原因 2:7897 端口被其他程序占用,mihomo 内核启动失败。
处理:
- 关闭或删除浏览器代理扩展,让浏览器跟随系统代理
- 命令行检查端口占用:
netstat -ano | findstr 7897 - 输出非空且进程不是 Clash Verge 时,在「设置」→「端口」中修改混合端口,然后重启应用
- 重启浏览器,访问 ip.sb 验证出口 IP
系统代理开关打开后浏览器打不开网页,先关掉开关,再按上面两步排查,不要反复开关。
5. 切换 TUN 模式:虚拟网卡与 DNS 覆盖
TUN 模式通过虚拟网卡接管系统全部 IP 流量,不依赖应用主动读取代理设置。命令行工具、游戏、UDP 应用在系统代理模式下经常漏走,切到 TUN 模式后都会被接管。
开启条件:服务模式已安装。开启方式:「设置」→「TUN 模式」→ 打开开关。首次开启时 Windows 会弹出虚拟网卡安装提示,点击「允许」。
坑 6:TUN 模式开启后立即关闭
原因 1:服务模式未安装或安装失败。
原因 2:虚拟网卡驱动被安全软件隔离。
处理:
- 确认「设置」→「服务模式」显示「已安装」
- 打开「设备管理器」→「网络适配器」,确认存在 Clash Verge 虚拟网卡
- 在安全软件隔离区恢复被拦截的驱动文件,重启 Clash Verge
TUN 模式开启后,系统代理开关可以保留也可以关闭。两者同时开启时,浏览器走系统代理,其余流量走虚拟网卡,互不冲突。
TUN 模式下建议同时开启 DNS 覆盖:「设置」→「DNS 覆盖」→ 开启 Fake-IP。mihomo 接管 DNS 解析,避免部分应用的 DNS 请求绕过代理造成泄漏。mihomo 默认 Fake-IP 网段为 198.18.0.1/16,无需手动修改。
6. 服务模式、开机自启与防火墙
服务模式安装完成后,Clash Verge 以系统服务运行,开机自启不受用户登录影响。
开机自启:「设置」→「开机自启」→ 打开开关。开机后代理未生效时,检查任务管理器「启动」页,确认 Clash Verge 未被禁用。
坑 7:防火墙拦截
症状:开启 TUN 模式后,部分应用无法连接网络;Windows 安全中心弹出「是否允许访问」提示。
处理:
- 弹窗出现时,勾选「专用网络」和「公用网络」,点击「允许访问」
- 已误点取消时,进入「Windows 安全中心」→「防火墙和网络保护」→「允许应用通过防火墙」,手动添加 Clash Verge
- 列表里找不到时,点击「允许其他应用」,定位到安装目录下的 Clash Verge 可执行文件
7. 七个坑速查表
| 坑 | 症状 | 处理 |
|---|---|---|
| 1 WebView2 缺失 | 窗口空白、启动闪退 | 安装 WebView2 Runtime |
| 2 路径含中文 | 服务模式或 TUN 安装失败 | 改用纯英文路径重装 |
| 3 服务模式失败 | 提示权限不足 | 管理员身份运行后重试 |
| 4 订阅解析失败 | 导入后节点为 0 | 查链接有效期与订阅格式 |
| 5 系统代理不生效 | 浏览器仍直连 | 关代理扩展、查 7897 端口 |
| 6 TUN 开启即断 | 开关自动弹回 | 先装服务模式、查虚拟网卡 |
| 7 防火墙拦截 | 部分应用连不上 | 允许专用与公用网络 |
8. 配置完成后的验证清单
- 系统代理生效:访问 ip.sb,出口 IP 与节点地区一致
- TUN 生效:打开命令提示符,执行
curl -I https://www.google.com,返回 HTTP/2 200 即正常 - 订阅可更新:在订阅卡片点击「更新」,无报错
- 开机自启:重启电脑,不手动打开应用也能正常联网
7 个坑逐个对完,Windows 端配置就算完成。后续遇到策略组选择或规则匹配问题,可以继续查看使用文档。