Clash Verge Rev Troubleshooting: TUN, No Internet, IPC & 403
Use this table for a 30-second diagnosis before changing advanced settings:
| Symptom | Check first | Full guidance |
|---|---|---|
| TUN switch will not stay on | Service Mode or administrator privileges | TUN setup |
| Connected but no internet | active network mode, node, DNS, conflicts | No-internet checks |
| Subscription import fails | fresh URL and Mihomo format | Import diagnosis |
| Remote profile returns 403 | token and provider restrictions | 403 diagnosis |
IPC path not ready | core process and Service Mode | IPC diagnosis |
| White screen or startup crash | WebView2/WebKitGTK, path, config | Startup diagnosis |
Why is Clash Verge TUN mode not working? #
TUN needs elevated privileges and a working core service.
- Install Service Mode in Settings, or launch Clash Verge Rev with administrator privileges.
- During diagnosis, turn off System Proxy and test TUN by itself.
- Keep the built-in DNS enabled; TUN depends on the core DNS path.
- Close other VPN or proxy applications that create a TUN adapter.
- If the switch waits about 30 seconds or reports an IPC/service error, reinstall Service Mode after ending leftover processes.
See the complete TUN mode, Service Mode and no-internet guide.
Clash Verge is connected but there is no internet. What should I check? #
Check in this order:
- Network mode: confirm System Proxy or TUN is actually enabled. A successful node latency test alone does not route traffic.
- Node: choose another node and run the test again.
- Conflict: while diagnosing, use either System Proxy or TUN, not both; close other VPN/TUN applications.
- DNS: enable the built-in DNS and start with the profile defaults or fake-ip mode.
- Rules: in Rule mode, confirm the target domain did not match a DIRECT rule unexpectedly.
- Stale system proxy: if everything stopped after a crash, disable the operating-system proxy and restart the application.
For a site-specific route, add a custom rule rather than switching all traffic to Global mode.
Why does Clash Verge say administrator privileges are required to modify the system proxy? #
- Quit and reopen the application with Run as administrator, or install Service Mode from Settings.
- Service Mode is the better long-term option because it avoids an elevation prompt on every launch.
- If installation fails silently, check endpoint security or antivirus logs, then reinstall the service.
- You normally do not need both Service Mode and an administrator launch.
How do I fix core communication error or IPC path not ready? #
IPC path not ready means the interface cannot communicate with the Mihomo core. Changing nodes does not repair a core that failed to start.
- Exit Clash Verge completely, including the tray icon.
- End leftover
clash-verge,verge-mihomoandmihomoprocesses. - Reopen the application with sufficient privileges.
- If Service Mode is abnormal, uninstall and reinstall it.
- Temporarily close other security, proxy or TUN software that may block the service.
- If the core still fails, back up subscription URLs before resetting the application configuration.
Why does Clash Verge subscription import fail? #
Common causes are:
- Expired or revoked URL: copy a fresh subscription URL from the provider.
- Truncated token or accidental spaces: paste the complete URL into a plain-text editor and check it.
- Unreachable provider domain: try the provider’s current backup domain or network guidance.
- Wrong format: request Mihomo or
clash.metaoutput instead of a format intended for another client. - YAML parsing error: the converter may emit unsupported or malformed fields; contact the provider with the exact error.
Do not publish a private subscription URL when asking for help; it normally contains an account token.
Why does a remote profile return 403 Forbidden? #
A 403 response comes from the subscription server, not from YAML parsing.
- Copy a fresh URL from the provider dashboard.
- Remove spaces, line breaks or a truncated token.
- Test whether the same URL is rejected in a browser.
- Check whether the provider restricts IP addresses, user agents or expired accounts.
- Contact the provider if the server continues to reject the request.
Changing Clash Verge rules or DNS does not remove a server-side authorization restriction.
Why won’t Clash Verge open or why is the window white? #
- Windows: install or repair the Microsoft WebView2 runtime.
- Linux: install the WebKitGTK package required by your distribution.
- Install path: use an ASCII-only path; avoid non-ASCII characters in legacy environments.
- Leftover process: end all Clash Verge and Mihomo processes before relaunching.
- Corrupted UI state: back up subscription URLs, then reset the user configuration if the other checks fail.
- Lightweight mode: restore the window from the system tray before assuming the UI has disappeared.
Other common questions #
What protocols does Clash Verge Rev support? #
Protocol support follows the bundled Mihomo core and the current release. Common profile types include Shadowsocks, Trojan, VMess/VLESS, SOCKS, Hysteria2, TUIC and WireGuard. A provider still has to generate a valid configuration for the protocol.
Is there an official Android or iOS app? #
No. Clash Verge Rev publishes desktop builds for Windows, macOS and Linux. See the Android alternatives guide and avoid packages advertised as an official Clash Verge APK.
How do I add a rule without losing it after an update? #
Right-click the profile, open Edit Rule, and add the rule in prepend or append. See Add Custom Rules in Clash Verge Rev.
How do I update Clash Verge Rev? #
Verify the current version against the GitHub release source and choose the appropriate package from the installer page. Back up subscription URLs before a major migration or configuration reset.