Clash Verge Rev订阅导入后连接失败：client error(Connect)怎么排查
简答：先确认订阅地址来自当前官方页面且返回的是可识别配置，再检查配置是否选中、系统代理是否生效和本地端口是否冲突。出现 client error(Connect) 时，优先改用“订阅链接配置”；证书选项只做短时验证。
定义：Clash Verge Rev订阅导入后连接失败，是指订阅地址、配置下载、配置启用、系统代理接管或节点连接其中一层未正常完成。
先试这一步：按现象判断从哪一层开始
订阅卡片已经出现却上不了网，或一点导入就报 client error(Connect)？先不要同时修改 DNS、TUN、模式和节点。本文是第三方使用指南，订阅入口与账户信息以官方页面为准。
| 现象 | 先检查 | 正常判定 |
|---|---|---|
| 点击导入立即报错 | 入口、URL、下载路径、证书 | 能取得配置文本，且没有登录页或 HTML 错误页 |
| 有订阅卡片但没有节点 | 返回格式、当前配置 | 手动选中卡片后，代理页出现节点或策略组 |
| 节点存在但全部超时 | 代理模式、端口、节点路径 | 至少能区分是全部节点失败，还是单个节点失败 |
| 浏览器能用，其他程序不能用 | 系统代理或 TUN | 打开系统代理后，遵循系统代理的浏览器可正常请求 |
官方快速入门把流程分为导入订阅、选择节点和模式、打开系统代理或 TUN；系统代理主要处理遵循系统代理的浏览器，TUN 则通过虚拟网卡接管不支持系统代理的程序。参考：快速入门 - Clash Verge Rev Docs。
第一层：重新确认入口和订阅返回内容
- 打开获取订阅的当前控制台，不要从聊天记录、搜索结果或第三方转载页面复制旧地址。freecat.buzz 页面在 2026-10-24 显示内容已迁移至新版网站；如果订阅来自旧入口，请按当前页面指引重新获取地址，以官方为准。参考：freecat.buzz 页面。
- 重新复制完整 URL，检查是否混入空格、换行、引号或“订阅地址：”等说明文字。订阅链接可能包含访问凭证，不要把完整链接发到论坛、截图或公共设备。
- 在本机私密环境测试返回内容。下面命令的目的只是保存响应并查看开头内容；示例 URL 必须替换为你的订阅 URL，执行前确认本机已安装 curl。
curl -L --max-time 20 -A "clash" "替换为你的订阅URL" -o profile.txt
head -n 20 profile.txt判定标准：如果开头能看到配置文本、代理、规则或策略相关字段，说明至少取得了文本；如果是登录页、验证码、HTML 错误页、空文件或超时，先处理入口、授权或网络路径。不要把包含凭证的 profile.txt 上传到公共检测网站。
第二层：按报错选择导入方式
| 报错或现象 | 可照做的动作 | 结论边界 |
|---|---|---|
client error(Connect) | 进入 Profiles，改用“订阅链接配置”重新添加；仍失败时再考虑其他官方支持的导入方式 | 官方建议尝试其他导入方式，不能仅凭此报错认定订阅失效 |
invalid peer certificate | 确认订阅来源可信后，临时勾选“允许无效证书（危险）”并保存重试；成功后立即关闭 | 这是证书路径的测试，不应长期关闭证书校验 |
failed to fetch remote profile | 在订阅编辑界面分别测试直连、系统代理和当前 Clash 代理，每次只改一个选项后点击更新 | 仅凭报错文字无法判断是 DNS、证书、代理回环还是远端响应问题 |
legacy TLS | 记录完整报错、系统时间和客户端版本，再尝试另一种导入方式 | 未核实前不要断言一定是客户端或服务端版本问题 |
timeout 或拒绝连接 | 检查本地代理端口、当前代理路径，再单独测试其他节点 | 一次超时不能代表整份订阅不可用 |
说明：除 client error(Connect) 和无效证书选项外，上表对 failed to fetch remote profile、legacy TLS 和 timeout 的处理属于常见经验判断，不是 Clash Verge Rev 官方对错误含义的逐条定义。官方订阅文档明确写出：订阅链接导入出现 client error(Connect) 时尝试其他方式；订阅链接配置仍出现该错误时，可勾选“允许无效证书（危险）”保存重试。参考：订阅导入 - Clash Verge Rev Docs。
如果已经取得配置文本，可以保存为本地 YAML，再在 Profiles 中选择本地配置导入。官方文档列出“新建配置文件导入”和“拖拽配置文件导入”；拖拽导入要求 Clash Verge Rev 至少为 v1.6.2。仍然不要上传含订阅凭证的配置文件。
第三层：确认配置已选中，再测试系统代理
- 回到 Profiles，点击刚导入的订阅卡片，使它成为当前配置；如果卡片存在但代理页为空，先更新一次，再重新点击卡片。
- 进入代理页面，确认至少出现节点或策略组。列表为空时，优先检查返回格式和当前配置，不要先开启 TUN。
- 只打开系统代理测试浏览器。测试时不要同时开启其他代理软件，避免多个程序反复写入系统代理。
- 如果浏览器仍无响应，关闭系统代理后重新打开一次，并检查系统代理中的地址和端口是否与 Clash Verge Rev 当前监听值一致。
- 系统代理路径正常后，再单独测试 TUN。TUN 需要虚拟网卡和相应权限，不能用它替代订阅下载失败的排查。
判定标准：打开系统代理后，遵循系统代理的浏览器请求应出现变化；关闭后应恢复直连路径。两次测试之间只改一个变量，才能判断问题发生在系统代理、TUN 还是节点本身。官方对系统代理与 TUN 的区别见快速入门 - Clash Verge Rev Docs。
Windows、macOS、Linux：权限和端口怎么查
| 平台 | 重点检查 | 可执行动作 |
|---|---|---|
| Windows | 系统代理残留、端口冲突、TUN 或服务权限 | 在“设置→网络和 Internet→代理”关闭后重新由客户端接管；若本地端口被占用，关闭冲突程序或改用未占用端口 |
| macOS | 系统代理权限、TUN 对系统 DNS 的影响 | 系统代理开关无效时检查管理员权限；开启 TUN 后出现 DNS 变化，先关闭 TUN 做对照 |
| Linux | 图形环境、桌面代理入口、权限与端口 | GNOME 可在“设置→网络→网络代理”检查；KDE 可在“系统设置→网络→代理”检查；终端程序另查 http_proxy、https_proxy 环境变量 |
Windows 还可在本机检查端口占用。命令目的只是确认指定端口是否已有监听，Windows 需要 PowerShell 或命令提示符：
netstat -ano | findstr LISTENING
tasklist /FI "PID eq 替换为PID"把“替换为PID”改成上一条命令显示的数字；正常结果应能对应到 Clash Verge Rev 或你确认过的程序。macOS 和 Linux 可使用：
lsof -nP -iTCP:替换为端口 -sTCP:LISTEN如果结果显示其他进程占用了端口，先关闭冲突程序或在客户端设置中改用未占用端口，再重新打开系统代理测试。官方 FAQ 也提示，其他程序可能占用代理端口，示例默认代理端口为 7897，但实际端口应以当前客户端界面为准。参考：其他问题 - Clash Verge Rev Docs。
macOS 官方 FAQ 说明，TUN 启动时系统 DNS 可能被修改，关闭 TUN 后恢复原来的系统 DNS；系统代理开关无效时，也可能与管理员权限有关。参考：MacOS - Clash Verge Rev Docs。Linux 官方 FAQ 说明，Clash Verge Rev GUI 需要图形化界面；没有图形界面时不能直接使用该 GUI。参考：Linux - Clash Verge Rev Docs。
节点全部超时：说明问题已经进入下一层
如果订阅文本能取得、配置卡片能选中、代理页也能显示节点，但所有节点都超时，问题已经不再是单纯的“订阅导入失败”。先确认系统代理或 TUN 只启用了一个，再测试一个节点；随后检查本地端口、DNS 和网络路径。不要用单个节点超时推断整份订阅失效，也不要在没有记录变量的情况下连续更换多个设置。
- 只有一个节点超时：优先记录该节点报错，再测试另一个节点。
- 所有节点超时但代理端口正常：检查当前网络、DNS 和客户端日志。
- 浏览器能用但命令行不能用：优先检查命令行是否遵循系统代理，必要时查看
http_proxy与https_proxy。 - 开启 TUN 后才失败：关闭 TUN，用系统代理复测；macOS 还要对照 DNS 是否发生变化。
最后一步：导出可复现日志并脱敏
如果仍无法定位，先记录操作系统、客户端界面显示的版本、导入方式、完整英文报错、是否开启系统代理或 TUN，以及复现顺序。官方日志文档要求：修改日志级别后退出并重启软件，重新复现错误，再找到与当前日期相同的日志文件；logs 目录默认保存 GUI 日志，service 目录保存内核日志。参考：导出日志 - Clash Verge Rev Docs。
- 导出前遮盖订阅 URL、token、节点地址、密码、UUID、IP 和访问域名。
- 把问题归类为“订阅下载失败”“配置解析失败”“代理未接管”或“节点连接失败”。
- 日志导出后，可按官方说明把日志等级改回
INFO，避免长期产生过多日志。
常见问题
Clash Verge Rev出现 client error(Connect)怎么办？
先确认订阅 URL 来自当前官方页面，再进入 Profiles 改用“订阅链接配置”。官方文档明确建议该错误尝试其他导入方式；不要仅凭这条报错认定订阅失效。
浏览器能打开订阅链接，为什么客户端仍导入失败？
浏览器和客户端可能使用不同的代理、证书校验或请求路径。请在本机私密环境检查返回内容，再在订阅编辑界面分别测试直连、系统代理和当前 Clash 代理，每次只改一个选项。
invalid peer certificate可以一直关闭证书校验吗？
不建议。只有在订阅来源可信、需要验证证书路径时，才临时勾选“允许无效证书（危险）”；测试成功后立即关闭，并继续核对订阅地址。
导入成功但代理页没有节点是什么原因？
先手动点击订阅卡片使其成为当前配置，再更新一次并检查返回内容。若返回的是登录页、HTML 错误页或其他格式，卡片可能存在但无法生成可用节点。
节点全部超时，是否说明订阅失效？
不能直接这样判断。先确认代理端口正常、系统代理或 TUN 只启用了一个，再测试其他节点；如果订阅卡片和节点列表正常，问题可能已经进入节点或网络路径排查。
Linux上如何排查Clash Verge Rev订阅连接失败？
先确认有图形化界面，因为官方文档说明该 GUI 需要图形环境；随后在 GNOME 或 KDE 的网络代理设置中检查系统代理，并单独检查终端的 http_proxy、https_proxy 环境变量和本地端口。
相关阅读
参考资料
- 订阅导入 - Clash Verge Rev Docs（clashverge.dev）
- 快速入门 - Clash Verge Rev Docs（clashverge.dev）
- 其他问题 - Clash Verge Rev Docs（clashverge.dev）
- MacOS - Clash Verge Rev Docs（clashverge.dev）
- Linux - Clash Verge Rev Docs（clashverge.dev）
- 导出日志 - Clash Verge Rev Docs（clashverge.dev）
- freecat.buzz 页面