Clash Verge: add an HTTP or SOCKS5 proxy

Steps

1. Install it from the project’s releases page

   Download Clash Verge Rev from the Releases page of the clash-verge-rev repository on GitHub, which its documentation names as the only place it is published, and pick the build for your system and processor. It is a client and nothing more: it comes with no proxies, and everything below uses the one you bought.

2. Create a local profile

   Open the Profiles page, click New, set Type to Local, give it a name and Save without choosing a file. Clash Verge writes a template profile. Right-click its card and choose Edit File. The file holds three empty lists, proxies: [], proxy-groups: [] and rules: [], and the next three steps replace each one with the block shown.

3. Add your proxy as a node

   Each entry under proxies is one node. Copy HOST, PORT, USERNAME and PASSWORD from the service page. A residential port answers both protocols, so both nodes work there; on ISP and datacenter the dashboard sets one, so keep only the node whose type matches it. The names are yours to choose, and groups and rules refer to them. Edit Proxies, in the same menu, also takes a node as a URI such as socks5://USERNAME:PASSWORD@HOST:PORT; in that form, URL-encode any special characters in the login.

   proxies:
     - name: pool-http
       type: http
       server: HOST
       port: PORT
       username: USERNAME
       password: PASSWORD
     - name: pool-socks
       type: socks5
       server: HOST
       port: PORT
       username: USERNAME
       password: PASSWORD

4. Put the nodes in a group

   A select group lets you switch nodes on the Proxies page without touching the file. Rules point at the group, so changing node never means rewriting rules.

   proxy-groups:
     - name: PROXY
       type: select
       proxies: [pool-http, pool-socks]

5. Write the rules

   Rules are read from the top, and the first one that matches decides. DOMAIN matches one exact name. DOMAIN-SUFFIX matches a domain and every subdomain under it; put the site you need in place of the second rule’s domain. The IP-CIDR line keeps your home network direct, and no-resolve stops the core looking up names just to test it. MATCH,DIRECT comes last: anything you did not list goes direct and never touches the proxy.

   rules:
     - DOMAIN,api.ipify.org,PROXY
     - DOMAIN-SUFFIX,example.com,PROXY
     - IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
     - MATCH,DIRECT

6. Use the profile in Rule mode

   Save the file. If Clash Verge reports that validation failed, the core refused the file and kept the old one, so check the indentation first. Right-click the card and choose Select. On the Proxies page, set the mode to Rule. Global would send everything through the chosen node, and Direct would send nothing. Then click pool-http or pool-socks in the PROXY group.

7. Check where traffic goes

   Programs that read the system proxy follow Clash Verge once System Proxy is switched on in Settings. Command-line tools often do not, so point them at the Mixed Port under Settings › Clash Setting › Port Config, written MIXED_PORT below. The first command should print the proxy’s address and the second your own, because only api.ipify.org is listed. The Connections page shows the rule each connection matched and the group and node it went through.

   curl -x 127.0.0.1:MIXED_PORT https://api.ipify.org
   curl -x 127.0.0.1:MIXED_PORT https://httpbin.org/ip

Common errors and fixes

Need help? What a 407 or 403 message means

Which line to pick

For a bot or script that signs in to one account every day, point its node at an ISP IP. Residential with Sticky IP covers targets that turn away server addresses, and your rules keep those gigabytes to the domains you list. Datacenter is the cheapest node for tools and checks that accept any address.

Other setup guides

Not sure what a word means? The glossary explains it in plain English.