Clash Logo
clash-meta.org
Mihomo Kernel Client Aggregation and Tutorial Center
Homepage Download Center Tutorial Center Tools Frequently Asked Questions GitHub
FAQ · Frequently asked questions and troubleshooting

Clash Meta FAQ Center 5-minute self-service troubleshooting of typical faults

Complete the most common faults and solutions when using Mihomo kernel clients such as Clash Verge Rev, FlClash and so on. Each FAQ is organized in the order of "Symptom Self-Check → Quick Diagnosis → Classified Troubleshooting → Platform Differences". Most problems can be solved by yourself within 5 minutes.

View FAQ Detailed explanation General troubleshooting process Quick Answer
3 major failure scenarios
Subscription and node
The node list is empty after importing the subscription
Connection and proxy
Still unable to connect to the Internet after turning on the proxy
Client & System
Blank interface, UAC pop-up window, Gatekeeper, etc.
The client itself does not contain nodes and requires a subscription to connect to the Internet. No node? Signing up for this high-speed airport will give you 1GB of Hong Kong high-speed experience traffic, which is valid within 24 hours. You can try the speed first after importing it; buy if it suits you. Alipay pays directly. It also supports cryptocurrency payment. No cards are tied and no real-name records are left.
Get high-speed node
General troubleshooting process

No matter what the problem is, take these 5 steps first

90% of proxy client issues can be located through the following general process. Please check step by step in order, only change one variable at a time, and remember the results of each step.

  1. 1
    See subscription

    If I paste the subscription link in the browser, can the content be returned normally? Is YAML, Base64, or blank returned?

  2. 2
    See node

    Does the client parse the delay one by one, is it ∞/timeout? Or is there a number?

  3. 3
    See proxy status

    On the desktop side, confirm that the "System Proxy" or "TUN" switch is turned on; on the Android side, confirm that there is a VPN key icon in the status bar.

  4. 4
    See rule

    Comparison of temporary switching between rule mode and global mode can determine whether DIRECT is taken away by rule matching.

  5. 5
    See log

    View real-time records on the client's "Log" page, keyword search error / timeout Find clues.

Remember this principle:Only change one variable at a time. Changing nodes, changing rules, and changing DNS at the same time will leave you completely confused about which step is responsible.
FAQ Detailed Explanation

Included fault topics

The following are frequently asked questions that have been written into special pages. Each article includes a complete diagnosis process, root cause analysis, platform troubleshooting and log reference.

No nodes after importing subscriptions
Subscription type · 6 typical reasons

Subscription shows that the import is successful, but the node list of the agent page is empty? Common causes include expired subscriptions, mismatched formats, and airport addresses blocked by operators. This article gives a complete process of troubleshooting in order.

Subscription validity Format compatible Base64 decoding UA Verification
View the complete troubleshooting process
Cannot connect to the Internet after turning on the proxy
Connection type · 7 typical reasons

The agent is turned on and there is a delay in node display, but the browser just can't open the web page? It involves many aspects such as node survival, system agent taking effect, TUN and system agent conflicts, rule matching, DNS pollution, etc.

Node availability System Agent TUN Mode Rules and DNS
View the complete troubleshooting process
Quick Answer

Small problems that can be solved without a special page

The following scenarios usually only require one or two steps to solve. Click to expand to see the answer.

This is WebView2 runtime missingCause. It's built-in by default in Windows 11, and Win10 1809+ is usually pushed by Windows Update. If your system prompt is missing or the interface cannot be opened, go to Microsoft official website Download the Evergreen Standalone Installer and install it once. After the installation is complete, there is no need to restart the system. Re-open Clash Verge Rev to see the normal interface.
Proxy clients will trigger heuristic scanning of some security software because they modify the system proxy settings or install the TUN network card driver. Please confirm the source of the installation package (it is recommended to give priority to GitHub Releases), and then install Clash Verge Add the installation directory to the trust whitelist. Windows Defender path: Settings → Privacy and security → Windows Security Center → Virus & threat protection → Exclusions.
Enabling TUN mode or service mode requires administrator rights, and a window will pop up every time it is started in normal mode. Open the client → Settings → System Settings → Click "Install Service Mode" to run the kernel component in the Windows service background. After that, you can start Clash Verge Rev with a normal account without being interrupted by UAC.
This is caused by the isolation attribute (quarantine) of Gatekeeper, and there is no problem with the application itself. Two solutions:
  • Right-click the Clash Verge icon → "Open" → click "Open" again in the pop-up window
  • Or execute in the terminal: sudo xattr -dr com.apple.quarantine /Applications/Clash\ Verge.app
