Tutorial 2026-05-23 · ~16 min read

Clash Verge Rev TUN Mode on Windows: Service Install and Permission Setup Guide

System proxy in Clash Verge Rev works for browsers and most Win32 apps, yet Microsoft Store clients, some games, and CLI tools still go direct because they ignore WinINET or cannot reach 127.0.0.1. This guide is only about turning on TUN mode on Windows 10 and 11 with Verge Rev: install the privileged Service, pass administrator prompts, tune underlying Mihomo TUN options such as auto-route and stack, and prove capture on the first enable — without repeating generic install steps covered elsewhere.

Why enable TUN in Clash Verge Rev on Windows?

Clash Verge Rev wraps the Mihomo (Meta) core with a modern GUI for profiles, proxy groups, and mode switches. On Windows the default path is system proxy: Mihomo listens on a localhost mixed port and Windows pushes HTTP-aware applications toward that address. The limitation is structural. Universal Windows Platform (UWP) packages are sandboxed and often blocked from loopback unless you manually grant exemptions. Games, launchers, and terminal utilities may never read system proxy flags at all. They speak raw TCP/UDP and QUIC straight to the internet while your tray icon still shows green.

TUN mode inserts a virtual network adapter — typically backed by Wintun on modern Mihomo builds — and routes eligible IP traffic through the core before it leaves the machine. Applications no longer need to discover a localhost proxy; the kernel has already handed packets to Mihomo, which applies your YAML rules and DNS policy. That is why TUN is the high-frequency fix when people search for Windows TUN setup alongside Verge Rev: one toggle (plus Service plumbing) replaces per-app loopback hacks for many stubborn clients.

This article assumes you already completed baseline setup — subscription import, active profile, Rule-mode browsing. If not, start with installing Clash Verge Rev on Windows 11 or the Windows 10 variant, then return here. For UWP-specific loopback theory without Verge Rev UI names, our Store and loopback guide complements this walkthrough rather than replacing it.

System proxy versus TUN — what changes on Windows

Layer System proxy TUN mode
Capture point App reads WinINET / manual proxy to 127.0.0.1 Kernel routes IP flows via virtual adapter
Typical wins Browsers, Electron apps, low friction UWP, games, CLI, proxy-ignorant stacks
Privileges Standard user usually sufficient Service install, UAC, Wintun driver
Coexistence risk Competing proxy resetters Other VPNs, corporate tunnel agents

Verge Rev exposes both toggles in Settings or the home dashboard depending on release channel. You are not forced to pick permanently: power users often keep system proxy for quick tests and enable TUN when launching a game session. The critical discipline is to prove system proxy works first; otherwise TUN failures blend subscription issues, DNS misconfiguration, and driver permission errors into one opaque “offline” symptom.

Before you install the Service or flip TUN

Checklist

  • Working baseline: active profile, populated proxy groups, overseas and domestic test sites load under system proxy in Rule mode.
  • Administrator account or elevation rights to install the Verge Rev Service and Wintun driver bundle.
  • No competing full-tunnel VPN holding default routes — quit consumer VPN clients and pause corporate agents during first enable.
  • Current Verge Rev build from official releases; stale portable trees missing Service binaries produce confusing “Install Service” loops.
  • Antivirus exclusions considered if real-time scanning quarantines Mihomo or Wintun DLLs mid-install.

Corporate laptops under Group Policy may block unsigned drivers or service registration entirely. In those environments TUN may remain impossible until IT whitelists Wintun; system proxy plus targeted loopback exemptions might be the ceiling. Document that constraint early instead of repeatedly clicking TUN and blaming nodes.

What the Clash Verge Rev Service does

The GUI process runs at your user privilege level. Creating a TUN interface, injecting routes, and sometimes binding privileged DNS ports requires a separate Service (or “service mode”) that Mihomo can talk to. Verge Rev ships an installer action — commonly labeled Install Service, Service Mode, or Install Mihomo Service under Settings — that registers a Windows service, drops helper binaries beside the app, and prepares Wintun.

Without this step, enabling TUN often yields log lines about access denied, failed adapter creation, or “please install service first.” The Service persists across reboots once installed correctly, which also helps if you later enable launch-on-boot: the core can start elevated helpers before you log interactive UI sessions. Uninstall paths exist in the same Settings panel; use them when migrating machines rather than deleting folders manually, or orphaned services confuse future installs.

Naming varies by build

