Installation and Migration · Clash Technical Blog

Installing FlClash on Android: APK, Subscription Import, and Background Operation

After installing FlClash, grant VPN access, update the subscription, and choose a node. Change battery/background permissions only for lock-screen disconnects; test each stage.

  • FlClash
  • Android
  • APK
  • Background operation
On this page

First download an APK that can be installed on this Android phone

Some people change subscriptions when an APK will not install; others change battery settings as soon as they see a VPN icon. The correct order is to choose the right APK from the official releases, install it and grant VPN permission, then import the subscription and choose a node. Address background operation only if it works with the screen on but disconnects after locking.

How to identify the installer

File or labelSuitable for Android
*.apkYes; continue by checking the version and CPU architecture
arm64-v8aMost recent 64-bit Android phones use this type
universalLarger, but easier when you are uncertain about the architecture
*.exe / *.dmg / *.debNot an Android installer

The official FlClash repository puts Android, Windows, macOS, and Linux builds on one Releases page. Confirm that the address belongs to chen08209/FlClash, then choose the APK for the current version. Files renamed on third-party drives cannot be matched to release notes and are unsuitable for diagnosing the app itself.

Before downloading, record the Android version under “Settings → About phone” and read the Release notes. If an older system shows “incompatible” or “there was a problem parsing the package,” verify the system version and APK architecture.

Asset names may change between versions, so do not treat a full filename from an old tutorial as a permanent rule. If you are unsure about the ABI, choose an officially provided universal build or verify it with a device-information tool.

Installing the APK triggers two distinct permission prompts

After the APK opens, Android asks separately for installation-source permission and VPN connection permission. You can revoke the first after use; grant the second only when FlClash actually starts its service.

Installation process

  1. Allow installation from this source

    When Android blocks the APK, temporarily grant installation permission only to the browser or file manager you are using.

  2. Finish installation and open it once

    Confirm that the FlClash home screen opens, then revoke the “Install unknown apps” permission.

  3. Start the service after importing a configuration

    Only then does the system show a VPN connection prompt; it is separate from permission to install the APK.

After the subscription name appears, update it, enable it, and choose a node

Paste the complete HTTPS address on the Profiles or subscriptions screen and save it. A name in the list means only that the client stored the link. The remote content has downloaded and parsed under the current core only after a manual update shows an update time, policy groups, and nodes.

Next, make this Profile current and pin one node in the primary selection group. For the first test, do not also enable overrides, automatic switching, and custom DNS. If the browser fails, you can then inspect the domain, rule, and outbound route directly on the connections screen.

One complete import

  1. Save the link

    Give the subscription a local name that identifies its source without exposing the token in the URL.

  2. Update manually

    Record the HTTP status, update time, and first parsing error.

  3. Set it as the current Profile

    Before returning to the home screen, confirm that the current configuration name changed.

  4. Pin a node and start

    Accept the Android VPN request, then open one direct-access site and one target site.

Official FlClash Android interface, with four bottom tabs for dashboard, proxies, configurations, and tools
FlClash places the configuration entry in the bottom navigation. After importing, return to the dashboard and confirm the core, outbound mode, and connection status.View the official animated preview

Treat installation failure, subscription failure, and connection failure separately

If it still does not work at this point, inspect the first explicit on-screen error. The step where it appears tells you whether to return to the installer, subscription, or connection settings instead of trying every toggle again.

There was a problem parsing the package / This app is incompatible with your device

Recheck the Android version, ABI, and whether the APK downloaded completely; do not change the subscription or DNS.

App not installed

Determine whether the old version came from a different signing source. Back up its configuration before deciding whether to uninstall the conflicting version; do not overwrite it directly.

Update reports 401 / 403

The link credential is invalid or access is denied; return to the provider panel and obtain the address again.

Invalid YAML / unsupported type

The content downloaded, but its format or proxy type is not accepted by the current Mihomo version.

Nodes exist, but every App loses connectivity after startup

Stop the FlClash service first to restore networking, then inspect the selected node, DNS, and first connection error.

The browser works, but one App does not

Find that process's requests on the connections screen. If no request appears, then consider TUN capture or the app's own proxy settings.

Only adjust battery policy if it works with the screen on but disconnects after locking

Lock the phone for five to ten minutes, then inspect the foreground notification and system VPN icon. If both disappear and connectivity returns immediately after reopening FlClash, the system likely suspended the background process; the subscription did not coincidentally fail while the screen was locked.

Menu labels vary by system version and vendor skin. Common paths include “App info → Battery” or “Battery → App battery management.” Set FlClash to unrestricted and allow background activity and background data. Xiaomi, OPPO, vivo, and other systems may also provide separate autostart or background-launch restrictions. Enable only settings that actually exist; do not copy every step from another brand.

Symptom and setting to inspect

SymptomCheck first
VPN icon disappears after the screen locksBattery optimization, background activity, and autostart
VPN icon remains, but web pages time outNode, DNS, rules, and connection logs
Connection does not recover after switching from Wi-Fi to mobile dataAndroid VPN reconnection and always-on VPN settings
FlClash closes automatically when another VPN startsAndroid can maintain only one system VPN at a time

Perform four actions after restarting the phone

Finally, restart the phone once. This is not a hopeful guess; it confirms that the Profile, VPN authorization, and background policy survive the next boot.

Delivery checklist

  • Open FlClash; the current Profile and policy-group selection still exist
  • After starting the service, the system VPN icon appears and the connections screen shows the test domain
  • The foreground notification remains after ten minutes with the screen locked, and reopening a web page does not require restarting the app
  • You can disconnect manually from the system VPN screen, and normal networking returns immediately after closing FlClash

References