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:
Windows
- Installer (recommended): Download the
.exesetup file (e.g.Clash.Verge_x64-setup.exe). Run the installer and follow the prompts. - Portable: Download the
.zipportable version. Extract it to any folder and runClash Verge.exedirectly — no installation required.
macOS
- Download the
.dmgfile for your architecture (x64for Intel,aarch64for Apple Silicon). - Open the
.dmgand 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
.AppImagefile, make it executable (chmod +x), and run it. - deb (Debian/Ubuntu): Download the
.debfile and install withsudo dpkg -i clash-verge_*.deb. - rpm (Fedora/openSUSE): Download the
.rpmfile and install withsudo 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):
- Open Clash Verge Rev.
- Click the Profiles tab in the left sidebar.
- Click New Profile at the top.
- Select the Remote profile type.
- Paste your FreeGuard subscription URL into the URL field.
- (Optional) Give the profile a name, e.g. “FreeGuard VPN”.
- Set the auto-update interval to keep your node list fresh — we recommend 24 hours (1440 minutes).
- 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:
Option A: System Proxy (Recommended for Beginners)
- 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
- Go to the Proxies tab in the left sidebar.
- You will see one or more proxy groups (e.g. “Auto Select”, “Manual Select”).
- Expand a proxy group to see the available server nodes.
- Click on a node to select it.
- Click the lightning bolt icon or right-click and choose Test Latency to check the speed of each node.
- 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:
- Go to Settings (gear icon in the left sidebar).
- Enable Start on Boot (also called “Launch at Startup”).
- 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:
- Go to the Profiles tab.
- Click the refresh/update icon next to your profile.
- 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
sudoor configure capabilities.
macOS Security Prompt (“App Cannot Be Opened”)
Apple blocks apps from unidentified developers by default:
- Go to System Settings → Privacy & Security.
- Under “Security”, you will see a message about Clash Verge being blocked.
- 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
- Clash Protocol Guide — Learn about supported protocols (Trojan, Hysteria 2, AnyTLS) and when to use each.
- Clash Troubleshooting — Detailed solutions for common connection issues.