Clash Tutorial: From Subscription Import to Connection Verification
Follow one clear path to your first connection: prepare the client, import a subscription, choose a proxy mode, connect a node, and confirm that browser traffic is routed through the proxy as expected.
For mihomo-based clientsFour steps to your first connectionWindows · macOS · Android · iOS · Linux
FIRST CONNECTIONmihomo workflow
01
Subscription Configuration
URL → Profile
02
Rule Mode
Rule matching
03
System Proxy
Proxy enabled
04
Outbound Verification
IP and logs
Before You Begin
The client, subscription URL, and system time
Confirm these three basics first to avoid repeatedly returning to the settings page. This section covers only what you need for the first connection; advanced rules, DNS, TUN parameters, and configuration overrides are covered in the Advanced Configuration Guide.
Make sure the client starts normally
If the client is not installed yet, visit the download page and choose a graphical client for your operating system. Windows and macOS users should be able to open the main window after installation. Android and iOS users may see a VPN permission notice on first launch, but do not need to connect immediately. Linux desktop users should first confirm that the client can read the configuration directory and create system proxy settings.
After launching the client, check that the interface renders completely. If you can see the main entries for configuration, proxies, or settings, continue. If a firewall prompt appears on first launch, allow the client to use the network it needs for your environment. If the system blocks the client from starting, resolve the permission issue first instead of repeatedly importing the same subscription.
A
Prepare the complete subscription URL
The subscription URL is generated by the relevant service provider. When copying it, include everything from the protocol prefix through the final parameters; do not copy only the portion visible in a truncated web field.
B
Correct the system date and time
A significant system clock error can prevent secure connections from being established. Enable automatic time and time-zone settings in the operating system, then restart the client.
C
Temporarily disable other proxies
If another proxy tool is still running, quit it or turn off its system proxy switch first. This prevents two programs from modifying the system proxy or using the same listening port.
01
PROFILE
Step 1
Import a Clash Subscription URL
After opening the client, look for a “Subscription,” “Configuration,” “Profiles,” or “Config” page. Desktop clients usually place it in the left navigation bar, while mobile clients often put it in the configuration area on the home screen. Choose New from URL, Add Subscription, or Import Remote Configuration. Do not choose local file import, because you are preparing an online subscription URL.
Paste the complete URL into the address field. Some clients also ask for a configuration name; use a short, recognizable name such as the service source or intended use. This name is only for your local list and does not change the subscription. After confirming the address, click Download, Import, Save, or Update. The client will fetch the remote configuration and save its proxy nodes, policy groups, rules, and DNS settings as a local configuration.
When the import finishes, the configuration list usually gains a new entry and shows its latest update time. One easy-to-miss step remains: click the entry and make it the active configuration. Some clients show a checkmark, highlight color, or “Current” label beside the selected item; others require an Enable button. Only after the active configuration is loaded can the policy groups and node list be generated from this subscription.
How to confirm this step is complete
Leave the configuration page and open “Proxy,” “Proxies,” or the policy-group page. If you can see policy groups such as Auto Select, Node Select, or Failover, with selectable nodes after expanding them, the configuration has been read by the kernel. If the page is still empty, do not enable the system proxy yet: without an active configuration, the client cannot determine where to send traffic. For more subscription update issues, see the installation and configuration section of the FAQ.
Once nodes and policy groups appear, do not rush to switch between them. First determine the proxy mode, because it controls whether rules participate in matching and what results you should expect during verification.
02
MODE
Step 2
Choose Rule Mode
After loading the configuration, open the Mode option in the settings or proxy page. Common choices are Rule, Global, and Direct. Rule mode is recommended for first-time use. It evaluates the rules in the active configuration from top to bottom: requests matching direct rules connect directly, requests matching proxy rules are sent to a policy group, and remaining traffic follows the default rule at the end of the configuration. This preserves local network access while sending traffic that needs a proxy through the selected node.
Global mode sends most capturable traffic to one proxy policy. It is useful for briefly checking whether an access problem is caused by rule matching, but it should not be the default when you do not yet understand the configuration. Direct mode normally bypasses the proxy and is mainly useful for pausing proxying or troubleshooting the local network. Changing the mode does not replace the system proxy switch: the mode controls “how captured traffic is handled,” while the system proxy or TUN controls “how traffic enters Clash.” They operate at different layers.
After choosing Rule mode, return to the proxy page. You will see several policy groups, each responsible for a type of decision. Their names come from the subscription configuration and may include Node Select, Auto Select, Streaming, or other purposes. For the first connection, find the main policy group that provides the default proxy exit. It is usually near the top and contains multiple nodes or an auto-selection sub-policy.
RULE
Rule Mode
Routes traffic according to domain, IP, rule sets, and configuration order. It is the recommended everyday default and the mode used in the rest of this tutorial.
GLOBAL
Global Mode
Sends capturable requests to a specified proxy policy. Use it for a short comparison test, then switch back to the intended mode.
DIRECT
Direct Mode
Sends traffic directly to its destination. Use it to pause proxy routing or compare local-network results; it does not mean the client has exited.
Keep the default DNS and rule settings for now
For the first connection, avoid changing Fake-IP, domain sniffing, rule-set sources, the DNS listen address, and TUN routes at the same time. Changing too many parameters makes the cause of a problem difficult to identify. Use the subscription's defaults to connect and verify the basic path first, then adjust settings one at a time as needed. See Advanced for how Fake-IP, DNS split routing, and rule priority work.
Once Rule mode is set, the traffic path is defined. Next, select an available node in the main policy group and enable the traffic-capture method appropriate for your system.
03
CONNECT
Step 3
Choose a Node and Connect
Open the Proxy or policy-group page and open the main policy group that provides the default exit. If the list contains both individual nodes and sub-policies such as “Auto Select” or “Failover,” choose a specific node for the first test so you can identify the exact route being used. After verification, switch to an automatic policy if that better suits the configuration.
Clients usually provide a latency-test button. After testing, a node that returns a result has at least connected to the test target; a timed-out node is not a good candidate for first verification. Latency reflects the response from one test address at that moment and does not represent the actual speed of every website. Choose a node that returns results consistently; there is no need to keep testing just to find the lowest number.
After selecting a node, return to the client home or settings page and turn on “System Proxy.” On desktop systems, browsers and applications that follow system proxy settings will normally send traffic to Clash's local listening port. Windows may show a firewall permission dialog, while macOS may ask you to approve a system settings change. Follow the operating system prompts, then confirm that the switch remains enabled rather than immediately turning itself off.
Mobile connection methods
Android and iOS clients usually capture traffic through the system VPN interface. After you tap Start, Connect, or the main switch, the system displays a VPN permission prompt. Confirm it; a VPN indicator should appear in the status bar and the client should show a connected state. The VPN interface passes device traffic to the local proxy kernel, while the current Clash configuration still determines how requests are handled through its mode, rules, and policy groups.
When to consider TUN mode
On desktop, enabling only the system proxy is usually enough for browsers, but some games, command-line tools, and applications that ignore system proxy settings may remain direct. Consider TUN mode when you have a specific need to capture that traffic. TUN operates at a lower level and may require administrator access, network-extension permission, or virtual network adapter installation. Do not enable multiple capture switches before basic browser verification is complete, or it will be difficult to tell which path handled the request.
Check whether the client is receiving connections
After enabling traffic capture, open a new browser tab and visit a regular webpage, then return to the client's connections or logs page. Normally you should see records containing the domain, destination, matched rule, and policy used. Ongoing log entries show that browser requests have reached the kernel. If no new entries appear at all, the system proxy may not be active, the browser may use its own proxy settings, or another network tool may still be capturing traffic.
The connection path is now in place, but an enabled switch alone does not prove that the outbound route changed. The final step is to check both the external outbound details and the client's internal records.
04
VERIFY
Step 4
Verify That the Proxy Is Working
Start verification with a comparable baseline. If you did not record the outbound details before connecting, turn off the system proxy or disconnect on mobile, open a familiar IP lookup page, and note the current network's outbound region and provider. Then turn Clash back on and refresh the same page. If the outbound details change to match the expected location of the selected node, browser traffic is going through the proxy policy.
An IP page alone is not enough. Return to the client's connection records, find the request just generated, and confirm that it matched the expected rule and was sent through the selected policy or node. In Rule mode, not every website will show the same outbound location: local sites, LAN addresses, and domains configured for direct access may continue using the local network, which is normal rule-based routing. Choose a destination that is expected to use the proxy and interpret the result together with the rule log.
Next, test two basic scenarios. First visit a familiar page that is expected to connect directly and confirm that it loads normally. Then visit a page expected to use the proxy and confirm that it opens while the client records the proxy policy. Only when both types of requests follow their rules have subscription configuration, proxy mode, node selection, and traffic capture formed a complete path.
External result
The outbound details match expectations
The results before and after connecting are comparable, and the outbound location for the proxied destination matches the current node. Refreshing does not produce repeated connection timeouts or certificate time errors.
Internal records
The request matches the correct policy
The connections or logs page contains the test request and shows its rule, policy group, and actual node instead of always showing Direct.
Test other applications only after the browser works
Successful browser verification means the client, configuration, and basic proxy path are working. Now test desktop programs, terminal commands, or mobile apps that need network access. If only one program fails, the possibilities are narrowed to whether it follows the system proxy, uses its own DNS, requires TUN, or has its own network cache. Do not re-import the subscription or make major rule changes at this stage; doing so would destroy the working baseline you have already confirmed.
After completing all checks, switch the main policy group to Auto Select or keep the specific node you just verified. Later subscription updates may add, remove, or rename nodes; if the selected option becomes unavailable, open the policy group and choose another one. The first-connection workflow is now complete.
First Troubleshooting Steps
If the connection does not work, check the path in order
Troubleshoot in the same order as the setup. Change only one condition at a time and retest after each change so that multiple changes do not mask one another.
Confirm that the active configuration is selected
Return to the configuration page, check the selection indicator, and run one manual update. An expired configuration, failed download, or configuration that was imported but not enabled can leave policy groups empty or keep the old content active.
Confirm that the node itself can connect
Switch to a node that completes the test in the main policy group. If every node times out, check the local network, system time, and subscription status first instead of repeatedly changing proxy modes.
Confirm that traffic is entering the client
After enabling the system proxy or mobile connection, watch the logs. If visiting a webpage creates no new entries, check the browser's independent proxy settings, the system proxy status, and other network tools.
Confirm that the local listening port is available
If the startup log shows address already in use, a process is usually occupying the listening port configured in the profile. Quit the conflicting program or change the listening port, then reload the configuration.
Restore the simple, verified path
If problems appear after changing DNS, TUN, or rules, return to the basic combination of Rule mode and the system proxy. Once the basic path works again, enable advanced features one at a time.
Completion status
Keep one reproducible baseline configuration
When Rule mode, one working node, and the system proxy are stable, keep a record of those settings. If a later DNS, TUN, or custom-rule change causes problems, quickly return to this baseline and identify which change affected the connection.
When switching platforms or clients, choose the corresponding system on the download page first. Interface labels may change, but the workflow remains the same: subscription, mode, policy, traffic capture, and verification.