Clash Verge Rev 科学上网教程：安装、订阅导入与连不上网排查
简答：先安装与系统匹配的 Clash Verge Rev，导入服务提供方给出的 Clash 或 Mihomo 订阅，手动更新后选节点；首次连接优先使用 Rule 模式和系统代理，浏览器能用后再按需开启 TUN。
定义：Clash Verge Rev 是基于 Tauri 的桌面代理客户端，内置 mihomo 内核，可导入配置并通过系统代理或 TUN 模式处理符合条件的网络流量。
先试这条最短路径：装好却连不上时按顺序检查
如果你已经安装客户端但网页打不开，不要先反复切换节点。先完成：安装 → 导入 Clash 或 Mihomo 订阅 → 手动更新 → 选中当前配置 → Rule 模式 → 开启 System Proxy → 查看 Connections。本文与 Clash Verge Rev 项目及其开发者无隶属关系，只讲桌面端 Windows、macOS 和 Linux 的基础配置；移动端客户端不在本文步骤范围内，可从站内教程中心继续查找对应内容。
| 检查环节 | 正常现象 | 异常时先看什么 |
|---|---|---|
| 程序启动 | 主界面正常显示，配置、代理和设置页面可打开 | 系统架构、安装包来源、Windows WebView2 Runtime |
| 订阅更新 | 配置出现更新时间，更新后能看到代理组或节点 | 链接完整性、账号权限、返回内容是否为配置文件 |
| 代理接管 | 浏览器请求出现在 Connections 中 | System Proxy 开关、实际端口、其他代理软件 |
| TUN 启用 | 需要覆盖系统代理之外的应用时，TUN 状态正常 | Service Mode 或 Admin Mode、虚拟网卡和安全软件 |
当前项目 README 明确列出 Windows、Linux 和 macOS 支持，并说明客户端内置 mihomo 内核、支持系统代理和 TUN 模式。本文选择 Clash Verge Rev 作为步骤对象，不把版本号或某个安装包名称当成永久有效结论，下载时应以Clash Verge Rev 发布页实际显示内容为准。
安装客户端：先确认系统和处理器架构
- 打开发布页。进入Clash Verge Rev Releases，按操作系统和处理器架构选择资产。项目 README 当前列出 Windows x64/x86、Linux x64/arm64，以及 macOS 11+ 的 Intel/Apple 芯片支持；如果发布页没有与你的设备匹配的文件，不要自行猜测兼容性。
- Windows 区分架构。常见 Intel 或 AMD 电脑通常使用 x64；较早的 32 位 Windows 才考虑 x86。可以在“设置 → 系统 → 系统信息”查看“系统类型”，以系统实际显示为准。ARM 设备如果发布页没有对应资产，不要把 x64 安装包当作原生兼容版本。
- macOS 按芯片选择。Apple 芯片和 Intel 芯片使用发布页对应资产。首次打开遇到安全提示时，先核对发布页文件名、来源和系统显示的签名状态，不要执行来源不明的解除隔离命令。
- Windows 白屏或界面打不开。Clash Verge Rev 使用桌面 WebView 界面。Microsoft 文档说明，应用分发时必须确保 WebView2 Runtime 存在；遇到白屏、窗口不显示或提示运行时缺失，可按照Microsoft WebView2 Runtime 部署说明安装或修复 Runtime，然后重启客户端。
- SmartScreen 拦截时暂停安装。先核对文件是否来自项目发布页，再查看文件属性、文件名和发布页信息。无法核对来源时，不要仅因“允许运行”按钮可用就继续安装。
项目 README 将 Stable 描述为适合日常使用的正式版，将 AutoBuild 描述为滚动更新、可能存在缺陷的测试渠道；新手应根据发布页和项目说明选择，不要把测试构建当成稳定结论。详情见Clash Verge Rev 项目 README。
导入订阅：条目出现不等于更新成功
- 准备订阅地址。订阅链接应由你使用的服务提供方生成，并且需要是 Clash 或 Mihomo 兼容格式。不要把网页登录地址、单个节点分享链接或缺少参数的地址当成订阅。完整链接通常包含授权信息，不要公开发布。
- 打开配置页面。在左侧进入 Profiles、配置或同义页面，找到新增远程配置的入口，粘贴完整链接并保存。不同语言和版本的按钮名称可能略有差异，目标是创建远程配置，而不是直接打开 System Proxy。
- 手动更新。点击配置条目的更新按钮，等待更新时间或状态变化。只有看到条目，不代表订阅已经下载和解析成功。
- 按错误类型判断。出现 401 或 403，优先检查账号权限和授权令牌；出现 timeout 或连接错误，先确认当前网络和链接是否完整；出现 YAML、parse 或字段错误，说明内容已到达客户端，但格式可能不兼容。
- 选中当前配置和节点。更新成功后，将该配置设为当前配置，再进入 Proxies 或代理页面，展开策略组并选择具体节点。节点为空时，回到配置页面确认当前配置是否真正启用，以及返回内容是否包含代理定义和策略组。
订阅本身不等于客户端已经接管流量。只有配置被解析、节点被选中，并且 System Proxy 或 TUN 按需启用后，浏览器或其他应用才可能进入客户端。
第一次连接：先用 Rule 加系统代理验证
| 模式或开关 | 适合做什么 | 如何判断 |
|---|---|---|
| Rule | 日常分流和首次连接测试 | Connections 中能看到请求命中的规则和最终出站 |
| Global | 排查规则是否把请求判为 DIRECT | 同一域名在 Global 与 Rule 下的出站结果可对照 |
| Direct | 确认直连网络是否正常 | 请求明确显示直连，不代表节点异常 |
| System Proxy | 让遵守系统代理的浏览器和应用使用客户端 | 系统代理地址、端口正确，Connections 有对应记录 |
| TUN Mode | 覆盖不读取系统代理的部分应用 | TUN 状态正常，目标应用请求出现在 Connections 中 |
- 先选择 Rule 模式，不要一开始就改 DNS、MTU 或 TUN。
- 在 Settings 中开启 System Proxy，打开浏览器访问普通网页。
- 进入 Connections，按时间找到对应域名，查看最终策略是 DIRECT、REJECT 还是代理组，以及是否有出站节点。
- 如果 Connections 没有记录，先检查系统代理是否写入、客户端端口是否监听，以及是否有其他客户端或浏览器扩展覆盖设置。
项目设置文案说明，System Proxy 用于修改操作系统代理设置；TUN 是虚拟网卡模式，启用后不需要同时开启 System Proxy；TUN 需要 Service Mode 或 Admin Mode。相关字段可核对Clash Verge Rev 设置字段说明。
四类高频故障：端口、防火墙、控制面板和 UWP
| 现象 | 检查位置 | 处理方法与判定标准 |
|---|---|---|
| 浏览器无记录，系统代理已开启 | Settings → Port Config、系统代理设置 | 以客户端页面显示的实际 HTTP 或 Mixed 端口为准；端口有本机监听且浏览器请求出现在 Connections，才算基础接管成功。 |
| 核心进程被防火墙或安全软件拦截 | Windows 防火墙允许的应用、杀毒软件隔离区、客户端错误日志 | 先暂时关闭其他代理软件，检查核心文件是否被隔离；恢复文件或建立允许规则后重启客户端。不要把关闭防火墙作为长期方案。 |
| 本地控制面板打不开 | Settings → External Controller 或 Web UI、核心运行状态 | 先确认核心正在运行，再核对外部控制端口和本地地址；项目隐私说明称代理端口和内部控制端口默认绑定 127.0.0.1。端口监听只能证明本机有服务，不证明远端节点可用。详情见Clash Verge Rev 隐私说明。 |
| Microsoft Store 或 UWP 应用不通 | Settings 中的 Open UWP tool | 项目设置文案说明 Windows 8 之后的 UWP 应用可能限制访问本机网络服务，可使用客户端提供的 UWP 工具后重启目标应用，再观察 Connections 是否出现请求。 |
| 命令行不通但浏览器正常 | 命令行工具自身的代理设置或环境变量 | 浏览器能用不代表命令行自动读取系统代理；先按工具文档设置 HTTP_PROXY、HTTPS_PROXY 或专用代理参数，并以该工具实际请求结果判断。 |
检查本机端口时可使用 Windows PowerShell 的内置命令。将“端口”替换为客户端 Settings → Port Config 显示的实际数字：
Get-NetTCPConnection -LocalPort 端口 -State Listen
看到本机监听记录，说明有进程占用该端口；没有记录时，检查核心是否运行、端口是否被其他程序占用。该命令不判断远端节点质量，也不证明某个应用已经使用该端口。
TUN 与 DNS：只改已核对的字段
需要让不读取系统代理的应用接入时，再考虑 TUN。启用前先安装服务或使用管理员权限；如果开启后出现断网、虚拟机异常或局域网访问问题，先关闭 TUN，恢复 System Proxy，再逐项检查虚拟网卡、路由和安全软件。
Mihomo TUN 文档列出 enable、stack、auto-route、auto-detect-interface、dns-mode、dns-hijack、strict-route 和 mtu 等字段。文档明确说明，dns-mode 的 disabled、native、hijack 分别影响系统 DNS 设置；在 Windows 上，hijack 需要配合 strict-route，而发送到本地网络的 DNS 请求不能被自动劫持。请以Mihomo TUN 配置文档当前内容为准，不要直接复制来源不明的字段片段。
- 浏览器和其他应用都失败：先确认请求是否进入 Connections，再检查节点和规则。
- 只有域名解析异常：记录失败域名、命中规则和最终出站，随后查看当前 Profile 的 DNS 与 TUN 设置。
- 不要把系统
nslookup的结果直接当成客户端内部 DNS 结果；它通常只反映命令所在系统使用的解析路径。 - 不要用
ping或tracert的直连结果判断代理节点质量。系统代理模式下，ICMP 等流量可能不经过客户端，应优先看 Connections、客户端节点测试和实际应用请求。
完成后的安全检查与下一步
订阅链接通常包含授权令牌，应像密码一样保存。不要把完整地址放入公开截图、Issue、群聊或日志；排错时至少遮盖域名后的令牌参数。项目隐私说明还指出，代理和订阅服务商、WebDAV 或 DNS 服务商由各自规则处理数据，不能把客户端项目的隐私说明等同于这些服务的隐私政策。
本文没有核实任何订阅服务的价格、可用性、节点质量或连接保证。遇到版本、菜单名称或字段差异时，以项目发布页、项目 README、客户端当前界面和 Mihomo 文档为准。
如果你已完成第一次连接，下一步应保存一次 Connections 中的规则、出站节点和错误日志；这样在排查 DNS、TUN、端口或网络路径时，才能区分“请求没有进入客户端”和“请求进入后远端连接失败”。
常见问题
Clash Verge Rev 安装后白屏或打不开怎么办？
先确认安装包来自项目发布页，再检查 Windows 是否缺少 WebView2 Runtime。Microsoft 文档要求 WebView2 应用运行环境存在；安装或修复 Runtime 后重启客户端。若仍失败，记录系统类型、安装包架构和错误提示，不要先修改订阅配置。
订阅导入成功但没有节点，应该怎么查？
配置条目出现不等于更新成功。进入配置页面手动更新，查看更新时间和错误提示；确认当前配置已选中，返回内容不是登录 HTML，并且包含代理定义和策略组。401 或 403 优先查权限和令牌，YAML 或 parse 错误优先查格式兼容性。
System Proxy 和 TUN Mode 需要同时开启吗？
首次测试通常不需要同时开启。先用 Rule 模式加 System Proxy 验证浏览器，确认 Connections 能看到请求后，再按需开启 TUN。项目设置文案说明，TUN 启用后不需要同时开启 System Proxy。
为什么浏览器能用，但命令行或 Microsoft Store 应用不能用？
浏览器通常会读取系统代理，命令行工具可能需要自己的代理参数或环境变量；UWP 应用还可能受到 Windows 本机回环访问限制影响。先分别检查应用代理设置和客户端的 Open UWP tool，再观察 Connections 是否出现请求。
本地控制面板打不开，应该看什么？
先确认核心正在运行，再进入 Settings 检查 External Controller、Web UI 和实际控制端口。使用 PowerShell 检查本机监听只能证明端口有进程占用，不能证明远端节点可用；同时检查防火墙或安全软件是否拦截核心进程。
如何判断是 DNS 问题还是节点问题？
先看请求是否进入 Connections，再记录失败域名、命中规则和最终出站。随后查看当前配置的 DNS、TUN 的 dns-mode 和 dns-hijack。系统 nslookup 只反映其自身解析路径，不能直接代表客户端内部 DNS 结果。