Clash Verge Rev 导入订阅:6步完成激活、更新与排错
简答:Clash Verge Rev 导入订阅的关键不是只粘贴 URL,而是依次完成 6 步:确认拿到的是远程订阅链接、进入 Profiles 导入、激活配置、在 Proxies 选择节点、开启 System Proxy 或 TUN、通过 Connections 或日志验证请求。导入后没有节点时,先查返回内容和当前配置,再查节点与系统代理。
定义:Clash Verge Rev 导入订阅,是把远程配置 URL 或本地 YAML 文件添加为 profile,再激活该 profile,由 Mihomo 内核加载节点、代理组和规则。
先认清你手里的链接:登录地址、订阅 URL 和单节点不是一回事
如果你刚拿到一串地址,先不要直接粘贴。Clash Verge Rev 官方文档把远程订阅和本地配置分开处理:远程订阅可以通过订阅链接导入、订阅链接配置或 URL Scheme 添加;本地配置则支持新建配置文件和拖拽配置文件导入。具体按钮名称可能随版本变化,入口通常围绕 Profiles、订阅或配置展开,可参考项目配置文档。
| 你手里的内容 | 识别方法 | 正确处理 |
|---|---|---|
| 机场登录地址 | 打开后是登录页、套餐页或控制台 | 不能直接当订阅使用;登录后寻找“订阅”“复制订阅链接”或同类入口 |
| 远程订阅 URL | 通常是 HTTP 或 HTTPS 地址,可能带较长参数或令牌 | 完整复制,粘贴到 Profiles 的远程订阅输入位置 |
| 单节点链接 | 只描述一个节点,常见为单条协议链接 | 不要直接当多节点订阅 URL;官方文档未核实 Clash Verge Rev 支持在远程订阅框直接粘贴所有单节点格式 |
| 本地 YAML | 文件内容通常包含 proxies:、proxy-groups:、rules: 等字段,也可能先出现 port:、mixed-port: 或 dns: | 保存为 YAML 文件后,通过本地配置方式导入 |
单节点链接的可照做处理方式是:先向配置提供方获取包含该节点的 Clash/Mihomo YAML;如果对方只提供单节点链接,则需要使用对方明确支持的转换方式生成 YAML,或者按 Mihomo 配置格式手动写入 proxies:,再保存为 .yaml 文件并从 Profiles 导入。协议字段、加密方式和传输参数不能凭链接名称猜测;不确定时不要把单节点链接粘贴到远程订阅框,否则常见结果是返回内容无法解析或代理页为空。
导入前先备份,再按 6 步完成订阅激活
已有可用配置时,先在应用的备份设置中创建本地备份。当前项目的隐私政策显示,配置和下载的订阅通常保存在应用数据目录中,目录位置按系统不同:Windows 为 %APPDATA%\io.github.clash-verge-rev.clash-verge-rev,macOS 为 ~/Library/Application Support/io.github.clash-verge-rev.clash-verge-rev,Linux 为 $XDG_DATA_HOME/io.github.clash-verge-rev.clash-verge-rev,通常位于 ~/.local/share/ 下。备份时至少复制 config.yaml、profiles.yaml 和 profiles 目录,依据项目隐私政策核对实际路径。
- 复制完整订阅地址:从配置提供方后台复制远程订阅 URL,避免复制登录地址、二维码页面或带换行的残缺文本。订阅 URL 可能包含个人令牌,不要公开发送。
- 打开 Profiles:启动 Clash Verge Rev,在侧栏寻找 Profiles、配置或订阅页面。若界面语言不同,优先寻找远程配置、Remote Profile 或 URL 输入框。项目官方文档没有把所有版本按钮名称固定为同一套,旧版本和新版本需以实际界面为准。
- 导入远程 URL:将完整 URL 粘贴到远程订阅输入框,点击导入、添加、保存或确认。预期结果是列表出现新的远程配置卡片;如果只弹出成功提示但列表没有卡片,说明导入未完成。
- 激活当前配置:点击新配置卡片或选择按钮,使它成为当前 profile。保存 URL 不等于内核已经使用它;如果当前配置仍是旧文件,Proxies 页面可能继续显示旧节点。
- 进入 Proxies 选择节点:确认页面出现代理组或节点,选择一个具体节点,或选择配置中的自动选择组。若 Proxies 完全为空,先回到 Profiles 检查当前卡片、更新时间和解析错误,不要立刻开启 TUN。
- 开启代理并验证:在设置中打开 System Proxy。官方界面文案说明,System Proxy 用于修改操作系统代理设置;TUN 是虚拟网卡模式,开启后通常不需要再开启 System Proxy,但 TUN 需要 Service Mode 或 Admin Mode。相关开关和提示可参考项目当前界面文案。
导入成功三条件:第一,Profiles 中有目标配置卡片;第二,该卡片已成为当前配置;第三,Proxies 页面能看到代理组或节点。只看到“导入成功”提示,不能单独证明订阅已经生效。
Windows、macOS、Linux 的入口和开关差异
三种桌面系统都使用 Profiles 添加远程配置,差异主要集中在本地文件路径、系统代理权限、TUN 服务和托盘行为。项目仓库明确支持 Windows、macOS 和 Linux;具体菜单文字、托盘项和权限提示以当前版本界面为准,可从项目仓库及其发布页面核对。
| 系统 | 导入入口 | 开启代理时重点检查 | 配置备份位置 |
|---|---|---|---|
| Windows | Profiles 或配置页面;本地 YAML 可按文件选择或拖拽方式处理 | System Proxy 是否成功写入系统;TUN 或 Service Mode 若提示权限,使用管理员权限重新启动并按提示安装服务 | %APPDATA%\io.github.clash-verge-rev.clash-verge-rev |
| macOS | Profiles 或配置页面;官方文档说明 Verge 2.0 以后支持通过 URL Scheme 导入 | 检查当前网络服务是否写入系统代理;TUN 或服务权限失败时先关闭 TUN,再按界面提示处理 | ~/Library/Application Support/io.github.clash-verge-rev.clash-verge-rev |
| Linux | Profiles 或配置页面;本地 YAML 可按当前版本提供的文件导入方式处理 | 桌面代理不一定影响终端程序;终端应用可能需要单独设置代理变量,或改用 TUN | $XDG_DATA_HOME/io.github.clash-verge-rev.clash-verge-rev |
官方文档还指出,Windows 不能使用 URL Scheme 时需要单独排查该功能;本地配置拖拽导入有版本要求,文档标注至少为 v1.6.2。本文不把这个版本要求扩展为当前安装包版本结论,实际支持情况需以当前版本为准。
更新订阅、设置 User-Agent 与多订阅切换
远程 profile 的更新本质上是应用再次请求你提供的 URL。项目隐私政策说明,默认请求会携带类似 clash-verge/v版本号 的 User-Agent,也支持针对 profile 设置不同 User-Agent;请求还可以按 profile 设置为直连、通过系统代理或使用应用自身代理端口。相关选项是否显示、具体菜单名称和默认值,需以当前版本为准。
- 手动更新:回到 Profiles,找到远程配置卡片,点击刷新、更新或更多操作中的更新项。预期结果是更新时间或配置内容发生变化;若更新时间不变,先检查 URL 是否有效。
- 设置自动更新:在远程 profile 的编辑或更多选项中查找更新间隔、自动更新或定时刷新。若看不到该选项,不要直接修改 YAML 猜测字段,先以当前版本支持的界面为准。
- 订阅域名访问超时:如果客户端提示
timeout,先判断是订阅域名在当前网络下不可达,还是节点本身不可用。可在 profile 的更新设置中查找“通过系统代理”“通过代理更新”或类似选项;这些名称和是否存在需核实。若浏览器和客户端都无法访问订阅 URL,优先处理域名、网络或服务端问题。 - User-Agent 返回错误格式:有些配置服务会根据 User-Agent 返回不同内容。如果浏览器打开的是登录 HTML、JSON 错误信息,而客户端需要 YAML,可在 profile 设置中查找 User-Agent,按配置提供方要求填写;如果该选项不存在,则向配置提供方索取适配 Clash/Mihomo 的订阅地址。
- 多个订阅切换:分别添加多个远程 profile,不要把多个 URL 粘成一行。使用前点击目标卡片并确认它成为当前配置,再进入 Proxies。多个卡片不会自动合并,也不代表同时生效。
官方项目文档还列出“订阅链接导入”与“订阅链接配置”两种方式;如果前者出现 client error(Connect),可尝试另一种导入方式。若“订阅链接配置”仍失败,文档提到可尝试勾选“允许无效证书(危险)”,但这会降低传输校验强度,只应在确认订阅地址和证书来源可信、且理解风险时使用,不能作为常规修复方案。参考官方项目文档。
导入成功但没有节点或无法上网:按现象逐层排查
| 现象或报错原文 | 先检查什么 | 处理动作 | 复原方法 |
|---|---|---|---|
401 Unauthorized | 账号授权、令牌和订阅是否过期 | 登录配置提供方后台重新复制或生成订阅 URL,再替换旧 profile | 删除失败 profile,切回原可用配置 |
403 Forbidden | 访问权限、来源限制或链接状态 | 重新生成订阅链接;不要持续刷新同一失效地址 | 恢复备份中的旧 profile |
client error(Connect) | 导入方式与当前网络 | 尝试官方文档列出的另一种远程订阅导入方式;仍失败时检查订阅域名连通性 | 保留原配置,不删除备份 |
timeout | 订阅域名是否在当前网络下超时 | 先检查通过代理更新、系统代理或 profile User-Agent 选项;若浏览器也超时,问题不一定在节点 | 关闭自动更新,避免反复请求失败地址 |
YAML parse error 或 Invalid YAML format | 返回内容是不是 YAML | 检查是否拿到登录 HTML、JSON 错误页、空内容或被截断的文本 | 删除损坏 profile,重新导入原始 URL |
| 导入成功但 Proxies 没有节点 | 当前 profile 和配置字段 | 确认目标卡片已激活;检查内容是否包含 proxies:、代理提供器或代理组字段 | 切回上一张可用配置 |
| 有节点但全部超时 | 节点可达性、系统时间、网络和 TUN | 测试多个节点;暂时关闭 TUN,改用 System Proxy 做对照 | 关闭 TUN,恢复原代理模式 |
| 代理已开但网页打不开 | Connections、规则模式和浏览器代理 | 确认请求是否出现在 Connections;检查是否命中 DIRECT、REJECT 或 timeout | 恢复原规则模式和系统代理状态 |
最小复现顺序是:第一,确认订阅 URL 能返回内容;第二,只保留一个 profile 并激活它;第三,只测试一个节点;第四,只开启 System Proxy,不同时开启 TUN;第五,在 Connections 或日志中观察实际请求。若请求没有记录,优先查系统代理或应用是否使用了另一套代理设置;若请求显示 DIRECT,优先查规则;若显示 REJECT,说明规则主动拒绝;若显示 timeout,再查节点、DNS 和线路。
提交问题前请遮盖订阅令牌、服务器地址、密码、UUID 和完整日志。项目隐私政策说明,配置文件和日志可能包含订阅 URL、节点凭据、请求域名及连接元数据,不应原样公开。
本文核对日期与资料边界
本文按 2026年11月14日 核对公开资料。Clash Verge Rev 的项目仓库和文档确认其支持 Windows、macOS、Linux,并提供远程 profile、本地配置、System Proxy 和 TUN 相关功能;版本号、默认值、按钮名称、更新间隔以及某个订阅服务是否可用,均不在本文中作未经核实的固定承诺。
本文是第三方使用指南,不是 Clash Verge Rev 官方页面。安装包、版本变更和具体界面请以项目 Release 页面及当前安装界面为准。
常见问题
Clash Verge Rev 导入订阅后为什么没有节点?
先确认 Profiles 中出现了正确配置卡片,并确认该卡片已激活。然后检查返回内容是否真的是 YAML,是否包含 proxies、proxy-groups、proxy-providers 等相关字段。如果返回的是登录 HTML、JSON 错误页、空内容或单节点链接,代理页可能为空。
Clash Verge Rev 导入订阅后还要开启什么?
导入和激活只负责让客户端加载配置。需要浏览器等遵守系统代理的程序使用时,开启 System Proxy;需要接管不遵守系统代理的程序时,再根据当前版本提示考虑 TUN。通常先用一种方式完成验证,不要同时开启两者。
订阅链接出现 401、403 或 timeout 怎么办?
401 先查授权和订阅令牌,403 先查链接状态、访问权限或来源限制,timeout 先区分订阅域名超时还是节点超时。重新生成链接后替换旧 profile;如果当前版本提供通过系统代理更新或 User-Agent 设置,再按配置提供方要求调整。
Clash Verge Rev 支持直接导入单节点链接吗?
项目公开文档明确说明远程订阅和本地配置的导入方式,但没有在该文档中确认所有单节点协议链接都能直接粘贴到远程订阅框。因此不要默认支持。更稳妥的做法是获取包含该节点的 Clash/Mihomo YAML,或按已确认的配置格式写入 YAML 后作为本地配置导入。
远程订阅和本地 YAML 有什么区别?
远程订阅保存 URL,后续可以按设置重新请求并更新;本地 YAML 保存当前文件内容,适合备份、手动编辑和固定配置。远程订阅可能因提供方更新而改变内容,本地文件则需要手动维护。
如何确认导入的配置真的在使用?
同时检查三个位置:Profiles 中目标卡片已被选中,Proxies 中出现该配置的节点或代理组,Connections 或日志中出现实际请求。只看到订阅卡片,不能证明内核已经使用该配置。