Clash Verge Rev Quick Start

From download and installation, importing subscriptions, choosing nodes and modes, to enabling system proxy or TUN—complete step‑by‑step guidance and best practices.

Download & Install For Win Download & Install For Mac OS

Advanced Usage & Recommendations

After the basics and subscription import, refine routing and proxy groups for browsing, downloads, streaming and development. In rule mode, combine public and custom rule sets to direct China sites straight and split common overseas services and streaming. The auto‑select group with url‑test picks better nodes dynamically; manual select serves as fallback and quick switching. System proxy suits apps that honor OS proxy settings and is simpler; TUN uses a virtual NIC to capture TCP/UDP for games, CLIs or apps that ignore system proxy. When enabling TUN, allow the core and services through the firewall; service mode can start TUN without admin privileges.

For subscriptions, set a reasonable auto‑update interval (e.g., 6 hours) and use prefixes in multi‑provider setups to distinguish node sources for filtering/maintenance. To verify a subscription returns a proper YAML config, use PowerShell or curl with a specific UA. Parsing errors are often indentation/quotes/list formatting issues—fix and retry. Evaluate experience by scenario: web favors latency/TTFB; streaming favors bandwidth/stability (e.g., 1080P ≈ 5 Mbps, Netflix 4K ≈ 15 Mbps). Use app logs/connection views to check node health and rule hits and iterate.

If UWP apps (e.g., Microsoft Store) cannot proxy, enable loopback in the in‑app UWP tool and save. If the UI won’t show or only tray appears, check whether WebView2 was removed/disabled; reinstall it or use a fixed_webview2 build. Startup issues after updates usually stem from legacy entries or permission mismatches—toggle auto‑start once under admin/non‑admin modes to clean up. Best practice after quick start: keep subscriptions/rules updated, combine auto and manual groups, enable system proxy or TUN as needed, and adjust based on real scenarios.

Step 1: Download & Install

Windows

Recommend x64. On Windows 11 install via WinGet:

winget install ClashVergeRev.ClashVergeRev
  • If UI fails, use the installer with fix_webview2.
  • Windows 7 is no longer supported—upgrade to Windows 10/11.
Linux / macOS

Multiple distros and installers are supported. See “Download & Install”. Examples:

# Ubuntu / Debian
sudo apt install -y ./Clash.Verge_x.x.x-_xxx.deb

# Fedora / RHEL
sudo dnf install ./Clash.Verge_x.x.x-_xxx.rpm
sudo yum localinstall ./Clash.Verge_x.x.x-_xxx.rpm

# Arch / Manjaro
sudo pacman -S archlinuxcn-keyring
sudo pacman -S clash-verge-rev
  • Ubuntu 24.04 可能需要额外依赖，请参考常见问题。
  • macOS 12+ 官方支持；macOS 11 可替换 go124 标签的 Mihomo 核心。

Step 2: Import Subscriptions

Import nodes and configs via provider or self‑hosted subscriptions. Example:

  1. On “Subscriptions” page, click “Add” and paste the URL.
  2. Set update interval and UA (e.g., clash-verge/v2.4.0).
  3. Save and run “Update”, then wait for download.
# Windows PowerShell 验证订阅是否正常
$sub='在单引号内粘贴订阅链接'
Invoke-RestMethod -UserAgent 'clash-verge/v2.4.0' -Method get -FollowRelLink -uri $sub

# 或使用 curl
curl -A clash-verge/v2.4.0 '粘贴订阅链接'
Subscription Tips
  • Prefer providers with free trials and common payment methods.
  • Use a ~6‑hour update interval, adjust as needed.
  • For YAML parsing errors, check indentation, quotes and lists.

Step 3: Choose Nodes & Modes

On Overview/Home select proxy node and routing mode:

  • Rule: split by rule sets (recommended).
  • Global: route all traffic via selected node.
  • Direct: all traffic goes directly (no proxy).
proxy-groups:
  - name: 手动选择
    type: select
    proxies: [DIRECT,自动选择]
    url: "https://www.gstatic.com/generate_204"
    interval: 300
rules:
  - GEOSITE,CN,DIRECT
  - GEOIP,CN,DIRECT
  - MATCH,手动选择
策略组图标示例

可在订阅或配置中为策略组设置图标。

Google Icon
示例：策略组图标（Google）
icon: https://fastly.jsdelivr.net/gh/clash-verge-rev/.../icons/google.svg

Step 4: Enable Proxy or TUN

System Proxy

Uses OS proxy settings—great for browsers and apps that honor system proxy.

  • Pros: simple setup, works out of the box.
  • Limit: does not proxy UDP traffic (e.g., games).
TUN Mode

Installs a virtual NIC to capture apps that don’t honor system proxy (games/CLI), redirecting all TCP/UDP.

  • Pros: doesn’t require app support, unified traffic control.
  • Tip: read firewall and stack notes before first use.
Service mode can start TUN without admin rights. See docs for TUN stack differences.

FAQs & Optimization Tips

Experience Metrics
  • Web favors latency; streaming favors bandwidth. 1080P ≈ 5 Mbps, Netflix 4K ≈ 15 Mbps.
  • Peak‑hour tests are more representative; don’t focus on latency alone.
  • Use auto‑select with manual fallback for node selection.
Troubleshooting
  • UI fails: check WebView2 or use fix_webview2 build.
  • Games not proxied: enable TUN and allow verge‑mihomo core.
  • Subscription errors: verify UA; check YAML indentation/quotes.