Menu labels shift between Verge Rev versions. Search Settings for “Service”, “TUN”, or “Run as admin”. If your build nests options under Clash Settings → Service, treat that as equivalent to the flows below.

Step 1 — Install the Clash Verge Rev Service

  1. Close other proxy or VPN software that might lock routing tables.
  2. Open Clash Verge RevSettings (gear icon).
  3. Locate Service or Install Service and click install.
  4. When User Account Control appears, verify the publisher path points to your Verge Rev directory, then approve.
  5. Wait until the UI reports success — often a green indicator, “Service installed”, or similar status text.
  6. If prompted to restart the core or reboot after Wintun driver setup, do so once; skipping reboots is a common reason the first TUN enable fails on fresh images.

Windows Defender Firewall may ask separately whether to allow the Service or Mihomo on private networks. Allow on trusted home or office LANs; you can tighten public profile rules later. SmartScreen rarely triggers on Service registration itself, but if helper executables were downloaded recently, hash verification from release notes still applies — the same hygiene described in our Windows install guide.

Portable installs

Portable zip distributions can install Services, but paths must remain stable. Moving the folder after registration breaks service binary references. Prefer the standard installer on machines where TUN is a daily requirement.

Step 2 — Administrator permissions and elevation

Even with the Service installed, some builds ask you to Run as administrator when first enabling TUN or when updating Wintun after a Verge Rev upgrade. Right-click the shortcut → Run as administrator, approve UAC, then toggle TUN from the elevated session once. After the driver is established, standard launches often suffice — but keep elevation in your troubleshooting pocket when logs mention privilege errors.

Standard users on shared PCs may install the Service if UAC allows elevation, yet Group Policy can still deny adapter creation. Signs include successful Service status with TUN toggle snapping back OFF. Collect logs from Verge Rev’s log panel and Windows Event Viewer → Application around the same timestamp before reinstalling blindly.

Firewall, Defender, and third-party AV

Security suites sometimes classify Wintun or Mihomo as suspicious because they modify network stacks — the same scrutiny legitimate VPN clients face. If TUN enables but traffic dies immediately, temporarily test with real-time protection relaxed on a controlled network, or add explicit exclusions for the Verge Rev install directory. Re-enable protection after confirming the root cause; permanent disabling is never the goal.

Step 3 — Mihomo TUN configuration in Verge Rev

Verge Rev surfaces Mihomo TUN knobs in Settings → TUN Mode or within the merged profile editor. Under the hood Mihomo expects a tun: stanza. The GUI writes equivalent fields when you adjust toggles; advanced users can inspect the generated profile to confirm values survived a reload.

Recommended first-time values

tun:
  enable: true
  stack: system
  auto-route: true
  auto-detect-interface: true
  dns-hijack:
    - any:53

auto-route: true lets Mihomo install routes so traffic enters the TUN adapter without manual route add commands — essential for typical desktop use. stack chooses the userspace network stack implementation: system is the balanced default on Windows for most readers; gvisor can help when specific UDP or QUIC edge cases misbehave at the cost of CPU; mixed appears in some docs for hybrid behavior. Change one variable at a time when diagnosing latency or handshake failures.

DNS hijack ensures queries hit Mihomo’s DNS module so fake-ip or redir-host policies stay coherent under TUN. If pages load but names fail only after TUN, read DNS and fake-ip troubleshooting before reverting drivers. Auto-detect interface helps laptops that switch between Wi-Fi and Ethernet without manual interface names — leave it enabled unless you operate exotic multi-homed lab setups.

Optional fields like strict-route, inet4-address, or process-based routing belong in later tuning once baseline capture works. Process rules pair naturally with TUN for game launchers — see Steam and Epic routing under TUN when you need selective capture instead of whole-machine tunneling.

Step 4 — Enable TUN mode for the first time

  1. Confirm the Service shows installed/running in Settings.
  2. Set mode to Rule (not Global for daily use — Global is for isolation tests only).
  3. Toggle TUN Mode ON in the dashboard or Settings.
  4. Watch logs for adapter creation — success messages reference Wintun or tun0-like interfaces.
  5. Open ncpa.cpl (Network Connections) and verify a new adapter appeared with an assigned address.
  6. Load a site or app that previously bypassed proxy; inspect the Connections tab for matching rule hits.

