Troubleshooting hub

FlClash Troubleshooting

When something breaks in FlClash, identify the symptom first, then narrow down layer by layer. Each page below gives a checking order instead of a single guess.

FlClash guide Last checked: 2026-06-01 GitHub Releases

FlClash guide

This site organizes FlClash download, setup, configuration, and troubleshooting information by platform.

Pick your symptom

NetworkConnected but no internet

Work through node, proxy mode, system proxy, and browser layers.

SubscriptionSubscription import fails

Isolate URL, network, format, and version compatibility issues.

macOSmacOS blocks the app

Understand macOS security prompts and what must be verified.

General checking order

Confirm FlClash is connected to a usable node.
Make sure proxy mode is not Direct.
Verify the system proxy state.
Separate global issues from single-app issues.
Record changes so you can roll back.

References

GitHub repository: github.com/chen08209/FlClash
Release page: GitHub Releases
Latest release: GitHub latest release
License: GPL-3.0 license