ACL4SSR 教程

Clash Verge Rev 教程:导入订阅、自定义规则、TUN 模式与常见报错

分类:客户端教程更新于 约 8 分钟读完10 份官方资料
本文目录
  1. 下载
  2. 导入订阅
  3. 添加自定义规则
  4. 扩展覆写配置和扩展脚本
  5. 系统代理和虚拟网卡(TUN)模式
  6. 常见报错和官方解决办法
  7. 常见问题

Clash Verge Rev 是基于 Tauri 的开源 Clash 图形客户端,内置 mihomo(Clash Meta)内核,支持 Windows、macOS 和 Linux。本文以 v2.5.8(2026-10-09 发布)为准,界面文字取自该版本的中文语言文件,不同版本可能略有差别。

下载#

官方文档的原话是:“Clash Verge Rev 目前仅通过 GitHub Release 发布,请注意辨别。”下载地址是 GitHub Releases,按系统选安装包:

系统安装包
Windowsx64 或 ARM64 的 setup .exe;不确定架构时选 x64。另有内置 WebView2 的 fix_webview2 版本,适合装不上 WebView2 的系统。现版本不再支持 Windows 7
macOSApple M 系列芯片选 aarch64.dmg,Intel 选 x64.dmg。安装页写明支持 macOS 12 及以上
LinuxDEB(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

导入订阅#

  1. 打开左侧的“订阅”页。
  2. 把机场订阅链接,或者订阅转换生成的链接,粘贴到顶部写着“订阅文件链接”的输入框里,点“导入”。
  3. 导入成功后,在这个订阅上右键选“使用”。

如果直接导入失败,客户端会提示“订阅导入失败,尝试使用 Clash 代理导入”,自动再试一次。官方文档还给了两条建议:提示 client error(Connect) 时换一种导入方式,比如点“新建配置”手动填写;手动填写后仍然报这个错,就勾选“允许无效证书(危险)”再保存。

订阅的更新设置

在订阅上右键选“编辑信息”,可以修改这些字段:

字段说明
订阅链接订阅地址
用户代理请求订阅时的 User-Agent。留空时默认为 clash-verge/v版本号
更新间隔单位为分钟。界面建议使用默认值 1440 分钟(24 小时),并提示“间隔过短会频繁触发内核重载并中断现有连接”。没有填写时,会采用订阅服务器返回的 profile-update-interval 响应头(单位为小时)
允许自动更新是否按更新间隔自动更新
使用系统代理更新 / 使用内核代理更新更新订阅时是否经过代理
允许无效证书(危险)跳过证书校验,只在确认订阅地址可信时使用
HTTP 请求超时请求订阅的超时时间

想立刻更新,可以右键选“更新”,或者选“更新(代理)”通过代理更新;页面上的“更新所有订阅”会一次更新全部订阅。

添加自定义规则#

订阅更新时会整体覆盖订阅文件,所以直接改订阅文件里的规则,下次更新就没了。官方的做法是右键订阅,选“编辑规则”。文档说明:“此处编辑的规则不会随着订阅更新而失效”。

  • 点“添加前置规则”或“添加后置规则”,依次填写“规则类型”(如 DOMAIN-SUFFIX)、“规则内容”(如 example.com)和“代理策略”(策略组名,或 DIRECT、REJECT)。
  • 前置规则插在订阅规则之前,后置规则追加在之后。规则从上到下匹配,命中第一条就停止,订阅最后通常有一条 MATCH 兜底,后置规则排在它后面会匹配不到。所以官方文档写的是“推荐使用前置规则”。
  • 同一个右键菜单里还有“编辑节点”和“编辑代理组”,可以用同样的前置、后置方式追加节点和策略组。
旧版本把前置规则写在 Merge 配置的 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 模式需要先安装服务模式,或者以管理员身份运行客户端。

本站是非官方的学习笔记站,与 ACL4SSR 原项目维护者无隶属关系。文中引用的规则与文档版权归原作者所有。