Clash Verge Rev 教程:导入订阅、自定义规则、TUN 模式与常见报错
Clash Verge Rev 是基于 Tauri 的开源 Clash 图形客户端,内置 mihomo(Clash Meta)内核,支持 Windows、macOS 和 Linux。本文以 v2.5.8(2026-10-09 发布)为准,界面文字取自该版本的中文语言文件,不同版本可能略有差别。
下载#
官方文档的原话是:“Clash Verge Rev 目前仅通过 GitHub Release 发布,请注意辨别。”下载地址是 GitHub Releases,按系统选安装包:
| 系统 | 安装包 |
|---|---|
| Windows | x64 或 ARM64 的 setup .exe;不确定架构时选 x64。另有内置 WebView2 的 fix_webview2 版本,适合装不上 WebView2 的系统。现版本不再支持 Windows 7 |
| macOS | Apple M 系列芯片选 aarch64.dmg,Intel 选 x64.dmg。安装页写明支持 macOS 12 及以上 |
| Linux | DEB(amd64 / arm64 / armhf)或 RPM(x86_64 / aarch64 / armhfp) |
Linux 的安装命令示例(把文件名换成实际下载的):
sudo apt install -y ./Clash.Verge_x.x.x-_xxx.deb
sudo dnf install ./Clash.Verge_x.x.x-_xxx.rpm
导入订阅#
- 打开左侧的“订阅”页。
- 把机场订阅链接,或者订阅转换生成的链接,粘贴到顶部写着“订阅文件链接”的输入框里,点“导入”。
- 导入成功后,在这个订阅上右键选“使用”。
如果直接导入失败,客户端会提示“订阅导入失败,尝试使用 Clash 代理导入”,自动再试一次。官方文档还给了两条建议:提示 client error(Connect) 时换一种导入方式,比如点“新建配置”手动填写;手动填写后仍然报这个错,就勾选“允许无效证书(危险)”再保存。
订阅的更新设置
在订阅上右键选“编辑信息”,可以修改这些字段:
| 字段 | 说明 |
|---|---|
| 订阅链接 | 订阅地址 |
| 用户代理 | 请求订阅时的 User-Agent。留空时默认为 clash-verge/v版本号 |
| 更新间隔 | 单位为分钟。界面建议使用默认值 1440 分钟(24 小时),并提示“间隔过短会频繁触发内核重载并中断现有连接”。没有填写时,会采用订阅服务器返回的 profile-update-interval 响应头(单位为小时) |
| 允许自动更新 | 是否按更新间隔自动更新 |
| 使用系统代理更新 / 使用内核代理更新 | 更新订阅时是否经过代理 |
| 允许无效证书(危险) | 跳过证书校验,只在确认订阅地址可信时使用 |
| HTTP 请求超时 | 请求订阅的超时时间 |
想立刻更新,可以右键选“更新”,或者选“更新(代理)”通过代理更新;页面上的“更新所有订阅”会一次更新全部订阅。
添加自定义规则#
订阅更新时会整体覆盖订阅文件,所以直接改订阅文件里的规则,下次更新就没了。官方的做法是右键订阅,选“编辑规则”。文档说明:“此处编辑的规则不会随着订阅更新而失效”。
- 点“添加前置规则”或“添加后置规则”,依次填写“规则类型”(如
DOMAIN-SUFFIX)、“规则内容”(如example.com)和“代理策略”(策略组名,或DIRECT、REJECT)。 - 前置规则插在订阅规则之前,后置规则追加在之后。规则从上到下匹配,命中第一条就停止,订阅最后通常有一条
MATCH兜底,后置规则排在它后面会匹配不到。所以官方文档写的是“推荐使用前置规则”。 - 同一个右键菜单里还有“编辑节点”和“编辑代理组”,可以用同样的前置、后置方式追加节点和策略组。
prepend-rules 里。从 v1.7 起这个功能移到了“编辑规则”,当前版本的扩展覆写配置也不再处理 prepend-rules、append-rules、prepend-proxies、prepend-proxy-groups 这类键。网上的旧教程如果还让你这样写,规则是不会生效的。规则类型和写法见本站的 Clash 规则语法与匹配顺序。
扩展覆写配置和扩展脚本#
需要修改 DNS、嗅探这类设置时,用“扩展覆写配置”(v1.7 之前叫 Merge 配置);需要用代码批量处理配置时,用“扩展脚本”。两者都分全局和单个订阅两级:
- 全局:“订阅”页里的“全局扩展覆写配置”和“全局扩展脚本”,对所有订阅生效。
- 单个订阅:右键订阅,选“扩展覆写配置”或“扩展脚本”。
执行顺序是:订阅原始配置 → 写入应用设置 → 全局扩展覆写配置 → 全局扩展脚本 → 订阅扩展覆写配置 → 订阅扩展脚本 → 由应用控制的字段再写回一次。
扩展覆写配置按 YAML 写,合并规则如下:
- 列表和普通值整体替换,例如
rules、dns.nameserver、tcp-concurrent。 tun、sniffer这类对象按子键合并。- 从 v2.5.5 起,
dns下写了的字段和顶层的hosts整体替换,nameserver-policy也会被整个替换掉;dns中没写的字段保持原样。 - 端口、
mode、allow-lan、log-level、ipv6、tun.enable和 TUN 的相关设置由客户端界面控制,在扩展里写了也会被丢弃。
官方文档中的全局扩展覆写配置示例:
dns:
enable: true
ipv6: true
tcp-concurrent: true
扩展脚本用 JavaScript 写,入口是 main 函数,返回修改后的配置。订阅脚本的第二个参数是订阅名(v1.7.3 起提供)。脚本不支持网络和文件读写。下面这段改写自官方示例,在订阅规则最前面插入一条规则:
function main(config, profileName) {
const prependRule = ["DOMAIN-SUFFIX,example.com,DIRECT"];
config["rules"] = prependRule.concat(config["rules"] || []);
return config;
}
系统代理和虚拟网卡(TUN)模式#
| 开关 | 原理 | 适合 |
|---|---|---|
| 系统代理 | 修改操作系统的代理设置,让遵守系统代理的程序把请求交给 Clash | 浏览器等大多数场景 |
| 虚拟网卡模式 | 创建一张虚拟网卡,通过路由接管系统所有流量,启用时无须再打开系统代理 | 不走系统代理的程序,例如游戏和命令行工具 |
打开虚拟网卡模式需要先安装服务模式,或者以管理员身份运行,否则界面会提示“TUN 模式需要安装服务模式或管理员模式”。官方文档对服务模式的解释是:“服务模式的用途是能够以非管理员身份启动 TUN 模式。”服务在设置页里安装。
macOS 上开启 TUN 时,客户端会把系统 DNS 改为 223.6.6.6,关闭后恢复,这是官方 FAQ 说明的正常行为。
常见报错和官方解决办法#
| 现象或报错 | 原因和解决办法(来自官方 FAQ) |
|---|---|
| 订阅点不动、无法选中订阅(Windows),日志里有 “An attempt was made to access a socket in a way forbidden by its access permissions.” | Host Network Service 服务没有运行。以管理员身份在命令行运行 net stop hns 和 net start hns 重启它,或在服务管理里重启 |
| 导入订阅报错 “invalid peer certificate: UnknownIssuer” | 订阅服务器证书无效。编辑订阅,勾选“允许无效证书(危险)” |
| 导入订阅报错 401 | 清空设置里“配置目录”中的内容后重启;仍然不行就卸载后重装 |
| 验证进程异常退出,退出码: -1073741819 | 内置的 mihomo 内核用了较新的 CPU 指令集,很老的 CPU 不支持,需要手动换成 v1 指令集版本的 mihomo 内核 |
| 服务内核未通过安全检查,已切换到普通模式(Sidecar),TUN 用不了(Windows) | 内核文件所在目录能被普通账户修改,服务拒绝启动内核。可以以管理员身份运行;或备份配置后重装到默认目录 C:\Program Files\Clash Verge,再在设置里重装服务模式 |
| 开了 TUN 后网络异常(Windows) | 可能有多张网卡,或者网段和规则冲突,删除多余的虚拟网卡 |
| 不打开 Clash 就上不了网(Windows) | 客户端异常退出,系统代理没有恢复。在 Windows 设置里关闭“使用代理服务器” |
切换订阅时,客户端会先校验新配置,校验不通过就提示“订阅配置校验失败,请检查订阅配置文件,变更已撤销,错误详情:”,同时保留原来的配置;切换本身失败时提示“切换订阅失败”。遇到这类提示,先看“错误详情”后面的内容:
- 如果是 YAML 语法错误,说明订阅内容不是有效的 Clash 配置。常见原因是订阅链接返回的是节点列表或网页,而不是 Clash 配置文件,可以先用订阅转换生成 Clash 格式的链接再导入。
- 如果提示“覆写文件语法错误,变更已撤销”或“脚本语法错误,变更已撤销”,问题出在你写的扩展覆写配置或扩展脚本上,检查最近改过的那一份。
常见问题
- Clash Verge Rev 怎么导入订阅?
- 打开“订阅”页,把订阅链接粘贴到“订阅文件链接”输入框,点“导入”,再在该订阅上右键选“使用”。导入失败时可以点“新建配置”手动填写,必要时勾选“允许无效证书(危险)”。
- Clash Verge Rev 怎么添加不会被订阅更新覆盖的自定义规则?
- 右键订阅选“编辑规则”,用“添加前置规则”添加。官方文档说明这里编辑的规则不会随订阅更新失效,并推荐使用前置规则。
- Clash Verge Rev 的 prepend-rules 为什么不生效?
- 从 v1.7 起前置规则移到了“编辑规则”中,当前版本的扩展覆写配置不再处理 prepend-rules 等键。
- Clash Verge Rev 开不了 TUN 模式怎么办?
- TUN 模式需要先安装服务模式,或者以管理员身份运行客户端。