
Clash Verge Rev
桌面配置与规则管理正式版 v2.5.102026.11.03 发布
- 支持平台
Windows
macOS
Linux
- 内核 / 配置
- mihomo / Clash、mihomo YAML
- 主要能力
- 配置管理、规则编辑、系统代理与 TUN。
- 使用前确认
- 选择稳定版及对应系统架构;TUN 所需服务与权限按官方文档设置。
AFQKIT / TOOL GUIDE
从官方工具下载,到配置、验证与排查。了解每个工具适合什么、怎么用,以及遇到问题先检查哪里。
选择场景,查看配置重点与验证方法。
查资料、看课程、使用在线工具:先完成客户端配置,再分别检查浏览器和学习应用。校园网与家用网络的连接表现可能不同。
按用途和设备查找工具:客户端用于日常连接,代理内核适合手动配置,网络诊断工具用于检查 DNS、路由与协议问题。以下下载入口均指向官方来源。
搜索工具名称、能力和配置说明,可与用途、设备一起筛选。
显示 13 个工具。按用途和设备筛选,查看适合你的官方入口。
没有找到符合这些条件的工具。可保留设备与搜索词放宽用途,或清除全部条件重新查找。

正式版 v2.5.102026.11.03 发布

正式版 v0.9.32026.11.04 发布
正式版 v5.5.52026.11.04 发布

正式版 7.25.62026.10.11 发布

正式版 2.3.152026.11.01 发布

正式版 v1.2.26.29302026.11.13 发布
此为本文核对版本,已有后续正式版;下载前查看官方最新修复。

正式版 v1.0.32.18032026.11.03 发布
正式版 v1.14.42026.10.24 发布
正式版 v26.11.92026.11.09 发布

版本与安装方式以官方下载页为准

正式版 v1.7.62026.11.06 发布
正式版 v1.4.22026.10.22 发布

