FlClash 2026: Complete Setup Guide for Android, Windows, Mac & Linux
About FlClash: FlClash is a cross-platform Clash Meta (Mihomo) GUI client built with Flutter. It runs on Android, Windows, macOS, and Linux from a single codebase, featuring a modern Material You design, lightweight resource usage, and full Clash Meta protocol support. This guide covers installation, subscription setup, rule configuration, TUN mode, and answers to the most common problems in 2026.
Why Choose FlClash in 2026?
True Cross-Platform
One app, four platforms. Your config syncs across Android, Windows, Mac and Linux. No need to learn different UIs for each device.
Material You Design
Dynamic color theming adapts to your wallpaper on Android 12+. Clean, modern UI that doesn't look like a developer tool.
Lightweight
Uses significantly less RAM and battery than traditional Clash GUIs. Ideal for older Android phones or low-spec Windows PCs.
Clash Meta / Mihomo Core
Full Mihomo kernel support means VLESS, Hysteria2, TUIC, Reality, Shadowsocks, and all standard proxy protocols just work.
Platform Support at a Glance
Install FlClash on Android
Download APK from GitHub
Visit github.com/chen08209/FlClash → Releases → download FlClash-x.x.x-android-arm64-v8a.apk for modern devices, or the universal APK for broader compatibility.
Install and grant VPN permission
Tap to install, then open FlClash → tap the shield icon to start → Android will prompt for VPN permission. Tap OK to allow.
Import subscription
Tap the Profiles tab → + → URL → paste your Clash Meta subscription link → tap save. FlClash will download and parse all nodes automatically.
Install FlClash on Windows
Download Windows installer
From GitHub Releases, download FlClash-x.x.x-windows-amd64-setup.exe (installer) or the portable ZIP version.
Run as Administrator
Right-click the installer → Run as administrator. This ensures FlClash can set system proxy and install the TUN virtual adapter.
Download Mihomo kernel
On first launch, FlClash may prompt to download the Mihomo core. Click Download and wait for it to complete before connecting.
Install FlClash on macOS
Download .dmg
Download FlClash-x.x.x-macos-arm64.dmg (Apple Silicon) or -amd64.dmg (Intel) from GitHub Releases.
Remove quarantine attribute
Open Terminal and run: sudo xattr -rd com.apple.quarantine /Applications/FlClash.app — this bypasses the "unidentified developer" warning.
Approve network extension
System Settings → Privacy & Security → approve the FlClash network extension. Required for TUN mode and system proxy features.
Subscription Import & Profile Management
FlClash uses Clash Meta / Mihomo format YAML subscriptions. Most major VPN providers (including VPN07) offer direct Clash-format links.
Subscription Import (All Platforms)
- 1. Open FlClash → navigate to Profiles tab.
- 2. Tap/click + Add Profile → select URL.
- 3. Paste your Clash Meta subscription URL in the URL field.
- 4. Set update interval to 24 hours → save.
- 5. Click the refresh icon to load nodes immediately.
- 6. Activate the profile by clicking the toggle next to it.
Multiple Profile Support
FlClash allows you to save multiple subscription profiles and switch between them instantly. This is useful if you have multiple VPN accounts or want to switch between different rule sets. Only one profile can be active at a time.
Understanding Proxy Groups in FlClash
Proxy groups control how FlClash routes traffic. After importing a subscription, you'll see groups in the Proxies tab:
PROXY (Main Group)
Default outboundThe primary proxy group that traffic flows through. Can point to a specific node or to sub-groups like Auto Select or regional groups.
Auto Select (url-test)
Smart speed testAutomatically tests all nodes and selects the fastest one. Retests every 5 minutes by default. Tap "Test" to force an immediate update.
Fallback
FailoverUses the first node, switches to the next only if the current one fails. More stable for long-lived connections like video calls.
Enabling TUN Mode for System-Wide Proxy
TUN mode routes all device traffic through FlClash, including apps that ignore system proxy settings. Essential for gaming or when you need complete traffic coverage.
Enable TUN Mode by Platform
Proxy Rule Modes Explained
Route based on domain/IP rules. Best for most users — Chinese/local traffic goes direct, foreign traffic goes through proxy.
All traffic through proxy. Use when you need complete privacy or if Rule mode is causing issues.
All traffic direct. Temporarily disable proxy without closing FlClash.
FlClash Performance Tips
💡 Use "Auto Select" for daily browsing
The url-test proxy group automatically picks the lowest latency node. With VPN07's 70+ country nodes, you'll always get a fast server near you. Expect 500–900Mbps throughput on 1000Mbps nodes.
💡 Enable "Clash DNS" for leak prevention
FlClash Settings → DNS → Enable Clash DNS. This routes all DNS queries through the proxy, preventing your ISP from seeing which domains you visit. Use fake-IP mode for best performance.
💡 Reduce battery use on Android
Set test interval to 600 seconds (10 min) instead of the default 300s. Enable "Always On VPN" in Android network settings so FlClash restarts automatically after reboot without manual intervention.
Common FlClash Problems & Fixes
Q: FlClash shows "Profile parse error" after import
Fix: The subscription URL must return valid Clash YAML or Mihomo JSON. Open the subscription URL in your browser — if it downloads a file, check that its content-type is text/plain or application/yaml. If your provider uses a different format, try using a subscription converter (e.g., subconverter) to convert V2Ray links to Clash format before importing.
Q: Connected but websites still not accessible
Fix 1: Check that a proxy group is selected under Proxies → PROXY. If it shows "DIRECT", click it and select a node or Auto Select group. Fix 2: Try switching from Rule mode to Global mode temporarily to confirm the proxy works. Fix 3: Verify your subscription nodes are not all expired by checking server latency in the Proxies tab.
Q: FlClash crashes on Windows startup
Fix: Go to FlClash installation folder → delete the config.yaml file (this resets settings, not your profiles). Relaunch FlClash. If it still crashes, try the portable ZIP version instead of the installer, or reinstall with Administrator privileges.
Q: TUN mode not working on macOS — traffic not routing
Fix: System Settings → Network → check that a "FlClash" or "Mihomo" interface is active. If not, disable and re-enable TUN mode in FlClash. Also check Privacy & Security → Extensions to confirm the network extension is allowed.
Q: FlClash Android keeps disconnecting (battery optimization)
Fix: Android Settings → Apps → FlClash → Battery → select Unrestricted. On MIUI/HyperOS: also enable Auto-start in App Management. Some Samsung devices additionally need "Sleeping apps" exclusion list updated.
Q: How to update FlClash to the latest version?
FlClash has an in-app update checker: Settings → About → Check for Updates. On Android, this downloads and installs automatically. On Windows/Mac, it downloads the new installer for you to run. Alternatively, always download the latest release from the official GitHub repository.
VPN07 + FlClash: Perfect Together
Native Clash Meta subscription — works on all 4 FlClash platforms instantly
VPN07 provides Clash Meta / Mihomo format subscriptions that are 100% compatible with FlClash across all platforms. One subscription link works on your Android phone, Windows PC, Mac laptop, and Linux server simultaneously. With 1000Mbps bandwidth per node across 70+ countries, FlClash's auto-select group will consistently pick sub-30ms latency nodes. Trusted for over 10 years with a 30-day money-back guarantee.
Related Articles
Clash Meta for Android (CMFA) 2026: Full Setup Guide
Another top Mihomo client for Android — compare CMFA vs FlClash and pick the right one for your workflow.
Read More →Mihomo Party 2026: Windows & Mac AI Node Selection
For desktop power users: Mihomo Party offers more advanced features than FlClash on Windows and Mac.
Read More →