Clash FAQ

Find answers by symptom, from subscription and rule-based routing issues to proxy settings. New to installation? Start with the quick start guide. For platform-specific instructions, see the user documentation.

Basics

Identify the client, core, and traffic routing method before deciding what to check.

What’s the difference between Clash Meta for Android and mihomo?

Clash Meta for Android is an Android client; mihomo is the core that parses configurations, matches rules, and establishes connections. Import configurations, switch proxy groups, and grant VPN permission in the client interface. If a configuration field isn’t supported, first check which core the client is using, then consult the documentation for that version. Don’t assume desktop and mobile clients support the same fields just because they share an app name.

Are a system proxy, Android VPN, and TUN the same thing?

No. A system proxy provides proxy settings to apps that choose to use them; apps that ignore those settings may still connect directly. Android clients typically use VpnService to create a virtual network interface and route traffic through it. Desktop TUN also routes traffic through a virtual interface, but setup requirements depend on the operating system and client. Whichever method you use, traffic that reaches the client can still be routed directly or through a proxy according to the rules.

When should I use Rule, Global, or Direct mode?

Use Rule mode for everyday browsing: the configuration determines which requests connect directly and which go through a proxy group. To tell a rule issue from a node issue, temporarily switch to Global mode, select an available node in the global policy, and try the same site. Direct mode is useful for comparing results with and without a proxy. Switch back to Rule mode when you’re done. Global mode only affects traffic routed through the client; it won’t send apps that bypass the client through a proxy.

Can I still use my old configuration after Clash for Windows was discontinued?

Try the old configuration in a client that’s still maintained; there’s no need to keep using an archived client just to preserve your rules. Before migrating, save a copy of the original YAML. After importing it, check that nodes, proxy groups, and rules load correctly, then compare routing on the same site. UI preferences, tray settings, and local configuration paths usually don’t migrate with YAML. If a field causes an error, use the reported line to identify the incompatible setting instead of deleting entire DNS or rule sections.

Installation & Setup

Check the installation package, configuration file, and system permissions in that order to find which step is incomplete.

Which Android package should I install: ARM64, ARM, or universal?

Choose based on the app ABI supported by your operating system, not just the processor model. If your device supports arm64-v8a, choose ARM64; if it only supports armeabi-v7a, choose ARM. If you’re unsure and the client offers a universal package, try that. If Android won’t install it, check that the installation source is authorized, your OS version meets the requirements, and there isn’t already an app with the same name but a different signing key. Back up your configuration before uninstalling an older version.

How do I import a subscription link or local YAML file?

For a subscription link, choose Import from URL in the client’s configuration manager. For a YAML file, choose Import from file. After saving, select the configuration and return to the main screen to start the connection. If the configuration appears in the list but has no nodes, check the import log first: a URL may return a login page or error page instead of a parseable configuration. Subscription links may contain account credentials, so don’t include the full URL in screenshots or public support posts.

What if the Android VPN permission prompt doesn’t appear or the connection drops right after I grant permission?

Search for VPN in Android settings and check whether another client is connected or another app has Always-on VPN enabled. Once it’s safe to disconnect the existing VPN, start the connection from your Clash client and accept the system prompt. If the device is managed by your organization, VPN use may be restricted by device policy; check with your administrator. If the connection only drops after the screen locks, check the client’s battery optimization and background activity settings before reinstalling.

What should I do if desktop TUN reports insufficient permissions?

Turn off TUN first, confirm the configuration loads, then use the system proxy to check whether a node can reach the same site. On Windows, if the client offers service mode, install and start the service as instructed, then enable TUN. On other systems, follow the client’s documentation to grant the required virtual interface permissions. If the startup log reports a route conflict rather than access denied, check whether another VPN is already routing traffic. Don’t disable security protections or remove management policies on a managed device.

Tips & Usage

After changing rules or proxy groups, test with a new connection. Before changing a subscription, distinguish the original configuration from local overrides.

Where should MATCH go when rules are evaluated from top to bottom?

Put MATCH at the end of the rule list. Rules are checked in order, and the first match determines how a request is routed. For example, add DOMAIN-SUFFIX,github.com,Proxy first, then use MATCH,DIRECT to send requests that didn’t match an earlier rule directly. Proxy must match the name of a proxy group in your configuration. After editing, check the connection details to see which rule actually matched; don’t rely on the client simply showing that it’s connected.

Why don’t existing connections change immediately after I switch proxy group nodes?

Switching nodes usually affects new connections; existing ones may keep using their original route. A browser may also reuse an existing connection, so refreshing the page won’t always confirm that the switch worked. Check that the request matched the proxy group you just changed, then close the relevant connection in the client’s connection list or restart the app you’re testing. There’s no need to interrupt other active transfers.

Is it normal for Fake-IP to return an address that isn’t the server’s real IP?

Yes. In Fake-IP mode, a domain is assigned a mapped address so the core can identify the original domain and apply rules when it handles the subsequent connection. This isn’t the website’s real server IP and can’t be used to determine your public exit IP. If a device on your LAN needs a domain to resolve to its real address, set fake-ip-filter only for the relevant domains in a configuration that supports the field, then clear the related DNS cache and test again. Change one setting at a time.

Can automatic subscription updates overwrite rules I edited manually?

If you edited the original file downloaded from a subscription, the next update may replace your changes with the remote version. If the client supports overlays or configuration merging, keep custom rules in a separate layer and check their order in the merged configuration. If it doesn’t, save a local copy and confirm which configuration will be updated by the subscription. After updating, check which configuration is active; a changed update time doesn’t mean the current connection is using the new rules.

Troubleshooting

Record the original error, then compare results on the same site or over a different network. Change one condition at a time.

Clash subscription update failed: how can I tell if the link is invalid or the network is down?

Try a manual update and note whether it fails while fetching or parsing. For a 401 or 403 response, check your account status and subscription URL on the provider’s site. For a 404, check whether the provider changed the URL path. If the error mentions DNS or a request timeout, try another network to see if the subscription domain is reachable. If the download succeeds but parsing fails, check whether the subscription format is compatible with your client. Keep your working configuration until the new one has been verified.

All node latency tests are timing out. What should I check first?

Disconnect first and confirm that your current network can access the internet. Then test two nodes against the same site. If every node times out only when testing a particular latency-check URL, but those nodes can still open sites, the issue may be with the test URL or its DNS resolution. If switching to mobile data fixes it, check whether the original Wi-Fi requires sign-in and can resolve node domains. If only specific nodes keep failing, check their status and the subscription’s last update time.

Why do my browser or terminal apps still connect directly after I enable the system proxy?

Check that the system proxy address and the client’s local listening port match, and confirm whether that port uses HTTP, SOCKS, or a mixed proxy. In a browser, temporarily disable extensions that manage proxy settings and try again. Terminal apps may need proxy settings configured separately because they don’t always use the system settings. Test the same site and check the client’s connection list. If there’s no connection entry, check whether the app is using the client; if there is one but traffic still goes direct, check which rule matched.

Only Windows UWP apps can’t use the local proxy. How do I troubleshoot loopback restrictions?

First, use a regular desktop browser to confirm the same proxy port works. Then check whether the UWP app is trying to connect to 127.0.0.1. Some apps are subject to AppContainer loopback restrictions, so a desktop browser may work while the app can’t connect to a local proxy. If the client offers a UWP loopback tool and device policy allows it, enable the exception only for apps confirmed to be affected, then restart the app and test again. If that doesn’t help, remove the exception and check whether the app supports that proxy method.