Clash Verge Rev Setup Guide
This guide walks you through installing and configuring **Clash Verge Rev** to use with your FreeGuard VPN subscription. Clash Verge Rev is a modern, cross-platform proxy client built on the **Mihomo (Clash.Meta)** core, supporting Windows, macOS, and Linux.

Clash Verge Rev Setup Guide

This guide walks you through installing and configuring Clash Verge Rev to use with your FreeGuard VPN subscription. Clash Verge Rev is a modern, cross-platform proxy client built on the Mihomo (Clash.Meta) core, supporting Windows, macOS, and Linux.


What is Clash Verge Rev?

Clash Verge Rev is a free, open-source GUI client for managing proxy rules and connections. It is based on the Mihomo core (formerly known as Clash.Meta), which extends the original Clash with support for additional protocols such as VLESS, Hysteria 2, and AnyTLS.

Key features:

  • Cross-platform: Windows, macOS, and Linux
  • TUN mode for full system-wide proxy
  • Rule-based traffic routing
  • Built-in latency testing
  • Auto-start and auto-update subscriptions

Step 1: Download & Install

Download the latest release from the official GitHub repository:

👉 Clash Verge Rev Releases

Windows

  • Installer (recommended): Download the .exe setup file (e.g. Clash.Verge_x64-setup.exe). Run the installer and follow the prompts.
  • Portable: Download the .zip portable version. Extract it to any folder and run Clash Verge.exe directly — no installation required.

macOS

  • Download the .dmg file for your architecture (x64 for Intel, aarch64 for Apple Silicon).
  • Open the .dmg and drag Clash Verge into your Applications folder.
  • On first launch, macOS may block the app. Go to System Settings → Privacy & Security and click Open Anyway.

Linux

  • AppImage: Download the .AppImage file, make it executable (chmod +x), and run it.
  • deb (Debian/Ubuntu): Download the .deb file and install with sudo dpkg -i clash-verge_*.deb.
  • rpm (Fedora/openSUSE): Download the .rpm file and install with sudo rpm -i clash-verge_*.rpm.

Step 2: Import Your Subscription

Once you have your FreeGuard subscription URL (see Getting Started if you do not have one yet):

  1. Open Clash Verge Rev.
  2. Click the Profiles tab in the left sidebar.
  3. Click New Profile at the top.
  4. Select the Remote profile type.
  5. Paste your FreeGuard subscription URL into the URL field.
  6. (Optional) Give the profile a name, e.g. “FreeGuard VPN”.
  7. Set the auto-update interval to keep your node list fresh — we recommend 24 hours (1440 minutes).
  8. Click Save to import the profile.

The app will fetch your subscription and populate the node list automatically.


Step 3: Enable Proxy

There are two ways to route your traffic through Clash Verge Rev:

  • On the main interface, toggle System Proxy to ON.
  • This configures your OS to route HTTP/HTTPS traffic through Clash Verge.
  • Most browsers and many apps will respect this setting automatically.

Option B: TUN Mode (Full System Proxy)

  • Toggle TUN Mode to ON for true system-wide proxying of all traffic (including apps that ignore system proxy settings, such as games or terminal tools).
  • Note: TUN mode requires administrator/root privileges. On Windows you may see a UAC prompt; on macOS/Linux the app may ask for your password.

Step 4: Select a Node

  1. Go to the Proxies tab in the left sidebar.
  2. You will see one or more proxy groups (e.g. “Auto Select”, “Manual Select”).
  3. Expand a proxy group to see the available server nodes.
  4. Click on a node to select it.
  5. Click the lightning bolt icon or right-click and choose Test Latency to check the speed of each node.
  6. Choose the node with the lowest latency for the best performance.

Tip: The “Auto Select” group automatically picks the fastest node based on latency tests.


Step 5: Auto-Start on Boot (Optional)

To have Clash Verge Rev start automatically when you log in:

  1. Go to Settings (gear icon in the left sidebar).
  2. Enable Start on Boot (also called “Launch at Startup”).
  3. Optionally enable Silent Start so the app starts minimized to the system tray.

Proxy Mode Switching

Clash Verge Rev supports three traffic modes, accessible from the Proxies tab or the system tray icon:

Mode Description
Rule Routes traffic based on rules — most traffic goes direct, only blocked/foreign sites go through the proxy. Best for daily use.
Global All traffic is routed through the proxy. Useful when you need everything proxied.
Direct All traffic bypasses the proxy entirely. Use this to temporarily disable proxying without turning off the app.

Recommendation: Use Rule mode for everyday browsing. Switch to Global only when needed.


Manually Updating Your Subscription

Your subscription updates automatically based on the interval you set. To force an immediate update:

  1. Go to the Profiles tab.
  2. Click the refresh/update icon next to your profile.
  3. The app will re-fetch the latest node list from FreeGuard.

This is useful after renewing your plan or if new server nodes have been added.


Troubleshooting

TUN Mode Requires Admin Privileges

TUN mode creates a virtual network adapter. If you see a permissions error:

  • Windows: Right-click Clash Verge and select Run as Administrator, or approve the UAC prompt.
  • macOS/Linux: Enter your password when prompted. On some Linux distros, you may need to run with sudo or configure capabilities.

macOS Security Prompt (“App Cannot Be Opened”)

Apple blocks apps from unidentified developers by default:

  1. Go to System Settings → Privacy & Security.
  2. Under “Security”, you will see a message about Clash Verge being blocked.
  3. Click Open Anyway and confirm.

Proxy Not Working After Enabling

  • Make sure the System Proxy or TUN Mode toggle is ON.
  • Check that your subscription profile is active (highlighted in the Profiles tab).
  • Try switching to Global mode temporarily to rule out routing issues.
  • Restart the app and try again.

High Latency or Slow Speeds

  • Run a latency test on all nodes and pick the fastest one.
  • Try switching to a different server node or region.
  • Check if your ISP is throttling — try enabling TUN mode if you are using System Proxy.

Subscription Import Fails

  • Verify that the subscription URL is correct and has not expired.
  • Check your internet connection (try opening a website in your browser).
  • If behind a firewall, try using a different network to perform the initial import.

Next Steps