REV. v2.0.4 · 2026-07-17
CLASH FAQ · FREQUENTLY ASKED QUESTIONS
Don't panic — the answer is probably already here.
This is clashoffice.com/en/faq.html: a collection of 26 common questions covering what Clash is, whether this site is official, install/download errors, subscriptions and nodes, privacy & security, and troubleshooting. Jump to a category below, or use your browser's in-page search (Ctrl/Cmd + F) to find a keyword directly.
- PROJECT
- Clash FAQ
- DWG NO.
- CLSH-2026-05
- TOTAL QUESTIONS
- 26
- SECTIONS
- 6
- SITE
- clashoffice.com
A
ABOUT · About Clash & This Site
What Exactly Is Clash, and Who Is clashoffice.com
A1What is Clash? Is it the same thing as a VPN or a paid proxy service?
Clash is an open-source, rule-based proxy forwarding framework, and its core job is to decide, based on rules you configure, whether each network request goes direct, through the proxy, or gets rejected. It doesn't provide nodes itself — you need to bring your own. This is different from a traditional VPN, which routes your entire device's traffic through one tunnel, and it's a completely different thing from a dedicated "node reseller" service — Clash is simply the tool that schedules traffic according to rules.
A2Is clashoffice.com the official website?
Yes. clashoffice.com is the official release and documentation site for the Clash project. The installers, tutorials, and FAQ shown on this page are all maintained and published directly by us, without going through any third-party relay or proxy.
A3Do I need to pay to use Clash?
The Clash software itself is completely free and open source, released under the GPL-3.0 license, and neither the installer downloads nor the tutorial content on this site come with any charge. If you need proxy nodes, that service is usually provided and billed separately by a third-party provider — unrelated to the Clash software itself.
A4What operating systems does Clash support?
Official releases currently exist for four platforms: Windows, macOS, Linux, and Android. The iOS client is under App Store review, and we plan to distribute it via the App Store and TestFlight — progress will be updated on the download page.
A5Is Clash Open Source? Can I Modify It Myself?
Yes, Clash is released as open source under the GPL-3.0 license, and the code is public and auditable. GPL-3.0 lets you freely use, modify, and distribute it, but if you distribute a modified version, it must also be open-sourced under GPL-3.0, keeping the original author's copyright notice intact.
B
DOWNLOAD · Download & Installation
Common Pitfalls in Downloading and Installing
B1Where can I download the latest version?
Go to thedownload page, and pick the installer for your operating system. This page is kept up to date as new versions are released.
B2Windows Says "Unknown Publisher" or Flags It as Malware — What Should I Do?
This is a common false positive from Windows SmartScreen for smaller open-source software, and doesn't mean the file is actually a problem. Click "More info" → "Run anyway" in the prompt to continue installing. If your antivirus software quarantines the file directly, add it to your trusted list and reinstall.
B3macOS Says "Can't Be Opened Because It's From an Unidentified Developer" — What Now?
This is the default restriction from macOS Gatekeeper for apps not signed and distributed through the App Store. Go to "System Settings → Privacy & Security," scroll down to find the notice about the blocked app, and click "Open Anyway."
B4When Will the iOS Client Be Released?
The iOS client is currently under App Store review, with no confirmed release date yet. Because iOS restricts third-party apps from being distributed outside the App Store, please don't trust any site claiming to offer an "unlisted iOS installer" — such sites have nothing to do with clashoffice.com.
C
USAGE · Usage & Configuration
How to Adjust Modes, Rules, and Config
C1What's a subscription link, and where do I get one?
A subscription link is a URL provided by your node provider; your client visits it periodically to automatically pull the latest node list and base rules. clashoffice.com doesn't provide nodes or subscription services — you'll need to choose a compliant node provider yourself to get a subscription link.
C2How do I choose between Rule mode, Global mode, and Direct mode?
For everyday use, Rule mode is recommended, routing automatically based on your config. Global mode is good for temporarily testing whether a node works, or checking if a rule missed some traffic. Direct mode is useful when troubleshooting to confirm whether an issue lies with the proxy itself. All three can be switched at any time without conflict.
C3Why Can't I Access Certain Sites Even With the Proxy Enabled?
This usually means a rule matched
DIRECT. Check the policy for that domain or IP range in the rules field of your config file — if it really should be proxied, point that rule to a proxy group instead. You can also temporarily switch to Global mode to check whether it's a rules issue.C4What's the Difference Between TUN Mode and System Proxy, and Which Should I Use?
System proxy only takes over apps that read the system proxy settings (like browsers) — simple to set up, low overhead. TUN mode takes over all traffic at the network adapter layer, covering games, CLI tools, and other apps that don't read system proxy settings, but requires higher system permissions. For everyday web browsing, system proxy is enough.
C5How Do I Modify or Customize Rules?
Just edit the
rules field in your config file. Each rule follows the format type,match content,target policy, for example DOMAIN-SUFFIX,example.com,DIRECT. Rules are matched top to bottom, stopping at the first hit, so earlier rules take priority — put your most common and most precise rules first. For the full field structure, see the config file explanation on the tutorial page.
D
NODES · Nodes & Subscriptions
Where Nodes Come From, and How to Maintain Your Subscription
D1Does clashoffice.com Provide Nodes or Subscription Services?
No. This site only publishes the Clash software itself, installers, and documentation. Proxy services like nodes and subscription links need to be sourced from a compliant third-party provider of your own choosing — they have no affiliation with this site.
D2High Latency or Frequent Disconnects on a Node — What Should I Do?
First run a latency test on the current node in the node list. If latency is consistently high or it disconnects frequently, it's usually an issue with the node itself or the selected proxy group — try switching to another node in the group, or report the connection quality to your node provider.
D3How Often Does a Subscription Link Need Updating?
The update frequency of the subscription content (node list) is set by your node provider. Most clients support setting an auto-update interval — we recommend enabling it so you don't forget to refresh after nodes expire.
D4Can One Subscription Be Used on Multiple Devices?
That depends on your node provider's specific terms (some providers limit the number of simultaneous connected devices or concurrent connections). The Clash client itself has no such restriction — check your subscription provider's terms for specifics.
E
PRIVACY · Privacy & Security
Where Your Data Goes, and How Safe It Is to Use
E1Does Clash log my browsing history?
The Clash core only processes and forwards traffic locally — it never uploads your browsing content to any official server. Connection logs visible in the dashboard are also stored locally only, for local debugging and troubleshooting, and are never sent anywhere.
E2Is it legal to use Clash?
Clash is a general-purpose network proxy tool, and the software itself is not illegal. Whether using a proxy service is compliant depends on the laws and regulations of your region — please understand and follow local rules, and never use it for anything unlawful.
E3Does the Core Upload My Data to an Official Server?
No. The Clash core is open-source software with publicly auditable code, and there's no built-in logic to upload user data to any "official server." The only network access it makes is the subscription update you configured yourself, and the proxy nodes you chose.
E4How Do I Reduce Logging or Resource Usage?
In your config file, set the log level
log-level to warning or error to reduce unnecessary logging. Also avoid frequent manual speed tests and prioritize low-latency, stable nodes — this noticeably reduces background resource usage, which especially helps mobile devices save battery.
F
TROUBLESHOOT · Troubleshooting
What to Do When Startup Fails or Configs Don't Apply
F1The Client Crashes Right After Launching — What Should I Do?
First try re-downloading the installer, to rule out a corrupted file. Then check whether an old version left behind an incompatible config file format — you can back it up, clear the config directory, and re-import your subscription. If it's still not working, check the client's built-in log window for the specific error.
F2Changed the Config, But It's Not Taking Effect?
Most clients require you to click "Reload Config" or restart the core for changes to take effect — directly editing the file doesn't get picked up automatically. Also check that your YAML indentation is correct, since a formatting error will cause the config to fail loading and silently fall back to the old one.
F3No Internet Access at All After Enabling the Proxy?
First confirm the node actually works (you can test node latency in the dashboard). If the node is fine but you still can't get online, it's usually a conflict between the system proxy / TUN mode and another network tool (another VPN, firewall software, etc.) — try disabling other proxy-related tools and try again.
F4How Do I Completely Uninstall Clash?
After removing the client itself through your system's usual uninstall process, you'll also need to manually delete the config directory (usually in a hidden folder under your user directory) to fully clear node info and local logs and avoid leaving sensitive config files behind.
F5Noticeable Battery Drain or Heat on Android / iOS?
Prioritize low-latency, stable nodes and avoid frequent auto-speed-testing; also lower the log level to
warning or error to noticeably reduce background resource usage.F6Still Haven't Solved Your Problem? Where Else Can I Look?
You can head to thetutorial pagefor a systematic look at Clash's core concepts and how it works, or check out theBlogfor more specific configuration articles — both are kept continuously up to date.
Couldn't find the answer you needed?
Check out the more comprehensive tutorial page, or head to the download page to confirm installer details — most issues can be traced back to one of these two places.