Quick start
Zero to traffic
Four steps, an import-link builder, and answers to the questions that most often end in “oh, that's what it was”.
No accounts. Just your link.
Install the client
Grab the package for your system on the downloads page. Android — APK, Windows — installer or portable ZIP, macOS — DMG, Linux — AppImage, DEB or RPM.
Check the SHA256 from the release. It takes thirty seconds.
Add a subscription
“Profiles” → “Add” → paste the subscription URL from your provider. ReClash figures out the format itself when the server varies its answer by User-Agent.
ReClash does not sell access and does not issue subscriptions. You bring your own link.
Pick a node and a mode
On the “Proxies” page pick a group and a node. Run the latency test — it is more honest than a country flag.
The routing mode is switched on the dashboard. Auto is the default: rules plus smart routing, which keeps a working node for the current network on its own. Rule is the same without the auto-pick. Global sends everything down the tunnel. Direct switches the tunnel off while the client stays up.
Connect
TUN/VPN intercepts traffic at the network layer — it covers everything, including apps that ignore the system proxy. System proxy is simpler and needs no privileges, but not every program obeys it.
If your ISP throttles the handshake with DPI, switch the bypass on in settings; it is built in and needs no separate program.
One link — and the profile is in.
A provider does not need to explain where to paste a URL. Build the link here and put it behind a button in your dashboard.
reclash://install-config?url=https%3A%2F%2Fsub.example%2Flink%2Fabc123That is a sample. Paste your own link and we will build yours.
The link is not sent anywhere — it is assembled right in your browser.
| Scheme | What it does |
|---|---|
reclash://connect | start the tunnel and connect |
reclash://disconnect | stop the tunnel |
reclash://toggle | connect if stopped, disconnect if running |
reclash://open | bring the window to the front |
reclash://close | hide to tray, or exit when configured |
reclash://add/<url> | a subscription URL, added after confirmation |
reclash://import/<base64> | a base64-encoded config, imported as a profile |
reclash://install-config?url=<url> | the compat link Clash and FlClash buttons already use; an optional &name= sets the profile name |
add, import and install-config links carry access to your traffic. Only open the ones you trust.
Answered before you ask.
It is a client for the mihomo core: it takes your subscription, routes traffic by rules and can bypass DPI. It is not a VPN service: ReClash does not sell access, does not issue subscriptions and does not recommend providers. You bring your own server and link.
ReClash is a fork of FlClash. The main additions: smart routing that keeps a working node for the current network on its own, a much larger provider header set (theme, widgets, announcements, domain migration), a reworked dashboard with widgets, import from more formats (Amnezia among them), and a built-in DPI bypass. The routing core is the same — mihomo.
The project is not affiliated with FlClash, mihomo or FlClashX.
It is the “Auto” mode: the client picks a node that works on your current network and switches on its own when the network changes — without opening the window. Start from a region preset (Russia, Iran, China); strategy, checks and markers can be fine-tuned.
The plain modes are still there: “Auto” is the same rules plus an auto-pick you can switch off.
No. The DPI bypass works before the proxy: it fragments and disguises the start of the connection so the ISP's equipment cannot match it against a signature and cut it. The traffic still goes wherever you pointed it.
Sometimes the bypass alone is enough — when a site is blocked by SNI rather than by IP. Sometimes you need both, so that the connection to the proxy can be established at all.
TUN/VPN intercepts traffic at the network layer: it covers everything, including programs that know nothing about a system proxy. It needs privileges (administrator on desktop, the VPN permission on Android).
System proxy is simpler and needs no privileges, but only apps that respect OS settings will use it. Games, some messengers and many CLI tools will not.
On desktop, nothing: the client only reaches your subscription and, unless you turned the check off, the GitHub release list. Logs and connection statistics stay on the device for diagnostics — you can clear them at any time.
On Android the build includes crash analytics (Firebase Crashlytics). It is off by default; you can turn it on in settings, and the app tells you about it on first launch. When on, it sends device information and crash details — no personal data — and can be turned off in the same place.
It is a stable 16-character device hash the client can attach to the subscription request, so the provider can show you a readable list of your devices and your plan limit. Sharing it can be switched off in settings.
For providers: the details are on the documentation.
Most likely your provider sent a theme in the ReClash-Hex header alongside the profile. The theme belongs to the active profile: switch profiles and the old one returns. Provider styling can be turned off entirely in the theme settings.
Nothing in the client — just add headers to your subscription response. No SDK, no plugin, no agreement with us. Assemble them with the builder and paste the snippet into nginx, Caddy or your backend.
The minimum a user will notice: remaining traffic, the service name and a support link.
Not currently. The App Store does not admit clients of this kind without a separate developer programme, and sideloading on iOS is its own story. Promising a date would be dishonest.
In order:
- Refresh the profile — the subscription may have gone stale.
- Run the latency test: if every node is unreachable, the problem is between you and the provider, not in the rules.
- Switch to Global mode: if it starts working, the routing rules are the cause.
- Turn the DPI bypass on: your ISP may be cutting the handshake itself.
- Open “Logs”. It usually says so in plain words.
Still stuck — open an issue. And scrub the subscription URL out of the logs before you post them: it carries your credentials.
Before posting logs, remove the subscription URL from them — it carries your credentials.