Clash Verge 一键导入链接与 URL Schemes 配置
制作一键导入订阅链接，处理 URL 编码、浏览器唤起及 Windows 协议关联问题。
本页目录
Clash Verge Rev 可以通过 clash://install-config 接收订阅地址。网页上的“一键导入”按钮先唤起客户端，再由客户端下载配置。浏览器能打开网站，并不代表客户端一定能取得订阅；这两个环节需要分开检查。
一键导入链接的格式
完整结构是：
clash://install-config?url=经过百分号编码的订阅地址
假设原始订阅地址为 https://example.com/subscription.yaml?plan=test&flag=meta，对应链接应当是：
clash://install-config?url=https%3A%2F%2Fexample.com%2Fsubscription.yaml%3Fplan%3Dtest%26flag%3Dmeta
这里的 &flag=meta 属于订阅地址，必须跟整个地址一起编码。如果只编码前半段，外层 URL 会把 & 当作分隔符，客户端拿到的订阅便不完整。示例域名仅用于说明格式，不能下载实际订阅。
在网页中制作导入按钮
已有网站可以使用下面的最小示例。把 subscriptionUrl 换成自己准备提供的配置地址，不要把订阅令牌硬编码到公共网页源码中。
<a id="import-config" href="#">导入到 Clash Verge Rev</a>
<script>
const subscriptionUrl =
'https://example.com/subscription.yaml?plan=test&flag=meta';
document.getElementById('import-config').href =
'clash://install-config?url=' + encodeURIComponent(subscriptionUrl);
</script>
encodeURIComponent 只用于内层订阅地址一次。不要再次对已经编码的结果编码，否则 %3A 会变成 %253A。完整的 clash:// 协议头也不能一起编码，否则浏览器只会把它当普通文字。
在客户端完成导入并检查结果
- 先手动打开 Clash Verge Rev，确认应用本身可以启动。
- 点击网页上的导入按钮。浏览器询问是否打开外部应用时，核对目标程序后允许打开。
- 回到客户端的“订阅”页，确认出现新配置卡片。如果客户端显示下载失败，先复制原始 HTTPS 订阅地址，通过订阅页的导入框单独重试。
- 选中需要启用的配置，进入“代理”页，确认策略组和节点实际出现。
- 检查当前代理模式及系统代理或 TUN 状态。导入配置只完成了配置获取，不会替你确认节点选择和所有程序的接管方式。
需要撤销时，在订阅页先切换回原先可用的配置，再删除新导入的卡片。不要先删除当前唯一可用配置，也无需修改系统协议关联来撤销一次订阅导入。
浏览器没有唤起客户端
如果点击后完全没有应用反应，先查看浏览器是否拦截外部协议，并确认电脑没有把 clash:// 关联到另一款 Clash 客户端。多款客户端共存时，默认处理程序可能与当前打开的程序不同。
Windows 可在注册表编辑器中查看：
HKEY_CLASSES_ROOT\clash\shell\open\command
该项应指向当前客户端真实存在的可执行文件。旧版软件卸载后留下的路径会导致唤起失败。修改前导出这一项作为备份；优先重新安装当前客户端以修复关联，不要照抄别人的安装路径。如果确实需要手动修改，应保留可执行文件路径的引号以及传入链接的 "%1" 参数。恢复时导入之前导出的注册表备份。
macOS 和 Linux 不适用 Windows 注册表处理方法。先确认安装方式与桌面环境能注册外部协议；在处理关联之前，仍可使用订阅页粘贴 HTTPS 地址导入。
订阅名称、流量和更新间隔从哪里来
服务端可以通过响应头提供订阅信息。它们不是写在 clash:// 链接上的参数，也不是普通 YAML 配置字段：
Content-Disposition: attachment; filename="example.yaml"
profile-update-interval: 24
subscription-userinfo: upload=1024; download=2048; total=10737418240; expire=1893456000
profile-web-page-url: https://example.com
流量单位是字节，到期值是 Unix 时间戳，更新间隔单位为小时。卡片没有流量信息时，应检查服务端实际响应头，反复重新导入不能补出服务端未提供的数据。官方文档标明首页响应头功能要求 Rev v1.6.0 及以上；部分服务端只对包含 clash 的 User-Agent 返回这些字段。