FLCLASH QUICK START · 10 MIN

FlClash User Guide: From Subscription Import to Connection Verification

Follow four steps for the first setup: import a subscription, choose a proxy mode, start the connection, and verify routing results. Configure only what is needed for a working connection; leave advanced fields to the configuration reference.

About 10 minutes For first-time setup Four steps
SETUP ROUTE Basic Connection Path
  1. 01
    Subscription URL → Configuration File
  2. 02
    Policy Rule → Proxy Group
  3. 03
    Connection System Proxy / TUN
  4. 04
    Verification Egress / Rules / DNS
profile → mode → connection → verify
BEFORE START

Before You Start: Prepare the Client and a Valid Subscription

Before you begin, install FlClash and have a valid subscription URL that is still active and reachable. Subscription URLs are usually generated by a service provider and point to a remote configuration file; they are not ordinary web addresses or single-node parameters. Copy the URL directly from the provider’s subscription management page using its copy button to avoid spaces, line breaks, or truncated characters introduced by messaging apps.

A subscription URL is sensitive configuration data. It may contain a path or parameters that identify your account, so store it only on trusted devices and in trusted clients. Do not post it on forums, in screenshots, or in public documents. If the URL has been exposed, reset it in your provider dashboard and replace the old URL in FlClash. This guide only requires the URL; you do not need to edit YAML manually or understand every proxy protocol in advance.

On first launch, the system may ask for network, VPN, local network, or background-running permissions. These permissions affect the system proxy, TUN routing, local network access, and persistent connections respectively. Start the client first; grant specific permissions as needed in step three. If installation is not complete, open the Download Center and choose your platform. For installation blocks, permission prompts, or launch failures, see Common Issues, then return to this page.

Cl

Client Installed

FlClash opens normally and can access the configuration, proxy, and settings pages.

Ur

Subscription URL Works

The URL is complete, still valid, and copied directly from the subscription management page.

01
PROFILE IMPORT

Import Subscription

Convert the remote subscription into the active configuration. Confirm that it fetched successfully before choosing a policy.

Create a Configuration from a URL

After opening FlClash, go to the “Configuration” or “Subscription” page. You will usually find local configurations, remote configurations, and an option to add one. Choose the add button, select “URL” or “Import from link” as the source, and paste the complete subscription URL into the address field. Use a short, recognizable name, such as the provider or purpose. If the client supports automatic naming, you can keep the generated name.

After submission, FlClash requests the remote configuration over the network. Do not click Save repeatedly or close the client immediately. On success, a new entry appears in the configuration list with an update time or update status. Open it to confirm that proxy nodes, proxy groups, and rules are present. Subscriptions vary in node count and group names, so success is not measured by a fixed number. If the configuration can be selected and the proxy page shows usable policy groups, the import is complete.

Set the New Configuration as Active

A successful import does not necessarily mean the configuration is active. Return to the configuration list, select the newly added entry, and confirm that the selection marker, enabled state, or “Set as Active” button has changed. Some versions select it automatically; others require a manual switch. After switching, open the proxy page and inspect the policy groups. If the old group names still appear, the active configuration has not changed—return to the list and select the new one again.

If your provider offers multiple subscription endpoints, import only the primary one during initial setup. Enabling several subscriptions at once makes troubleshooting harder and may create policy groups with identical names but different contents. Add a backup subscription or local configuration later, after the basic connection works. Leave the automatic update interval at the client default for now.

02
MODE AND POLICY

Choose a Proxy Mode

Start with Rule mode as a stable baseline, then choose the right outbound for the main policy groups.

Use Rule Mode for Everyday Use

Open the “Proxy” page or the mode selector on the home page. You will usually see Rule, Global, and Direct modes. For initial setup, choose “Rule.” Rule mode uses the subscription’s rules to route different domains, IPs, or network types through a proxy or direct policy. This keeps local services direct while sending requests that need a proxy to the appropriate policy group.

