Clash Verge Rev 导入订阅教程:添加、启用与失败排查
简答:Clash Verge Rev 导入订阅的最短路径是:打开“订阅”页面,粘贴可用的配置链接并导入;再点击订阅卡片使其成为当前配置,进入“代理”选择节点,最后开启系统代理。若失败,先检查返回内容是否为 Clash/Mihomo 配置,再按连接、格式和节点状态分流排查。
定义:Clash Verge Rev 订阅导入,是把远程配置链接或本地 YAML 配置文件加入客户端,并经过激活配置、选择节点和开启代理后完成使用的过程。
先看最快操作:导入成功不等于代理已生效
如果你已经拿到订阅链接,先不要反复点击更新。按下面四个验收点操作:导入成功看得到配置卡片,激活成功看得到当前配置,节点可用能在“代理”页面看到代理组或节点,代理生效则是系统代理开关开启后浏览器或目标应用能够通过客户端连接。
| 阶段 | 操作 | 正常结果 | 不正常时先查什么 |
|---|---|---|---|
| 导入 | 打开“订阅”页面,粘贴链接并执行导入 | 出现订阅或配置卡片 | 链接是否完整、是否返回配置内容 |
| 激活 | 点击刚导入的卡片或其操作菜单 | 该配置成为当前使用配置 | 是否只是保存,没有切换到当前配置 |
| 选节点 | 进入“代理”页面,选择代理组和节点 | 节点列表能够显示 | 格式是否兼容、订阅是否为空或已过期 |
| 启用 | 打开系统代理;必要时再考虑 TUN | 支持系统代理的应用开始走客户端 | 系统代理开关、端口占用和权限 |
官方文档将远程订阅分为订阅链接导入、订阅链接配置和 URL Schemes,也支持新建本地配置文件与拖拽配置文件导入。资料核验日期:2026-11-02。查看官方订阅导入文档
适用平台与导入前准备
Clash Verge Rev 是桌面客户端,官方项目页面列出的运行平台包括 Windows、macOS 和 Linux。不同系统和版本的菜单位置可能略有变化,因此本文使用功能名称描述入口,不把某个版本的截图位置当成永久不变的路径。当前版本、安装包和系统要求应以官方发布页为准;截至资料核验日期,官方发布页可核验到 Clash Verge Rev v2.5.8,但更新后界面仍可能调整。查看官方 Release 页面
- 准备一条完整的订阅链接,不要只复制链接名称、二维码旁的标题或网页地址。
- 确认提供方说明的格式与客户端匹配。订阅链接本身不能证明返回内容一定是 Clash、Clash Meta 或 Mihomo 配置,必须以实际响应内容和提供方说明为准。
- 导入前先保存当前配置,避免排错时误删原有可用配置。
- 不要把带有个人授权信息的订阅链接发到公开论坛、截图或在线文本框;如果链接已经泄露,按提供方支持的方式更换或重置。
如果你拿到的是本地 YAML 文件而不是远程链接,可以直接使用本地配置导入,不必把文件上传到第三方网站。
远程订阅导入:Windows、macOS、Linux 通用步骤
- 打开客户端并进入订阅功能。在左侧导航或配置管理区域找到“订阅”相关页面。若当前版本没有完全相同的文字,寻找远程配置、订阅或 Profile 入口。
- 粘贴订阅链接。将完整链接粘贴到订阅地址输入框,检查开头、结尾和特殊字符是否完整。不要在链接后额外添加空格、说明文字或换行。
- 执行导入。点击导入、添加或保存。等待客户端完成请求,不要在请求尚未结束时连续点击。
- 确认卡片出现。导入成功的最低判断标准是列表中出现新的订阅或配置卡片;仅看到“已保存链接”不代表配置内容已成功下载。
- 激活当前配置。点击该卡片,或打开卡片操作菜单,将它切换为当前配置。部分版本在首次导入后可能自动使用该配置,也可能只保存不启用,应以当前页面的选中状态为准。
- 进入代理页面选节点。先选择代理组,再选择具体节点。如果只有配置名称、没有代理组或节点,进入异常分流部分。
- 开启系统代理。先使用系统代理处理支持系统代理的浏览器和桌面应用。官方快速入门将系统代理与 TUN 区分开:TUN 通过虚拟网卡接管不支持系统代理的程序,使用前应先了解权限和网络回滚方法。查看官方快速入门中的代理说明
可观察结果:导入后能看到卡片,激活后能看到当前配置,代理页能看到节点,开启系统代理后目标应用的连接记录或访问结果发生变化。不要只凭客户端图标变化判断代理已经生效。
本地 YAML、拖拽与 URL Schemes:远程导入失败时的替代路径
本地 YAML 文件:进入本地配置或新建配置文件入口,选择 YAML 文件后保存。官方文档说明,新建配置时可以选择文件,也可以先生成空配置;拖拽配置文件导入则要求客户端版本满足文档列出的最低版本条件。版本条件和菜单文字可能变化,操作前以当前官方文档为准。查看本地配置导入说明
URL Schemes:如果订阅提供方给出专用导入链接,可以尝试通过 URL Schemes 调用客户端。官方文档特别说明,macOS 的相关支持与 Verge 2.0 之后的版本有关;Windows 若调用失败,应改用普通订阅导入或本地文件导入,不要把 URL Schemes 失败误判成订阅内容损坏。
什么时候优先用本地文件:当远程请求持续超时、订阅地址需要特殊认证、或你已经能从可信来源获得 YAML 文件时,本地导入更容易把“网络请求问题”和“配置格式问题”分开。导入前保留原文件副本,排错结束后可删除测试配置并恢复原配置。
导入失败排查:按现象分流,不要一次改很多设置
提示 timeout、连接失败或 client error(Connect)
- 先用浏览器或系统网络工具确认订阅地址是否能建立连接;如果浏览器也无法打开,优先检查当前网络、域名解析和订阅提供方状态。
- 检查客户端的订阅请求方式、系统代理和配置代理是否互相影响。不要一开始就打开“允许无效证书”等高风险选项。
- 官方文档建议遇到 client error(Connect) 时尝试其他导入方式;可改用订阅链接配置、本地 YAML 或 URL Schemes。查看官方对 client error(Connect) 的处理建议
- 如果只有客户端失败而其他方式能访问,再检查客户端日志;记录错误原文后再判断是 TLS、认证、超时还是返回格式问题。
提示配置格式错误、无效 YAML 或导入后节点为空
- 确认链接返回的是配置文本,而不是登录页、HTML 错误页、JSON 提示或需要再次点击的网页。
- 确认提供方给出的格式与当前客户端支持的配置类型一致。不能因为链接名称写着“Clash”就直接认定返回格式正确。
- 用本地文件方式测试同一份配置。如果本地文件也无法识别,问题更可能在内容或格式;如果本地文件可用而远程链接失败,优先查订阅请求和响应内容。
- 节点为空时,先打开配置内容或日志确认是否真的返回了 proxies、proxy-groups 等配置数据;没有这些内容时不要继续反复测速。
导入成功但代理不生效
- 确认当前配置已经激活,而不是只存在于订阅列表。
- 进入“代理”页面选择节点和代理组;节点列表存在不代表已经完成选择。
- 确认系统代理开关已打开,并检查是否有其他客户端同时修改系统代理。
- 若目标应用不使用系统代理,再考虑 TUN;启用前记录原网络设置,遇到断网时先关闭 TUN、关闭系统代理并恢复原配置。
- 重新打开目标应用或浏览器后复测,并查看客户端日志。若只有单个应用失败,先判断该应用是否支持系统代理,而不是立即修改 DNS 或规则。
更新订阅、复测与回滚清单
手动更新:回到订阅或配置卡片,使用卡片菜单中的更新动作,等待更新完成后重新检查节点和当前配置。更新失败时先保留旧配置,不要先删除原卡片。
自动更新:如果当前版本提供自动更新选项,先确认更新间隔、请求方式和当前配置是否仍然使用旧内容。订阅更新请求会访问你填写的远程地址,官方隐私说明也指出,订阅提供方能够看到该请求的来源信息;因此不要把订阅链接分享给无关人员。查看官方隐私说明中的订阅更新部分
复测:按“配置已更新—当前配置已激活—节点可选择—系统代理已开启—目标应用重新连接”的顺序测试。每次只改变一个变量,例如先只更换节点,再判断是否需要调整系统代理或 TUN。
回滚:若更新后出现节点消失、代理异常或系统断网,先切回之前保存的配置,关闭系统代理和 TUN,再重启客户端复测。确认旧配置恢复后,再单独检查新订阅的返回内容和格式。
资料核验与使用边界
本文是 CnRocket 的第三方使用指南,不是 Clash Verge Rev 官方页面。本文只引用本次核验到的官方文档、官方项目页面和官方隐私说明;菜单名称、版本功能和安装包应以当前客户端与官方资料为准。关于具体订阅服务的状态、价格、套餐、可用性和格式,本文未作推断,需向订阅提供方核实。
如果你的目标只是完成导入,优先按“订阅页面—导入—激活—代理—系统代理”五步走;如果卡在某一步,保留错误原文和当前配置状态,再按上面的分流处理,通常比反复重装更容易定位问题。
常见问题
Clash Verge Rev 导入订阅后为什么没有节点?
先确认卡片是否真的完成更新,再检查返回内容是否为 Clash/Mihomo 配置,而不是 HTML 登录页或错误提示。若本地 YAML 也没有节点,优先向订阅提供方核实内容和格式;若本地文件正常而远程导入失败,重点检查连接、认证和订阅响应。
导入订阅后还需要点击激活吗?
通常需要确认该配置已经成为当前配置。导入成功只表示客户端保存或下载了配置,激活后才会作为当前配置使用;部分版本首次导入可能自动激活,应以当前页面的选中状态为准。
Clash Verge Rev 提示 client error(Connect) 怎么办?
先检查当前网络和订阅地址,再尝试官方文档列出的其他导入方式,例如订阅链接配置、本地配置文件或 URL Schemes。不要先勾选允许无效证书;只有在确认问题确实与证书有关、且理解风险时,才按官方说明处理。
开启系统代理后仍然无法访问怎么办?
依次确认配置已激活、代理组和节点已选择、系统代理开关已打开,并检查是否有其他客户端覆盖系统代理。若目标应用不支持系统代理,再考虑 TUN;修改前先记录原设置,方便关闭并回滚。
订阅链接可以直接当作 YAML 文件使用吗?
不能直接这样判断。订阅链接只是一个远程地址,实际返回内容可能是 YAML、其他配置格式、认证页面或错误信息;应以提供方说明和实际响应内容核验,不能只看链接名称。
相关阅读
参考资料
- Clash Verge Rev Docs:订阅导入(clashverge.dev)
- Clash Verge Rev Docs:快速入门(clashverge.dev)
- Clash Verge Rev 官方 GitHub Releases
- Clash Verge Rev 官方隐私说明