Clash Verge Rev URL Schemes 用法

URL Schemes 能让浏览器里的 clash:// 链接直接唤起客户端导入订阅,不用复制粘贴。本页讲链接写法、Windows 唤不起来的修复办法,以及订阅服务端可下发的响应头。

通过链接导入配置

链接写法

把订阅地址作为 url 参数拼进 clash://install-config,效果跟软件里手动添加订阅一样。地址带额外参数时(如 &flag=meta),要连同主体一起做 URI 编码再放进 url。

clash://install-config?url=<URI编码后url>

唤不起来的排查

Windows 点了链接没反应,多数是旧版或其他 Clash 客户端卸载残留造成的。先查注册表里这个键值指向的路径对不对:

HKEY_CLASSES_ROOT\clash\shell\open\command

或者把下面内容存成 .reg 文件,用管理员身份运行。便携版用户请自己改路径:

Windows Registry Editor Version 5.00

[HKEY_CLASSES_ROOT\clash]
"URL Protocol"=""
@="URL:clash"

[HKEY_CLASSES_ROOT\clash\DefaultIcon]
@="C:\\Program Files\\Clash Verge\\Clash Verge.exe"

[HKEY_CLASSES_ROOT\clash\shell]
[HKEY_CLASSES_ROOT\clash\shell\open]
[HKEY_CLASSES_ROOT\clash\shell\open\command]
@="\"C:\\Program Files\\Clash Verge\\Clash Verge.exe\" \"%1\""

订阅端可下发的响应头

服务端返回订阅内容时带上这些响应头,客户端会自动读取,用法如下。

content-disposition

带这个字段后,客户端用里面的 filename 当配置文件名;中文文件名要用 UTF-8 编码书写:

content-disposition: attachment; filename="test.yaml"
content-disposition: attachment;filename*=UTF-8''%E6%B5%8B%E8%AF%95%E8%AE%A2%E9%98%85

profile-update-interval

指定这份配置的自动更新间隔,数值单位是小时:

profile-update-interval: 24

subscription-userinfo

把流量和到期信息直接显示在订阅卡片上,流量单位是字节,到期时间用时间戳表示:

subscription-userinfo: upload=1234; download=2234; total=1024000; expire=2218532293

profile-web-page-url

配置后右键订阅卡片会多出“首页”入口,点一下就跳转到该地址:

profile-web-page-url: https://example.com
💡 Info
  • 多数服务端只在请求的 UA (User-Agent) 含 clash 字样时才返回这些响应头。
  • 读取响应头要求客户端不低于 v1.6.0。

操作演示