Step-by-step visual guidance from installation to setup. Covering five major platforms, learn to import subscriptions and enable proxy in 5 minutes.
Regardless of which platform you use, getting started with Clash takes only three steps and less than 5 minutes.
Choose the recommended client for your operating system and complete the installation:
Open the client and paste the subscription link provided by your service provider into the "Subscription / Profiles" page:
https://your-airport.com/api/subscribe?token=xxx
Click "Import" and wait for the node list to download automatically. No need to manually fill in any server parameters.
Select a node with low latency on the "Proxy" page and enable proxy mode:
Visit ip.sb to verify your IP has changed, indicating the proxy is successfully active.
Recommended Client: Clash Verge Rev (Tauri framework, built-in Mihomo core, supports TUN mode and System Proxy)
Go to the download page of this site and download the Clash Verge Rev Windows x64 EXE installer in the Windows section (most Windows 10/11 computers are x64 architecture). For ARM devices like Surface Pro X, please download the ARM64 version.
After installation, open Clash Verge Rev, click "Subscription (Profiles)" on the left menu, paste the subscription link provided by your service provider in the top input box, and then click "Import".
https://…) in the input boxClick the "Proxy" menu on the left, select a node with low latency from the node list (click "Speed Test" in the top right for real-time latency), then click the "System Proxy" switch in the top right. It turns blue when successfully enabled.
https://ip.sb. If it displays an IP from the node's country/region, the proxy has successfully taken effect.If you need command-line tools like git, npm, pip, and curl to also go through the proxy, please enable TUN Mode in the settings page.
On the "Subscription" page, click the Refresh Icon in the top right of the subscription card to update manually. For automatic updates, click "Edit" on the card and set the "Auto Update" interval (24 hours recommended).
Recommended Client: Clash Verge Rev (Natively supports Apple Silicon M-series and Intel dual architectures)
The macOS version is divided into two architectures. Please choose based on your Mac chip type:
Double-click the .dmg file and drag the Clash Verge Rev icon into the Applications folder.
Open Clash Verge Rev, click "Subscription" on the left, paste your service provider's subscription link in the top input box, and click "Import". The operation is identical to the Windows version.
Select a node on the "Proxy" page and click the "System Proxy" switch in the top right. macOS will automatically inject the proxy settings into system network preferences, and Safari, Chrome, Terminal, etc., will all go through the proxy.
Enable TUN Mode in the settings page to intercept all terminal command line (brew, npm, git) traffic. A system authorization dialog will appear on the first activation; enter your password to confirm.
Recommended Client: FlClash (Material You design, simple operation, first choice for beginners)
Go to the download page of this site and download FlClash APK in the Android section. Phones released after 2016 should directly download the ARM64-v8a version; only older models from before 2015 need the ARMv7 version.
APKs not from Google Play are blocked by default, requiring temporary authorization:
Open FlClash, click "Config" on the bottom navigation, click "+" in the top right -> "Import from URL", paste your subscription link, enter a name, and click save.
Select a node on the "Proxy" page (or choose "Auto Select"), then click the Start Button in the bottom right to enable VPN mode. On first activation, the system will prompt a "VPN connection request"; click "OK" to authorize.
Users with some Clash experience who need more advanced configuration can choose ClashMeta for Android (by MetaCubeX), which deeply integrates the Mihomo core and supports all advanced settings. Also available on the Android download page of this site.
Recommended Clients: Shadowrocket (Best for beginners, ~$2.99) · Stash (Feature-complete, Mihomo compatible)
Due to Apple policy restrictions, Clash-compatible clients are not available on the Mainland China App Store and are all paid apps. You need a US (or HK, TW) Apple ID to switch accounts in the App Store for purchase and download. Please complete the "Register US Apple ID" step below first.
appleid.apple.com in your browser and click "Create Your Apple ID"After signing into the App Store with your US Apple ID, search for and purchase the following clients (Shadowrocket is recommended for beginners):
Open Shadowrocket, click "+" in the top right, select "Type" as Subscribe, paste the subscription link in the URL field, enter a remark name, and click "Done" in the top right.
When using Stash, the import method is the same: click "Config" -> "Add from URL" on the home page and paste the subscription link. Stash fully supports the Mihomo configuration format, including Rule Providers, proxy group policies, and other advanced features.
Recommended Clients: Clash Verge Rev (GUI version) or Mihomo CLI (Command line / Server version)
Choose the installation package format based on your Linux distribution:
The operation of the Linux GUI version is identical to Windows/macOS: paste link to import in "Subscription", select nodes in "Proxy", and enable "System Proxy" or TUN mode.
sudo authorization.On servers without a graphical interface, you can use the Mihomo Core CLI and pair it with systemd for auto-start on boot.
Covering common high-frequency issues encountered by beginners, such as proxy configuration, subscription import, and connection failures.
After enabling the proxy, visit https://ip.sb or https://whatismyip.com in your browser. If the displayed IP address is from the node's country/region (USA, Japan, Hong Kong, etc.), the proxy is active.
If the IP still shows as domestic, please check: ① if the proxy switch is on; ② if the selected node is available; ③ try switching to other nodes.
This is a known limitation of System Proxy mode: System Proxy only intercepts applications that support HTTP/SOCKS protocols, and command-line tools do not read system proxy settings by default.
Recommended Solution: Enable TUN Mode in Clash Verge Rev settings to intercept all system traffic, allowing command-line tools to automatically go through the proxy. You can also temporarily set environment variables in the terminal:
① Expired Link: Log in to your service provider's user center and get the latest subscription link.
② Network cannot access subscription address: The subscription server might be blocked. Try importing after connecting via another proxy, or contact your provider to change the subscription domain.
③ Incomplete Link: Ensure the link starts with https:// and contains no extra spaces or line breaks.
④ Antivirus Interference: Temporarily disable Windows Defender or third-party antivirus software and try again.
System Proxy: Only proxies applications that support HTTP/HTTPS/SOCKS (browsers, most GUI software). Command-line tools do not go through the proxy by default. Simple to configure, suitable for daily use by regular users.
TUN Mode: Intercepts all TCP/UDP traffic via a virtual network card, and all applications and command-line tools pass through the Clash rule engine. Suitable for developers and users who need all tools to go through the proxy.
Recommendation: Use System Proxy for daily use; enable TUN mode when you need development debugging or want terminal tools to go through the proxy.
Clash Verge Rev: On the "Subscription" page, click the "Refresh" icon on the card to update manually; or click "Edit" on the card, check "Auto Update", and set the interval (24 hours recommended).
FlClash (Android): Long-press the config card on the "Config" page and select "Update"; you can also enable auto-update in the edit settings.
Shadowrocket (iOS): Click the corresponding subscription on the "Home" page and pull down to refresh, or enter edit mode and click "Update".
① Test and Switch: Click "Speed Test" on the "Proxy" page, check real-time latency, and choose a node with latency below 100ms.
② Use Auto-Select: Choose the "URLTest (Auto Select)" policy in the proxy group. Clash will periodically test speed and automatically switch to the lowest latency node.
③ Change Region: Try nodes in nearby regions like Hong Kong, Japan, or Singapore.
④ Hysteria 2 Nodes: Based on the QUIC protocol, these are far superior to traditional TCP nodes in high packet loss environments.
Clash Verge Rev: Based on the Tauri framework, feature-complete, supports all Mihomo advanced features (TUN mode, scripts, Rule Provider, etc.), suitable for users with some technical background.
FlClash: Built with Flutter, Material You design, cleaner interface, lower barrier to entry, suitable for beginners seeking ease of use.
Recommendation: Both are fine for beginners, but FlClash is easier to start with. Advanced users should choose Clash Verge Rev. Both support the same subscription format, so switching only requires re-importing the link.
Rule Mode: The default and recommended mode for Clash. It intelligently splits traffic based on a rule list: domestic sites are direct for speed, international traffic goes through the proxy, and ad domains are rejected. Best experience, does not affect domestic use.
Global Mode: All traffic (including domestic) goes through the proxy without分流 judgment. This increases unnecessary latency and may affect domestic payment and banking services. Not recommended for daily use.
Direct Mode: All traffic connects directly without going through the proxy, useful for temporarily disabling the proxy.
Problem still not solved? Welcome to submit an issue on GitHub or check community discussions
Go to the download page, choose your OS, and complete the installation and setup in 5 minutes to start experiencing intelligent split-proxy.