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\""
[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
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。