Global mode generally sends most traffic through the currently selected proxy. It is useful for temporarily checking whether rules are matching, but it should not be the only basis for judging an initial setup. Direct mode bypasses the proxy and can help determine whether a problem originates in the proxy path. Switching modes does not change the subscription or delete nodes, so you can switch briefly during testing and return to Rule mode afterward.

Choose a Node or Automatic Policy for a Policy Group

On the proxy page, you will see policy groups defined by the subscription. Common names may indicate node selection, automatic selection, failover, streaming, or final matching, but the actual names come from the provider. Find the main node-selection group and choose a healthy node, or select an automatic policy already configured by the subscription. Then check whether the “Final,” “MATCH,” or similar fallback group references that main policy, so traffic does not leave through a different outbound.

Latency in the node list is only a single probe result; it does not fully represent sustained speed, stability, or access to every website. For the first selection, prefer a geographically nearby node whose latency test completes, then verify it through real access in step four. If every probe times out, do not immediately assume that all nodes are unavailable: the probe target, current network, firewall, or DNS status may affect the results.

Leave DNS, Overrides, and Scripts at Their Defaults for Now

A common initial-setup mistake is changing DNS, TUN, override scripts, and rule sets before establishing a basic connection. When several variables change together, the cause is difficult to identify. This step only confirms the mode and main policy group; leave advanced settings at the subscription or client defaults. After the basic connection works, adjust settings one category at a time for your use case.

If you need to understand how mode, proxy-groups, rules, and DNS fields relate to one another, read the Configuration Fields Reference. That page documents fields and YAML structure; this guide avoids manual configuration so the first connection stays straightforward.

mode: rule profile: current policy: selected
03
CONNECTION

Start the Connection

Start the core first, then choose the system proxy or TUN; the two routing methods cover different types of traffic.

Confirm the Active Configuration and Start the Core

Return to the FlClash home page. Check that the active configuration is the one imported in step one and that the proxy mode is Rule mode from step two. Then click the Run, Start, or Connect toggle. The status should change from stopped to running and show that the current core is active. If it immediately returns to stopped, the usual causes are a configuration parse error, a port conflict, or insufficient permissions. Check the first error in the client log before enabling the system proxy.

A running core means FlClash can read the configuration and create a local proxy port. Whether application traffic reaches that port depends on the routing method. On desktop, the most direct option is the “System Proxy.” Android generally uses system VPN authorization; use TUN when applications do not follow system proxy settings.

Use the System Proxy First on Desktop

On Windows, macOS, or Linux, find and enable the “System Proxy” switch. FlClash points the system’s HTTP or SOCKS proxy to its local listening port, so browsers and most apps that follow system network settings use the proxy. The first time you enable it, macOS may request permission to modify network settings; Linux behavior can vary by distribution and desktop environment. After granting permission, keep FlClash running and continue to step four.

The system proxy is a good baseline for the first connection because its state is clear and easy to undo. If only one application bypasses the proxy, check whether it has its own proxy settings or ignores the system proxy entirely. Do not change all rules just because one application behaves differently.

Enable TUN for Full-Traffic Routing

TUN creates a virtual network interface and sends more types of traffic to the core. On Android, authorization usually appears as a system VPN confirmation dialog; on desktop, administrator access, a network extension permission, or service installation may be required. Read the application name and permission scope in the system dialog, and approve it only after confirming that it belongs to the installed client. If authorization is denied, the TUN switch may turn off automatically; grant the required permission in system settings and try again.

The first connection does not require both the system proxy and TUN. If the system proxy covers your current use case, keep it enabled first. If games, command-line tools, or specific apps do not read system proxy settings, disable the redundant routing method and test TUN separately. Platform behavior when combining the two modes varies, so avoid enabling multiple routing entry points without understanding the result.

04
VERIFY

Verify the Connection

Do not rely on the connection icon alone. Confirm the route through egress details, rule logs, and DNS results.

First Confirm That the Browser Can Reach Real Websites

