Drawing No. RUMEN-01 · Kickoff Sheet · Scale 1:1

Clash Starter Guide Client Downloads · Setup from Scratch · Rule-Based Routing

This site organizes Clash setup like a construction blueprint: start with the installers for all five platforms, follow the step-by-step diagrams for subscription import and system proxy setup, then use the rule-based routing section to configure local direct connections and overseas proxying in one pass. Every step is indexed, sourced, and verifiable.

Detail A-02

Core Capabilities, Panel by Panel

The left side lists the detail contents, the right shows the matching panel. Each panel explains what the capability solves, how to enable it, how it differs from similar approaches, and includes essential config snippets where needed.

F-01 · Rule-Based Routing Engine

Route every connection by domain and IP region

Rule-based routing is what sets Clash apart from blanket "global proxy" tools: as each connection is established, the engine matches the rule list top to bottom, using rule types like DOMAIN-SUFFIX, GEOIP, and RULE-SET to decide whether it goes direct, through the proxy, or gets blocked. Local sites stay on direct connections for native speed and login behavior, sites outside your region route through the proxy as needed, and ad domains get cut off outright — all three outcomes are configured once and keep working, with no manual toggling required. The rule list is plain text you can read and edit; match order follows write order, with a catch-all MATCH line at the end, so behavior is always predictable.

rules:
  - DOMAIN-SUFFIX,openai.com,PROXY
  - GEOIP,CN,DIRECT
  - MATCH,PROXY
Detail A-03

Three-Step Setup Preview

The full walkthrough lives on the getting started guide; here's just the three main steps, each mapped to a section in the tutorial.

  1. 01

    Install the Client

    Pick your platform on the downloads page and install the matching client. Windows and macOS users follow the setup wizard; Android requires granting VpnService permission on first launch.

  2. 02

    Import a Subscription

    Copy the subscription link from your provider, paste it into the client's "Profiles" page, and once the node list loads, pick an exit node in the policy group.

  3. 03

    Enable Proxy & Verify

    Turn on the system proxy toggle, switch to rule mode, and visit a site outside your region to confirm it connects; if not, work through the troubleshooting table at the end of the tutorial.

Detail A-04

Project Background & Update Process

For a tool you'll rely on long-term, how well-maintained the project is matters more than how it looks. Here are four facts you can verify directly in the public repositories.

B-01Project History

The original Clash core went open source in 2018, establishing the basic shape of YAML config, policy groups, and rule-based routing. After the original repo was archived, the community fork Clash.Meta picked up development and was renamed mihomo, adding broader protocol support and more rule types — it's now the de facto standard core. This site's tutorials and handbook are all based on mihomo's behavior.

B-02Ecosystem Roles

The core handles protocol implementation and rule matching; GUI clients handle the interface, subscription management, and system integration — the two evolve independently. Clients like Clash Verge Rev and FlClash bundle the mihomo core and update it alongside their own releases, so users never manage the core file separately; servers and routers, meanwhile, run the core binary directly against the same config file.

B-03Update Process

Active clients publish official releases on open-source platforms, with changelogs published in full. The download links on this site's downloads page point to each project's current release, and version info refreshes automatically as new releases go out; clients that are no longer maintained (Clash for Windows, ClashX Meta) are kept archived and clearly labeled — they're not recommended for new installs.

B-04Auditable Code

The full source of the core and mainstream clients is publicly hosted — protocol implementation, DNS handling, and rule-matching logic can all be read line by line, or built from source yourself. If you want to inspect the core implementation, use the command below to clone the mihomo core source repository:

git clone https://github.com/MetaCubeX/mihomo.git
Detail A-05

Frequently Asked Questions

The four questions asked most before getting started — the full categorized Q&A lives on the FAQ page.

Clash is running but the browser still won't load anything — where do I check first?

Check three things in order: whether the client's system proxy toggle is switched on; whether the current policy group has a working node selected (run a latency test — a timeout means that node is down); and whether a proxy extension in your browser is conflicting with Clash. If all three check out and it's still not working, see the full troubleshooting table under the Troubleshooting category on the FAQ page.

System proxy mode vs. TUN mode — which should I use day to day?

System proxy mode is fine for everyday browsing — lightweight and driver-free. Only turn on TUN mode when a CLI tool, game, or some other app that ignores system proxy settings needs to be routed through the proxy at the network level. See core capability detail F-03 and the corresponding handbook chapter for the full comparison.

What's the difference between Rule mode, Global mode, and Direct mode?

Rule mode routes each connection based on the rule list, and is the recommended default; Global mode ignores the rules and routes all traffic through the currently selected node — use it only for temporary troubleshooting; Direct mode sends all traffic straight through without the proxy. Stick with rule mode day to day; the routing logic lives in the rules section of the config file.

Can I use Clash without a subscription link?

Yes. A subscription is just a convenient way to load nodes in bulk — the client also supports writing node parameters directly into the config file (server address, port, protocol, password, and other fields). Field syntax is covered in the proxy nodes chapter of the Config Handbook; for local rule testing only, you can even run with just a DIRECT outbound.

Detail A-06

Latest Technical Write-Ups

Long-form pieces on troubleshooting, advanced config, and ecosystem choices, newest first — the three most recent are listed here.