Guide directory
Installation, subscription, and troubleshooting guides
From installing a client to getting traffic through it: subscription import, TUN mode, startup failures, and no-connection fixes.
What is Clash Meta?
What the name Clash Meta refers to, how it relates to the Mihomo core, and which client to install first.
Read guideWhat is Mihomo?
Mihomo is a core, not a client. Understand how it splits work with GUI clients before choosing software.
Read guideClash Meta vs Clash
What each name refers to: Clash as an earlier project name, Clash Meta as a family of configurations and cores.
Read guideWhy Clash Meta became Mihomo
What changed with the rename, what did not change, and what to check when downloading a client now.
Read guideInstall Clash Verge Rev on Windows
Which package to take from the official release, what Windows may block, and the first three things to check if traffic fails.
Read guideInstall Clash Verge Rev on macOS
Which package for Apple Silicon versus Intel, how to handle the developer warning, and which permissions to grant.
Read guideInstall FlClash on Android
Where the APK comes from, the VPN permission it needs, and why the background process gets killed.
Read guideHow to import a subscription URL
Where the import entry is, what a silent paste means, and where to look when the profile loads but shows no nodes.
Read guideWhat TUN mode does and when to use it
TUN covers traffic the system proxy misses. Here is what it changes and which permissions it needs.
Read guideClient will not start: troubleshooting order
Check source and architecture, port conflicts, profile format, permissions, and logs, in that order.
Read guideClash Verge Rev vs Clash Light
One covers three desktop platforms, the other runs from an official site. Choose by system and maintenance, not by popularity.
Read guideTUN will not enable or kills connectivity
No permission prompt, route conflicts, broken DNS, or another VPN taking over. Check each cause separately.
Read guideSubscription import failed: what to check
Expired URL, truncated link, unsupported format, or unreachable source. Each failure looks different; identify which one first.
Read guideApple Silicon or Intel build for your Mac
M-series and Intel builds are not interchangeable. Check the chip in About This Mac and match the architecture.
Read guideClient runs but there is no internet
A running client does not mean traffic is routed. Work down through system proxy, port, DNS, and rules.
Read guideHow to verify a download is official
Check whether repository owner, domain, and release record point at each other, instead of trusting a “latest” label.
Read guideClash for Windows is discontinued: what now
Whether discontinued clients like CFW are still usable, and how to move to maintained clients in the Mihomo ecosystem.
Read guideUsing Clash / Mihomo profiles on iOS
Why there is no official iOS client, and how to pick and set up compatible apps like Shadowrocket and Stash.
Read guideClash Verge Rev vs FlClash
What each client covers on desktop and Android, and how to use one subscription across both devices.
Read guideWhich proxy protocols does Mihomo support
What SS, VMess, VLESS, Trojan, and Hysteria2 mean, and whether the core or the node decides protocol support.
Read guideHow a Mihomo config file is structured
What base settings, proxies, proxy-groups, and rules each cover in the YAML profile, before you edit one.
Read guide