Keep FlClash running in the background. Open a browser and visit websites that normally load reliably, then visit a target site that should use the proxy. If the page loads, the basic path from the app to the local proxy and on to the remote node is working. Next, use a trusted network-information site to check your current egress IP and approximate region; they should broadly match the selected node’s egress region. You only need to confirm the direction, not a specific address, since some services use dynamic egress IPs.

If the browser cannot access the internet at all, first disable the system proxy or TUN and confirm that the original network works again, then restart FlClash. If the original network works but the proxy connection fails, check the active node, subscription update time, and logs in the client. If the original network itself is failing, troubleshoot the local Wi-Fi, mobile network, or router first.

Review Connection Logs and Rule Matches

Open the “Connections” or “Logs” page, then refresh the website you just visited. The list should show a new domain connection, its matching rule, policy group, and actual outbound. If the target site is assigned to a proxy group and the actual outbound is the node selected in step two, Rule mode is working. If every request shows Direct, check that the mode is still Rule, the final policy does not point to Direct, and the subscription rules have loaded.

Connection logs are also the main way to investigate a single website. Find its domain first, then see which policy group received it. If the group is correct but the connection fails, try another node in the same group. If the group is unexpected, inspect rule order or the subscription provider’s routing design. During initial setup, avoid writing custom rules immediately; first confirm whether the issue comes from the existing subscription configuration.

Check Routing with Two Types of Websites

The goal of Rule mode is not to send all traffic through one egress, but to choose a path for each request. Visit a commonly used local service and a service that requires a proxy, then inspect the connection logs. The local service should usually match a Direct or local-region rule, while the proxied service should enter a proxy policy group. When both requests behave as expected, the routing path is complete.

If a website works after temporarily switching to Global mode but fails in Rule mode, the issue is usually a rule match or policy-group reference. If Global mode also fails, check the node and connection permissions first. Switch back to Rule mode after testing instead of treating Global mode as a permanent fix.

Check DNS Last

Once basic webpages load, check for slow domain resolution, domains that fail intermittently, or clearly different IPv4 and IPv6 results. Switch nodes first to rule out a single-egress issue, then reconnect to refresh the session. Investigate DNS settings only when domain access fails while direct network connectivity remains normal.

DNS involves the system resolver, the client listener, encrypted DNS, Fake IP, rule matching, caching, and other components, so it is not suitable for changing everything at once in a first-time guide. For persistent issues, record the affected domain, current mode, whether TUN is enabled, and the log results. Then see Common Issues; for field-by-field details, read the DNS section in the Configuration Fields Reference.

Completion Criteria

  • Configuration: The imported subscription is active, and its policy groups expand normally.
  • Mode: Rule mode is used for everyday traffic, with a usable outbound selected for the main policy.
  • Routing: The system proxy or TUN is enabled, and the core remains running.
  • Egress: The proxy target’s egress region aligns with the selected node.
  • Routing: Local services and proxied targets match the expected rules.
  • Resolution: Common domains resolve reliably without persistent errors.
AFTER SETUP

Everyday Use After the Connection Works

After the first verification succeeds, everyday checks can be reduced to three: whether the subscription is still valid, whether the active policy fits the use case, and whether the system proxy or TUN is in the required state. You usually do not need to delete and re-import the configuration. When nodes or rules change, update the existing subscription from the configuration page. If policy-group names change after an update, recheck the main and final policy selections.

After switching networks, such as moving from home Wi-Fi to a mobile hotspot, check whether the connection recovers automatically. If an old connection remains stuck, stop and restart the routing mode so the system can establish a new network path. After device sleep, an OS upgrade, or a network-extension update, a complete reconnect is usually better than resetting the entire configuration.

Follow the single-variable principle when changing settings: change only one of the node, mode, DNS, or routing method at a time, then repeat the verification in step four. This makes the source of each change clear. To add custom rules, change DNS mode, write an override, or merge configurations, consult the Configuration Fields Reference. For subscription updates, permissions, connection, latency, or resolution problems, use Common Issues to troubleshoot by symptom.

SETUP COMPLETE

Basic Connection Established

Keep the current working configuration as your baseline. Change one setting at a time and recheck egress and rule logs after each change.