First enable can take ten to thirty seconds while routes settle. If the toggle flips off spontaneously, read the latest log block before retrying — rapid repeated clicks race driver initialization. Some builds allow TUN alongside system proxy; others recommend disabling system proxy once TUN carries traffic. Test with system proxy OFF if you see duplicate or circular routing symptoms (same destination logged twice with conflicting chains).

Verification targets

Retry Microsoft Store downloads, a UWP client, curl https://example.com in PowerShell without manual env vars, and a game launcher update channel. Success across at least two categories proves TUN is doing real work beyond browser-only tests.

Running system proxy together with TUN

Mihomo can honor both paths simultaneously, but not every user benefits. System proxy remains useful for apps that explicitly query WinINET while TUN catches the rest. Conversely, some profiles behave cleaner with system proxy disabled once auto-route is active — fewer chances that an app tries localhost first, fails loopback, then falls back oddly. Experiment on your machine: enable TUN only, test; enable both, test; compare Connections logs for redundancy.

When quitting Verge Rev, remember TUN may leave routes or DNS settings in flux depending on build. If the network feels “stuck” after exit, follow resetting system proxy after Clash quits and disable TUN before uninstalling the Service during migration.

Troubleshooting common TUN failures

“Install Service” keeps reappearing

Run Verge Rev elevated, reinstall the Service, reboot, and confirm the Windows Services console (services.msc) lists the Mihomo/Verge helper without “stopped” errors. Antivirus quarantine of service executables produces this loop — restore files and whitelist the install path.

Access denied or Wintun errors

Denied UAC, lack of admin rights, or blocked driver loading. Install Wintun manually only when official docs for your build recommend it; otherwise rely on Verge Rev’s bundled installer. Remove obsolete TAP adapters from legacy VPNs that conflict with Wintun registration.

TUN ON but no connections logged

Profile inactive, mode set to DIRECT accidentally, or routes not installed because auto-route is false. Re-enable auto-route, restart core, verify active profile highlight, and ensure no other VPN holds metric-zero default routes via route print.

Store works in browser add-on but not native shell

If TUN is confirmed yet a specific UWP fails, DNS rather than loopback may be the culprit — pivot to DNS guides. Rare enterprise builds sideload Store with custom capabilities; loopback exemptions may still be required even under TUN for exotic manifests.

FAQ — Clash Verge Rev TUN on Windows

Do I need the Service for TUN?

Yes on typical Windows setups. TUN adapter creation and route programming require privileges the interactive GUI alone does not hold. Service installation is the supported path in Verge Rev.

Does this differ on Windows 10 versus 11?

Core steps match: Service install, UAC, Wintun, TUN toggle. UI chrome and Settings placement vary slightly by Verge Rev version, not OS marketing name. Firewall prompts may wording-shift but behave the same.

Does TUN slow gaming or QUIC apps?

Overhead exists but is usually small on modern CPUs. If latency spikes, try switching stack from gvisor back to system, reduce sniffer aggressiveness, or use process-based rules instead of whole-system capture.

How do I remove TUN cleanly?

Turn TUN OFF, stop the Service from Settings, uninstall Service via the same panel, reboot, then remove the app. Skipping order leaves ghost adapters until reboot.

Summary — shortest trustworthy TUN path

  1. Prove system proxy and Rule mode work with your subscription.
  2. Install Clash Verge Rev Service; approve UAC and firewall prompts.
  3. Configure Mihomo TUN with auto-route, sensible stack, and DNS hijack aligned to your profile.
  4. Enable TUN, confirm virtual adapter and Connections activity.
  5. Validate UWP, CLI, or game traffic; tune system proxy coexistence only after baseline success.

Many Windows proxy clients still treat TUN as an expert-only footnote — buried in forum threads, split across UWP loopback posts, or missing Service install steps entirely. That fragmentation leaves users clicking a TUN switch that silently fails, then blaming subscription quality. Clash approaches the stack holistically: Mihomo’s mature Meta feature set, clear Rule versus Global semantics, and documented DNS modes mean once TUN capture works, the same YAML you already trust governs stubborn apps without per-process hacks.

If you want a maintained client family with Verge-class GUIs, transparent Service workflows, and room to grow into process routing or LAN sharing, Clash is built for that full journey — not just browser tabs. You can download Clash for Windows from our curated hub and align your first profile import with the TUN steps above when system proxy alone stops being enough.

Get Clash Verge Rev for Windows from a curated source

Official release links and Service-ready builds beat random search results — especially when enabling TUN on Windows 10 or 11.

Download Clash (Windows)