正式版 v2.11.372026.11.11 发布
数据核对:;CMFA:。Stars / Forks 来自 GitHub;下载量为当前公开 GitHub Release 附件的累计下载次数(含预发布);未提供下载统计的项目会明确标注,不含商店和其他渠道,也不等于用户人数。点击数据可查看官方来源。
资料来源:各工具的官方项目、发行页和使用文档。点击卡片内的文档或数据可查看原始来源。平台、系统版本与配置兼容性以对应官方说明为准。
核对操作系统、最低版本与 x64 / ARM64 等架构。优先选择官方稳定版,阅读该版本的安装说明。
在客户端内导入你已有的配置文件或订阅,确认解析成功、节点列表可见。不要把订阅令牌放进公开截图或第三方转换页面。
先按文档开启系统代理并使用规则模式。应用没有读取系统代理时,再检查应用设置或按官方说明配置 TUN。
分别打开常用的学习网站与课程应用,并查看客户端连接记录,确认请求是否进入客户端、匹配了什么规则。
| 设置 | 解决什么问题 | 需要留意 |
|---|---|---|
| 系统代理 | 告诉支持该设置的应用使用本机代理端口。 | 终端、Git 和部分应用可能有自己的代理设置。 |
| TUN 模式 | 通过虚拟网卡和路由接管配置范围内的流量。 | 需要相应权限;路由、DNS、排除项及其他 VPN 会影响结果。 |
| 规则模式 | 依据配置规则选择代理、直连或其他策略。 | 是否走代理取决于命中规则和策略组选择。 |
| 全局模式 | 将进入客户端的请求交给所选全局策略。 | 不能让未进入客户端的应用自动走代理;也不保证每个网站都可用。 |
概念参考:Clash Verge Rev 名词解释。不同客户端的入口与默认设置可能不同,以对应版本文档为准。
浏览器能访问、终端却不通?用明确指定代理的请求,检查本机监听端口与 Git 连接。先在客户端设置中确认端口和协议。
只生成文本,不执行命令、不发起检测请求,也无需填写订阅。代理地址固定为本机 127.0.0.1。
等待生成命令。
先确认客户端正在运行,再在所选终端执行 curl 命令;Windows PowerShell 使用 curl.exe。本页只生成文本,连接结果来自你的电脑。Git 远程查询是开发场景的可选检查,需要已安装 Git,可按需要单独执行。
curl 明确指定本机代理,并为这次请求覆盖环境中的代理例外;socks5h 表示由代理解析目标域名。收到 HTTP 响应只说明这次请求得到了响应;HTTP 代理的 200 Connection established 仅表示隧道建立,还要看后续 TLS 与目标响应。是否按预期走远端代理策略,需结合客户端连接记录确认。
| 看到的结果 | 意味着什么 | 下一步 |
|---|---|---|
| HTTP 2xx / 3xx | 2xx 表示响应者报告本次请求成功;3xx 是重定向或其他处理状态,不能直接当作最终页面成功。 | 检查跳转位置,在目标应用复核实际任务,并确认请求经过的路径。 |
| HTTP 4xx / 5xx | 已收到某个 HTTP 响应者的错误状态;来源可能是目标、CDN、代理或网关。未用 --fail 时,curl 仍可能退出 0。 | 按状态和响应内容检查认证、路径及服务策略,参见HTTP 错误怎么读。 |
| HEAD 返回 405 | 当前资源不允许这个请求方法;HEAD 与普通 GET 的处理可能不同。 | 用同一目标的普通浏览器请求对照,不能只凭 HEAD 405 判定代理失效。 |
curl: (7) | 连接目标或代理失败;先看错误里列出的地址与端口。 | 若是本机端口,检查客户端进程、监听地址与协议;再看入口选择与连接错误。 |
curl: (28) | 触发了超时限制,可能发生在解析、连接、握手或等待响应等阶段。 | 结合错误文字与客户端日志,按分层定位顺序找到最早失败处。 |
curl: (60) | 对端证书校验失败,当前 HTTPS 请求尚未通过身份验证。 | 核对系统时间、域名与信任链,按证书错误排查处理,保留证书校验。 |
Git 返回提交哈希与 HEAD 才说明本次远程查询成功。-c http.proxy 只影响这次 Git 调用;已有的 NO_PROXY / no_proxy 或更具体的 Git 代理设置仍可能影响路径,需对照客户端记录。长时间未返回时,可在终端按 Ctrl+C 停止查询。
命令依据:curl 官方手册 · Git 临时配置参数。
| 遇到的症状 | 先检查什么 | 下一步怎么做 |
|---|---|---|
| 配置导入失败 | 客户端支持的格式、订阅是否过期、导入日志。 | 确认返回的是配置而非登录页,按语法、字段与版本检查顺序定位;订阅导入再看订阅与内核兼容排查。分享日志前遮盖令牌和节点凭据。 |
| 浏览器通,Git / 终端不通 | 应用是否读取系统代理,本机监听协议与端口。 | 生成一次性代理验证命令,再按应用路径验证步骤对照客户端记录。成功后按应用文档配置代理,或评估 TUN。 |
| 只有部分网站打不开 | 连接记录里的目标域名、命中规则与策略组。 | 按分流排查步骤确认出站,再看DNS、连接、TLS 与 HTTP 定位顺序。分别验证,不只看节点延迟。 |
| 域名解析失败 | 客户端 DNS 日志与应用自己的加密 DNS 设置。 | 先确认应用实际使用的解析路径;需要查询对照时,按doggo 的解析器对照示例检查。终端有答案不等于浏览器或代理侧解析一致。 |
| 开启 TUN 后断网 | 服务权限、路由、DNS,以及其他 VPN / 虚拟网卡。 | 先关闭 TUN 恢复连接,再按模式切换与断网恢复步骤逐项检查,并对照对应客户端文档。避免同时启用多个接管网络的工具。 |
| 退出客户端后仍无法联网 | 系统或应用是否仍指向已关闭的本机端口。 | 按退出后的网络恢复检查处理残留代理,并核对应用自己的代理设置;企业管理的代理按组织要求处理。 |
准备求助信息:客户端版本、操作系统、代理模式、复现步骤和已脱敏日志。先按排查前的记录清单保留现场,明确是导入失败、连接失败还是某个应用失败。
客户端、DNS 与分流各自负责什么?用原理图和具体例子把请求路径理清楚,再回到对应工具设置。
客户端装好了,节点列表却是空的,通常还缺少连接配置。先分清客户端、内核和订阅各自做什么,再看手里的链接应该从哪里导入。
阅读解释 →浏览器能打开网页,终端却连不上,问题可能出在应用没有读取系统代理。系统代理和 TUN 是两种把流量交给客户端的方法,先选适合应用的入口,再检查出站。
阅读解释 →给浏览器或终端填写代理地址时,先看客户端开放了哪种入口。HTTP 与 SOCKS5 都能转发连接,但地址写法、域名解析和 UDP 支持需要分别核对。
阅读解释 →安卓代理客户端也会弹出 VPN 授权,这很容易让人把两者混为一谈。判断它在做什么,要看流量怎样进入应用、又用什么方式发往目标。
阅读解释 →网站打不开时,先看域名能否得到地址,再查后续连接。DNS 负责查询记录;DoH、DoT、DoQ 改变查询的传输方式,适合放在同一条解析流程里理解。
阅读解释 →已经选了节点,某个网站却仍然直连,先看看这次请求命中了哪个策略组。分流决定进入客户端的流量从哪里出去,节点选择只是其中一步。
阅读解释 →把 .yaml 改名为 .json,不能让配置换个客户端就能用。格式决定数据怎么写,内核决定字段怎么解释;迁移时两项都要对得上。
阅读解释 →节点延迟很低,下载却很慢,这两个结果并不矛盾。延迟描述一次交互的等待,吞吐量描述持续传输的速度;还需要结合抖动、丢包和测试目标来看。
阅读解释 →“连不上”可能是解析失败,也可能是网站已经返回了拒绝响应。先保留原始报错,再沿 DNS、TCP、TLS、HTTP 找到最早失败的一步,能少改很多无关设置。
阅读解释 →客户端显示已连接,浏览器却打不开网页时,可以先用 curl 发一条明确经过本机代理入口的请求。把入口、目标和超时写在命令里,比同时更换节点、DNS 和模式更容易定位问题。
阅读解释 →浏览器已经走代理,终端里的下载命令却仍然失败,常见原因是命令行程序没有读取系统代理。先在当前终端设置环境变量并验证,确认有效后再决定是否长期保存。
阅读解释 →同一个网站,有的设备能打开,有的却长时间等待,可能是 IPv4 和 IPv6 两条路径表现不同。先把解析结果与连接结果分开,再确认失败发生在本机网络、代理入口还是远端出站。
阅读解释 →解析结果里出现 198.18 开头的地址,未必是 DNS 被填错了。客户端使用 Fake-IP 时,会先给应用一个合成地址,再在收到连接后找回对应域名。理解这段映射,才能判断哪里出了问题。
阅读解释 →系统代理里有一个“自动配置脚本”地址,浏览器却仍有部分请求直连?先看 PAC 对该目标返回了什么。它为支持脚本的应用选择代理入口,之后客户端还可能再做一次分流。
阅读解释 →电脑上的代理可用,手机也连着同一个 Wi-Fi,却打不开网页时,先查手机能不能访问电脑的入口。共享代理需要地址、监听、防火墙和应用设置同时对得上。
阅读解释 →规则文件已经更新,网站却还是走错出站,问题可能不在名单内容。资源要先下载、正确加载,再被路由规则引用,最后才轮到目标是否匹配。
阅读解释 →“订阅更新失败”可能发生在下载链接、解析配置或运行节点中的任一步。先保存准确错误信息,再判断停在哪一段,通常比反复点更新或直接重装客户端更有效。
阅读解释 →用 Windows PowerShell、macOS 或 Linux 核对安装包 SHA-256,先找对官方资产与摘要,再处理不匹配;校验通过不等于软件可信或适合本机。
阅读解释 →REFERENCE / FAQ
理解工具的边界,少走配置弯路。
客户端是读取配置和建立连接的软件,通常需要你已有的节点配置或订阅。先确认配置格式与客户端兼容,再在客户端内导入并验证。
不一定。Clash / mihomo YAML、sing-box JSON 和节点链接是不同格式,规则、DNS 与扩展字段也可能不同。选择订阅提供的对应格式,并检查客户端导入日志;不要把格式支持理解为所有功能完全等价。
延迟测试只检查特定测试目标与路径。实际网站还受域名解析、路由规则、TLS、目标站点及账号状态影响。查看该网站对应的连接记录,再用真实请求验证。
它们解决不同问题,没有统一的“全部开启”配置。系统代理与 TUN 影响流量如何进入客户端;规则与全局模式决定进入后的流量如何路由。先选择能覆盖实际应用的方式,再验证。
本站没有订阅或配置上传入口。命令工具只在当前浏览器中生成文本,不读取客户端状态、不执行命令、不保存输入。运行命令时由你的电脑请求 GitHub,实际路径受本机代理与例外设置影响;打开官方链接时会访问相应外部网站。
本站使用 Cloudflare Web Analytics 查看页面访问和加载性能的汇总统计。浏览器会向 Cloudflare 上报页面、来源和性能等信息;这与命令工具的本地文本生成无关,不会把你在命令工具中填写的内容作为统计事件发送。后台 Visits 统计从外站或直接链接进入的访问,一次访问可包含多个页面浏览,不等于去重人数(UV)。统计可能受地区设置、浏览器拦截或网络影响。详见 Cloudflare 数据收集说明及指标定义。
先备份本地配置、规则与必要设置,并查看新版本的变更说明。跨内核迁移时重点核对格式、DNS 与路由;更新后分别验证浏览器、终端和常用应用。