Clash Verge Rev

English

简体中文

English

简体中文

Theme

FAQ (Frequently Asked Questions) ​

Error: System file not found (os error) ​

This may be due to file corruption or missing core files.
Solution: Delete old configuration files, uninstall the previous version, and reinstall the latest version.

Config or subscription missing after installing new version ​

Starting from version 1.4.3, the config file path has been changed.
Recommendation: Uninstall the old version before installing the new one.
You can find the config path in Settings > App Directory.

TUN mode cannot be enabled ​

  • On Windows, run the program as administrator, or use Service Mode.
  • On macOS/Linux, go to Clash settings → ⚙️ → Authorize.

Error when installing service mode ​

This is a known compatibility issue in earlier versions, but it does not affect usage.
Latest versions have already fixed it.

Service Mode is only used to allow TUN mode without admin privileges.

Run uninstall-service.exe in the app directory to remove Service Mode:

uninstallservice

Latency test results lower (or higher) than before ​

In the Clash settings, toggle the unified-delay field as needed.

Verge won't launch properly ​

Try repairing, uninstalling, or reinstalling WebView2:
Download WebView2 Runtime

System tray icon exists but main window won't open ​

Use Windows 7 compatibility mode.
See: GitHub Issue #717

macOS shows “App is damaged” warning ​

This happens because the developer is not part of the Apple Developer Program.
Run the following terminal command to authorize:

bash
sudo xattr -r -d com.apple.quarantine /Applications/Clash\ Verge.app

damaged

Blank window on macOS ​

Clash Verge requires macOS 11 or later. It does not support macOS 10.

Change GUI log level for debugging ​

Go to Settings → App Directory, open verge.yaml with a text editor and change:

yaml
app_log_level: debug

Log file is too large and fills disk ​

Set the log level to silent or error, and set auto-cleanup time in Misc Settings.

Subscription total traffic shows as 0 ​

This is a known bug in 32-bit versions ≤ 1.4.11. Solution: Update to the latest version.

Which version should I download? ​

  • Windows: x64-setup.exe
  • Windows with ARM chip: arm64-setup.exe
  • macOS (Intel chip): x64.dmg
  • macOS (Apple M chip): aarch64.dmg
  • Linux x64: amd64.AppImage or amd64.deb
  • Windows Portable: x64_portable.zip (Not recommended due to lack of auto-update)

Other Odd Issues ​

Cannot select subscription; log shows An attempt was made to access a socket in a way forbidden by its access permissions. ​

The system service may not be running. Run the following commands:

bash
net stop hns
net start hns

System service not started

WebView2 cannot install ​

Your Windows system might have disabled Windows Update. Please enable automatic updates.

Subscription import error ​

import

Solution: Uninstall and reinstall the app.