URL Schemes

Import Configurations

Request Format

• You can quickly import configuration files using URL Schemes, which is equivalent to accessing the following URL:
• If the request includes additional parameters like &flag=meta, be sure to encode them using URI encoding and append them to the url parameter.

clash://install-config?url=<URI-encoded url></URI>

Fixing Non-functional URL Schemes

If this feature doesn't work, it may be due to incomplete uninstallation of other Clash-based proxy software (such as CFW). Check whether the path in the registry key below points to the correct executable:

HKEY_CLASSES_ROOT\clash\shell\open\command

Alternatively, save the following content as a .reg file and run it as administrator to manually add the registry entries. For portable versions, modify the paths accordingly.

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

Subscription Response Headers

content-disposition

If the response header contains the content-disposition field, the filename value will be used as the configuration file name.

content-disposition: attachment; filename="test.yaml"

If the filename contains Chinese characters, it should be UTF-8 encoded:

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

profile-update-interval

If the response header includes the profile-update-interval field, the update interval (in hours) for the config file will be set accordingly:

profile-update-interval: 24

subscription-userinfo

If the response contains the subscription-userinfo field, the corresponding traffic and expiration info (in bytes and timestamp) will be displayed on the subscription card:

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

profile-web-page-url

If the response header contains the profile-web-page-url field, a "Home" button will appear in the subscription card context menu.

profile-web-page-url: https://example.com

::: info Generally, the response headers will only be returned if the request User-Agent contains the keyword clash.

This feature requires Clash Verge Rev version v1.6.0 or higher. :::