The power saving strategy of domestic customized systems (MIUI / ColorOS / HarmonyOS / OnePlus OxygenOS, etc.) will clean up the background VPN service. In the system's "Settings → Application → FlClash → Battery", turn off "Background Restrictions", enable "Auto-Start", "Unlimited Power Consumption" and other permissions. Some models also need to check "Show resident notification" in FlClash to avoid being recognized as idle.
I forgot to turn off the "system proxy" switch before uninstalling, causing the system global proxy settings to still point to 127.0.0.1. Just close it manually:
  • Windows: Settings → Network and Internet → Proxy → Turn off "Use proxy server"
  • macOS: System Settings → Network → Current network → Details → Proxy → Turn off all check options
  • Linux GNOME: Settings → Network → Network Proxy → Change to "None"
How to avoid it: before uninstalling in the future, turn off the "System Agent" switch in the client, and then uninstall.
The client must remain running to trigger automatic refresh. Completely close the client and no updates will occur while the device is sleeping. If you need to keep your subscription updated without opening the client for a long time, it is recommended:
  • Turn on "Auto-start at boot" + "Automatically connect at startup"
  • Enable "Installation Service Mode" on the desktop (Windows) or allow background running (macOS/Linux)
  • When using the client, manually click "Refresh Subscription" once to confirm synchronization with the latest billing status of the airport
Latency ≠ bandwidth (throughput). The speed measurement only reflects the TLS handshake time. A node that can handle a 50ms handshake does not mean that the bandwidth is sufficient to watch 4K video. Common reasons:
  • The node is speed-limited by the operator's QoS
  • Evening peak congestion (Beijing time 20:00 - 23:00)
  • The node's own bandwidth budget has been used up
  • The line is a transfer, a long detour
Try changing nodes, or ask the airport customer service about the current line status.
Explanation: Currently in "Global mode (Global)", all traffic goes through the proxy. Switch to "Rule Mode (Rule)", domestic domain names will be directly connected according to GEOSITE/GEOIP rules, and foreign names will be connected via proxy. If you still use a proxy in China in rule mode, check whether the subscription contains a rule set, or check the actual hits on the "Rules" page of the client.
The exit node is recognized by the streaming media platform as a proxy IP (IDC computer room IP or IP in the risk control library), which does not mean that the node is unavailable. Solution: Change to a "native IP" or "streaming media optimization" node; common airports will specifically mark Netflix/Disney+ unlocking nodes. Running YouTube on ordinary nodes is usually no problem, Netflix/Disney+ requires specific nodes.
Log and configuration location

If you encounter problems, check the log first

Logs are the key to troubleshooting. You can see real-time connection records, error messages, and rule hits on the client's "Log" page. The following are the standard locations of log and configuration directories for each platform.

Windows
%APPDATA%\io.github.clash-verge-rev.clash-verge\

Contains subscriptions, configuration files, and running logs.

macOS
~/Library/Application Support/
io.github.clash-verge-rev.clash-verge/

Finder ⌘⇧G Enter the path directly.

Linux
~/.config/clash-verge/
~/.local/share/clash-verge/

The former puts the configuration, and the latter puts the running data.

Android (FlClash)
/Android/data/com.follow.clash/
files/

Android 11+ requires access via SAF.

When asking questions, attaching the following information together can greatly improve the resolution efficiency: client version number, operating system version, error phenomenon (screenshots are best), relevant lines in the log (sensitive information coding), subscription type (airport / self-built).
Related pages

Didn’t solve the problem? Look at it from another angle

Download Center
Reinstall the client or change the version
Tutorial Center
From subscription import to node selection
Tool page
Subscription decoding/configuration
Client description
Learn about Clash Verge Rev / Mihomo
High-speed airport recommendation Register to receive 1GB trial traffic
No node yet? Sign up and get 1GB of Hong Kong high-speed trial traffic, which is valid for 24 hours. You can connect to it with one click to try the speed, and then buy if it suits you. Alipay allows direct payment and can be activated in a few minutes; if you are more concerned about privacy, it also supports cryptocurrency payments - no bank cards are tied, and no real-name payment records are left.
Get high-speed node