Clash Verge Rev 连接失败怎么排查？Windows、macOS、Linux 分步定位
简答：Clash Verge Rev 连接失败不要先重装：先确认当前 Profile、代理模式和节点，再看日志中的具体错误。Windows 可用 netstat 查端口占用，macOS 和 Linux 分别用 lsof 或 ss；若只有 TUN 失败，先关闭 TUN 验证系统代理是否正常。最后在 Connections 中确认请求进入客户端、规则命中正确策略并使用了预期节点。
定义：Clash Verge Rev 连接失败，通常是订阅或配置未生效、节点不可达、系统代理未接管、TUN/DNS/端口冲突中的一层或多层问题。
先做这张速查表：不要同时改多个开关
先记录操作系统、Clash Verge Rev 版本、Mihomo 内核版本、故障发生时间，以及是否所有网站都失败。项目仓库说明该客户端内置 Mihomo 内核，并支持系统代理与 TUN 模式；安装包应从项目的 GitHub Releases 页面核对，版本和下载渠道不要只看搜索结果。
| 现象 | 优先检查 | 下一步动作 |
|---|---|---|
| 软件能打开但没有节点 | Profiles、订阅更新、当前配置 | 重新更新订阅，确认更新成功后选中该 Profile |
| 节点全部 timeout | 本地网络、订阅有效期、节点协议和日志 | 先关闭 TUN，用系统代理手动测试一个节点 |
| 系统代理开启但浏览器直连 | 系统代理端口、其他代理软件、浏览器独立代理 | 检查端口监听，再关闭其他代理程序重试 |
| 只有 TUN 模式失败 | 服务权限、防火墙、虚拟网卡、DNS 劫持 | 先恢复系统代理；确认系统代理正常后再启用 TUN |
| 部分网站打不开 | Rule、策略组、DNS、IPv6 | 在 Connections 查看命中的规则和最终出口 |
| 订阅更新失败 | URL、认证、TLS、返回内容 | 看日志区分 401/403、timeout、TLS 或 YAML 错误 |
项目文档对系统代理和 TUN 的区别有明确说明：系统代理依赖应用遵守系统约定，TUN 则通过虚拟网卡和路由接管流量。也就是说，“系统代理能用但游戏或终端不能用”并不自动等于节点坏了，可能只是目标程序没有读取系统代理。
参考：项目仓库 README、项目文档中的系统代理与 TUN 说明。
第一层：确认 Profile、节点和模式真的生效
- 确认当前 Profile。进入 Profiles，检查订阅是否完成更新，并确认当前使用的是刚更新的配置，而不是旧配置或空配置。若出现
parse error、YAML、401或403，先处理订阅返回内容，不要继续改 TUN。 - 确认 Proxies 页面有节点。如果只有策略组、没有实际节点，问题仍在订阅内容或配置解析阶段；如果节点存在但全部测试失败，再进入节点可达性排查。
- 避免误选 Direct。在 Proxies 中手动选择一个明确的节点，不要先依赖自动选择。若选择节点后仍然无法访问，再查看 Connections 中请求是否进入客户端。
- 确认模式。Rule 模式下，请求会按规则进入不同策略；Global 模式适合短时间验证；Direct 会绕过代理。测试时只改变一个变量，例如先保持 Rule 不变，仅手动换一个节点。
推荐先用浏览器访问一个普通 HTTPS 页面测试系统代理，再测试终端或其他应用。浏览器能用而终端不能用，通常说明目标应用没有读取系统代理，或需要单独配置 HTTP/SOCKS 代理；这时不要把现象直接归因于节点故障。
如果你需要先完成订阅导入，可参考站内的Clash Verge Rev 怎么导入订阅链接？完整步骤与失败排查；如果已经导入但仍然异常，可继续查看Clash Verge Rev 进阶指南：内核、协议、分流、规则与用日志排障。
第二层：按系统检查端口、系统代理和 TUN
Windows：用 netstat 找监听端口和占用进程
先在 Clash Verge Rev 的设置或配置中确认当前 HTTP、SOCKS 或 mixed 监听端口，下面的命令把 PORT 替换成实际端口，不要固定套用某个默认值。
netstat -ano | findstr :PORT
若看到 LISTENING，说明该端口有程序监听；记下最后一列 PID，再执行：
tasklist /FI "PID eq PID"
如果 PID 对应的不是 Clash Verge Rev 或 Mihomo，而是另一个代理、VPN 或旧进程，就可能发生端口冲突。可以先退出冲突程序，再重新开启系统代理。Microsoft 文档说明，netstat 可显示活动连接、监听端口和进程相关信息，参数 -o 用于显示关联 PID。
TUN 无法开启时，先检查 Windows 防火墙是否阻止 Mihomo 核心或服务进程；不要直接关闭整套防火墙。先关闭 TUN，确认系统代理可用，再按项目文档重新启用 TUN，并观察是否出现权限、服务或虚拟网卡错误。
命令参考：Microsoft Learn 的 netstat 文档。系统兼容性和安装包渠道可参考项目安装文档。
macOS：用 lsof 检查端口和进程
在终端执行：
lsof -nP -iTCP:PORT -sTCP:LISTEN
如果输出为空，说明没有进程监听该端口，优先检查核心是否启动、配置是否加载或端口是否填错；如果输出显示其他进程占用，退出该进程后再测试。若系统代理开关显示已开启但浏览器仍直连，检查是否存在其他代理软件、浏览器单独代理或网络位置配置覆盖。
macOS 上 TUN 失败时，先关闭 TUN 验证系统代理，再检查系统是否弹出网络扩展或权限提示。普通订阅导入流程无需调整 MTU；只有服务提供方或配置文档明确要求时，才按其说明调整，并在修改前备份配置。
站内的Clash Verge for Mac 使用教程适合核对 macOS 的基础界面路径。
Linux：用 ss 查看监听端口
执行：
ss -lntup | grep ':PORT'
-l 表示监听状态，-n 保留数字端口，-t 和 -u 分别查看 TCP、UDP，-p 显示进程信息。若没有输出，端口未监听；若进程不是 Clash Verge Rev 或 Mihomo，先处理占用。Linux 系统代理还可能依赖桌面环境或命令行环境，浏览器正常不代表所有终端程序都会自动使用代理。
ss 是用于查看 socket 状态的系统工具，相关参数可参考Linux ss 手册。站内的Clash Verge for Linux 使用教程可用于核对 Linux 安装和基础设置。
第三层：看日志关键词，先处理最明确的错误
| 日志片段 | 通常表示什么 | 处理顺序 |
|---|---|---|
timeout | 连接在规定时间内没有完成，可能是本地网络、节点、路由或端口问题 | 关闭 TUN，手动换节点；再检查本地网络和订阅状态 |
connection refused | 目标端口主动拒绝连接，或本机端口没有对应监听服务 | 核对实际端口和监听进程，不要盲目改 DNS |
DNS lookup failed、dns resolve failed | 域名解析没有得到可用地址 | 分别测试系统 DNS、配置中的 DNS 和节点域名；确认 TUN 下 DNS 是否被重新接管 |
TLS handshake | TLS 握手阶段失败，可能与系统时间、证书、协议或网络中断有关 | 确认系统时间正确，更新订阅后再换节点测试 |
parse error、YAML | 返回内容或配置文件无法按预期解析 | 重新获取订阅，检查是否被登录页、错误页或截断内容替代 |
401 或 403 | 订阅服务拒绝当前请求，可能是认证、权限或链接状态问题 | 重新核对订阅链接和认证信息，必要时向提供方确认 |
日志排查时只先处理第一条明确错误，并且每次只改一个设置。不要把完整订阅链接、访问凭证或包含敏感信息的配置直接发到公开 issue；项目隐私说明也提醒用户不要公开包含凭证的日志和配置。
第四层：DNS、Rule、TUN 与特殊场景的验证方法
只有某个网站打不开
先在 Connections 中查看该请求是否出现、命中了哪条 Rule、最终走了哪个策略组。如果请求命中 Direct，说明问题可能是规则结果而不是节点；如果请求没有出现，可能是浏览器缓存、浏览器独立代理或应用自身网络设置。
节点能测速，但网页打不开
测速成功只能说明某个测试请求在当时完成，不等于所有域名、协议和规则都正常。手动固定一个节点，先测试普通 HTTPS 页面，再查看失败网站对应的 Connections 记录；如果普通页面正常而目标站点失败，重点检查 Rule、DNS、IPv6 或目标站点兼容性。
浏览器能用，但终端或游戏不能用
系统代理是应用自愿读取的约定，部分终端工具、游戏或后台服务不会自动读取。可以在应用自身设置中填写客户端提供的 HTTP/SOCKS 代理地址和实际端口；若应用只支持 UDP 或不支持系统代理，TUN 可能是需要验证的方向，但应先确认系统代理已恢复，再处理 TUN 权限和防火墙。
TUN 开启后断网
- 关闭 TUN，确认系统代理仍能访问。
- 检查是否有其他 VPN、虚拟网卡、代理软件同时运行。
- 查看日志是否出现 DNS 解析、路由或权限错误。
- 确认防火墙放行的是项目文档提到的 Mihomo 核心和服务进程，而不是直接关闭防火墙。
- 若关闭 TUN 后仍断网，先恢复系统代理和网络接口，再继续排查。
恢复后的验收清单：确认真的修好了
- Profiles 显示配置更新成功，当前选中的 Profile 不是旧配置。
- Proxies 中存在节点，并且手动选择的节点测试结果不再全部超时。
- 系统代理开关状态与实际端口一致，端口由正确进程监听。
- Connections 中能看到测试请求，Rule 命中结果符合预期，Chains 显示使用了选择的节点或策略组。
- 浏览器、需要系统代理的应用和不读取系统代理的应用分别验证，不把一种应用的结果当成全局结论。
- 若修改过配置、DNS 或 TUN 参数，保留修改前备份，便于出现新问题时回退。
截至 2026-10-19，公开发布页的版本和资产可能继续变化，本文不把某个版本号当作唯一修复条件。升级前应在项目 Releases 页面核对版本、系统架构和发布说明；若升级后才出现故障，先记录升级前后的版本，再按本文的最小改动顺序回退验证。
常见问题 FAQ
Clash Verge Rev 连接失败，是否应该直接重装？
通常不应作为第一步。先备份配置并确认 Profile、节点、模式、端口和日志；只有在程序无法启动、核心文件损坏或配置无法恢复时，才考虑重装，并优先从项目 Releases 页面获取安装包。
为什么系统代理已经打开，部分软件仍然不能联网？
系统代理依赖应用读取系统设置，不是所有程序都会遵守。先用浏览器验证端口和节点，再检查目标软件是否有独立代理设置；如果目标软件不读取系统代理，再评估 TUN 是否适合，并先处理权限、虚拟网卡和防火墙问题。
节点全部 timeout，是 DNS 还是节点失效？
两者都有可能。先关闭 TUN，用同一节点测试；再观察日志是连接超时、DNS 解析失败还是 TLS 握手失败。如果多个节点、多个网络环境都失败，优先核对订阅状态和节点信息；不要只改 DNS 就下结论。
日志出现 connection refused，应该改 MTU 吗？
不应直接改 MTU。该错误首先指向目标端口被拒绝或本机没有对应服务监听，应先检查实际端口、监听进程和配置。普通订阅导入流程无需调整 MTU；需要调整时，以服务提供方或配置文档为准，并先备份。
如何判断请求到底有没有进入 Clash Verge Rev？
打开 Connections，访问一个明确的测试页面，观察是否出现对应域名、命中的 Rule、策略组和最终节点。没有连接记录时，先查系统代理、应用独立代理和端口；有记录但失败时，再根据日志判断节点、DNS 或 TLS 层问题。
常见问题
Clash Verge Rev 连接失败，是否应该直接重装？
通常不应作为第一步。先备份配置并确认 Profile、节点、模式、端口和日志；只有在程序无法启动、核心文件损坏或配置无法恢复时，才考虑重装，并优先从项目 Releases 页面获取安装包。
为什么系统代理已经打开，部分软件仍然不能联网？
系统代理依赖应用读取系统设置，不是所有程序都会遵守。先用浏览器验证端口和节点，再检查目标软件是否有独立代理设置；如果目标软件不读取系统代理，再评估 TUN 是否适合。
节点全部 timeout，是 DNS 还是节点失效？
两者都有可能。先关闭 TUN，用同一节点测试；再观察日志是连接超时、DNS 解析失败还是 TLS 握手失败。多个节点都失败时，优先核对订阅状态和节点信息。
日志出现 connection refused，应该改 MTU 吗？
不应直接改 MTU。该错误首先指向目标端口被拒绝或本机没有对应服务监听，应先检查实际端口、监听进程和配置。普通订阅导入流程无需调整 MTU。
如何判断请求到底有没有进入 Clash Verge Rev？
打开 Connections，访问测试页面，观察是否出现对应域名、命中的 Rule、策略组和最终节点。没有记录时先查系统代理、应用独立代理和端口；有记录但失败时再判断节点、DNS 或 TLS。
相关阅读
- Clash Verge Rev 怎么导入订阅链接？完整步骤与失败排查
- Clash Verge Rev 进阶指南：内核、协议、分流、规则与用日志排障
- Clash Verge 使用教程
- Clash Verge for Mac 使用教程
- Clash Verge for Linux 使用教程