FlClash Tutorial: A Lightweight Clash Client That Actually Works

Most proxy clients fall into one of two categories: powerful but ugly, or pretty but useless. FlClash sits in the middle — it runs on the ClashMeta (mihomo) core, which means it handles every protocol your subscription throws at it, but it wraps that engine in an interface that doesn't make you read a wiki before importing a config.

It's cross-platform: Android, Windows, macOS, and Linux all use the same app, same subscription link, same mental model. Once you've set it up on one device, the others take about ninety seconds each.

Already have FlClash installed and just need a stable subscription? Wraith VPN's plans work with FlClash out of the box — global nodes, USDT payment, no account registration required.

Table of Contents

1. What FlClash Is (and Isn't)
2. Downloading the Right Build
3. Importing a Subscription
4. Picking Nodes Without Wasting Time
5. The Three Proxy Modes, Explained Plainly
6. Connecting
7. Common Problems and What Actually Fixes Them
8. Where to Go Next

What FlClash Is (and Isn't)

FlClash is a proxy client built on the ClashMeta core — also known as mihomo. That core is the same engine powering Clash Verge Rev, Clash Nyanpasu, and a dozen other clients. What differs between them is the shell: how the UI looks, how subscriptions are managed, and how much configuration you're expected to do by hand.

FlClash's design goal is simplicity without losing the rule engine. You still get rule-based routing, proxy groups, per-app splitting, and TUN mode. You just don't have to edit YAML files to use them.

What FlClash is not is a VPN service. It doesn't include any servers. You bring a subscription from a provider, and FlClash does the routing. That's true of every Clash client, and it's worth repeating because half the "FlClash doesn't work" complaints online come from people who installed it and expected nodes to appear out of nowhere.

If you need a subscription, Wraith VPN's plans are compatible with FlClash and every other ClashMeta client. Plans start at $19/year and accept USDT without any personal information.

Downloading the Right Build

FlClash is distributed through GitHub Releases. There's no App Store version, no Play Store version — GitHub is the source, and any third-party mirror should be treated as suspect.

Pick the file that matches your platform:

On Android, you'll need to enable "Install unknown apps" for whatever app you use to open the APK. On Windows, SmartScreen will flag the installer — click "More info" → "Run anyway." Both warnings are standard for open-source clients distributed outside official stores; the source code is on GitHub if you want to verify the build yourself.

We keep a download center with verified links for FlClash and other clients, updated whenever a new release ships.

Importing a Subscription

Once FlClash is open, the subscription import flow is nearly identical on every platform. The menu labels change slightly between Android and desktop, but the logic is the same.

On desktop: click Profiles (sometimes labeled "Config" or "Configurations") in the left sidebar, then the + button, then Import from URL.

On Android: tap Profiles at the bottom of the screen, tap the + button, then choose URL.

Paste your subscription link and confirm. FlClash will download the config — this usually takes a few seconds. When it finishes, the profile appears in your list. Tap it once to activate it. Downloading a profile and selecting a profile are two different things; a downloaded-but-unselected profile does nothing.

If your subscription is V2Ray or Shadowrocket format: FlClash only reads Clash/ClashMeta YAML files. Ask your provider for the Clash subscription link, or run the V2Ray link through a subscription converter first. Most providers offer both formats — check your dashboard before assuming the link is broken.

To update later, tap the refresh icon on the Profiles page. FlClash will re-download every subscription in your list.

Picking Nodes Without Wasting Time

Open the Proxies tab. You'll see your proxy groups — depending on your subscription, these might be named by region (Japan, US, Singapore), by function (Streaming, ChatGPT), or simply "Auto" and "Manual."

Tap the speed-test icon in the corner to run a latency check across all nodes. Give it thirty seconds.

Now the important part: don't just pick the lowest number. Latency measures how quickly FlClash can reach the server, not how much bandwidth it delivers. A node at 45ms can still buffer a 1080p video if it's oversold, and a node at 190ms can stream 4K without stuttering if it has capacity.

The practical test is to connect and open YouTube. If a 1080p video plays without buffering, you're on a good node. If not, try the next one. The speed-test numbers are a starting point, not the final answer.

If your subscription uses an Auto Select group, FlClash will handle node rotation for you based on the subscription's own health-check rules. That's usually fine for daily browsing. Manual selection matters more when you're targeting a specific service — streaming, gaming, or a region-locked AI tool.

The Three Proxy Modes, Explained Plainly

On the Dashboard (or "Home") screen, you'll see an outbound mode selector with three options. Here's what each one actually does, not the marketing version:

Rule mode is what you want for daily use. Your banking apps, delivery services, and local video platforms stay on a direct connection. Your browser, YouTube, and anything else that matches a proxy rule goes through the node you selected. This is the entire point of using a Clash client instead of a traditional VPN app — split routing is built in, not bolted on.

Global mode has one quirk worth knowing: switching to Global on the Dashboard isn't enough. You also need to go to the Proxies tab, find the GLOBAL group, and manually select a real node. If you skip that step, Global mode often defaults to DIRECT or REJECT — which is why some users switch to Global and immediately think the app broke.

Connecting

On desktop, the Dashboard has a System Proxy toggle. Turn it on. That's it — your browser and most apps will now route through FlClash according to your rules.

On Android, you need to do one more thing: tap the play button (the circular icon in the corner). Android will show the standard VPN permission dialog. Tap OK and authenticate if prompted. The status indicator will change to show the tunnel is active.

FlClash on Android runs as a local VPN service — that's how it captures traffic without root. If you've used any other proxy client on Android, this is the same mechanism V2RayNG and Clash for Android use.

To disconnect, turn System Proxy off (desktop) or tap the play button again (Android).

Common Problems and What Actually Fixes Them

System proxy is on, but nothing loads

Check these in order:

1. Is a profile actually selected? Downloading a profile doesn't activate it. Tap it in the Profiles list until it shows as active.
2. Is a real node selected? In the Proxies tab, make sure you're not on DIRECT or REJECT. Some proxy groups default to DIRECT until you manually pick a node.
3. Is the mode set correctly? If you're on Direct mode, nothing gets proxied. Switch to Rule.
4. Is your system clock accurate? TLS connections fail when the clock is off by more than a few minutes. Enable automatic time sync and retry.

It works on Wi-Fi but not mobile data (or vice versa)

This is almost always a DNS issue tied to one network. Some carriers run DNS servers that return incorrect results for overseas domains. Open FlClash settings and look for a DNS configuration option — set a custom resolver like 1.1.1.1 or 8.8.8.8.

If you're on Wi-Fi and see this, check whether the network requires a login page (hotel, airport, cafe). You need to authenticate through the captive portal before FlClash can reach your subscription endpoint.

The tunnel drops after a few minutes on Android

This is Android's battery optimization, not FlClash. Chinese OEM ROMs — Xiaomi, Huawei, Oppo, Vivo — aggressively kill background VPN services. Three settings to change:

1. Battery: Settings → Apps → FlClash → Battery → set to "Unrestricted"
2. Autostart: In the same app settings, enable "Autostart" or "Startup Manager"
3. Lock in recents: Open the recent apps view, find FlClash, tap the lock icon

On MIUI and HyperOS, also enable Show pop-up windows and Display in status bar. Without these, MIUI will kill the tunnel within ten minutes regardless of your battery settings.

All nodes show timeout after importing

Two possibilities. First, the subscription itself may have expired — log into your provider's dashboard and check. Second, the subscription URL might be blocked on your current network. Try switching between Wi-Fi and mobile data to isolate the cause.

If neither helps, the provider's server is likely down. Nothing on the client side will fix that.

Windows Defender flags the installer as a virus

This is a false positive common to open-source proxy clients signed with non-commercial certificates. You can verify the build by checking the SHA-256 hash against the one posted in the GitHub release notes, or by reading the source code directly on GitHub.

Where to Go Next

• Setting up another Android client? The Android VPN tutorial category covers Clash for Android, V2free, and V2freeGo.
• On iOS instead? The iOS help category has guides for Shadowrocket and Streisand.
• Desktop setup: dedicated walkthroughs for Windows, macOS, and Linux.
• Need a subscription that works with FlClash? Compare Wraith VPN plans → — Clash-compatible subscription, USDT payment, no real-name registration.
• New to proxies entirely? Start with the VPN beginner's guide.