ClashVerge 使用文档

本指南面向首次使用者,覆盖安装、订阅导入、代理模式选择与基础排错。具体界面以你安装的版本为准。

快速起步

  1. 1. 下载对应平台安装包

    前往 下载页,按系统与芯片架构选择 Stable 正式版。

  2. 2. 安装并启动 ClashVerge

    完成安装后启动客户端。首次启动可能请求系统权限(防火墙、服务安装等),请按提示授权。

  3. 3. 导入配置并开启代理

    导入订阅或本地 YAML 后,开启系统代理(或 TUN),再选择节点并做延迟测试。

安装说明

Windows

运行 64 位(x64)安装包 x64-setup.exe 完成安装。若系统缺少 WebView2,可使用带 fixed WebView2 的安装包,或先安装微软 WebView2 Runtime。

macOS

打开 DMG,将应用拖入「应用程序」。若提示无法验证开发者,打开「系统设置 → 隐私与安全性」允许运行。请确认芯片架构与安装包一致。

Linux

Debian / Ubuntu 系可用 DEB;Fedora / RHEL 系可用 RPM。也可在 Releases 中选择适合你发行版的其他包格式。图形界面依赖与权限以发行版文档为准。

导入订阅 / 配置

  1. 打开客户端的配置(Profiles)页面。
  2. 选择「新建 / 导入」,粘贴 HTTPS 订阅链接,或导入本地 YAML 文件。
  3. 等待拉取完成;若失败,检查网络、订阅地址有效性与链接协议(https)。
  4. 启用该配置后,确认策略组与规则已正确加载。

提示:本站不提供任何订阅或节点。请仅使用你合法持有、且符合当地法规的配置来源。

系统代理与 TUN

系统代理

适合浏览器等遵循系统代理设置的应用。操作简单,是日常首选。

TUN 模式

通过虚拟网卡接管更广泛流量,适合需要覆盖命令行或不走系统代理的场景。可能需要安装服务组件并授予更高权限。

同时请理解「规则 / 全局 / 直连」等代理模式:日常推荐规则模式,按规则集决定哪些流量走代理、哪些直连。

节点选择与延迟测试

  • 在代理(Proxies)页面选择策略组与具体节点。
  • 使用延迟测试(Delay Test)快速筛选可用节点。
  • 若延迟异常偏高或超时,可更换节点、检查订阅是否过期,或查看日志定位握手失败原因。

常见排错

订阅更新失败

核对订阅 URL、本机网络与证书;清理缓存后重试;必要时手动下载配置再本地导入。

开启代理后无法上网

先切到直连确认本机网络正常;再检查当前节点是否可用、规则是否过严、DNS 设置是否异常;TUN 场景确认服务是否正常启动。

端口冲突

默认混合端口、HTTP/SOCKS 或控制端口被占用时,可在设置中修改端口并同步依赖该端口的外部工具配置。

需要安装包?前往 下载页。 项目源码与完整发行说明见 GitHub 仓库