Windows 10/11 · mihomo core

Clashfor Windows

Start by installing Clash Verge Rev, then learn about the system proxy and mihomo routing rules. Adjust subscriptions, DNS, and YAML configuration as needed.

  • Free forever
  • Open-source code
  • Configuration guides

Configure
Windows proxy

System settings only determine where traffic enters. The client and core handle subscriptions, routing, and DNS resolution.

  • A correct address doesn’t guarantee apps will use the proxy

    The Windows system proxy isn’t a universal switch. Some command-line tools, games, and apps with their own network stacks ignore it. Configure those apps separately or consider TUN mode.

  • Settings can linger after switching environments

    If the proxy address isn’t restored before the client closes, your browser may keep trying to connect to a local port that’s no longer listening. When troubleshooting, distinguish network issues from a stopped local listener before considering a Windows reinstall.

  • Edit the subscription directly, and updates overwrite your changes

    When a remote configuration is downloaded again, locally added rules may disappear. Repeated edits are hard to track and can easily break YAML indentation or policy group names.

Client-managed
configuration & routing

  • Keep traffic entry methods distinct

    Manage the system proxy and TUN separately in Settings. Start with the system proxy to verify basic connectivity, then enable the virtual adapter if you need to cover more apps. Avoid changing too many variables at once.

  • Manage rules and policy groups in one place

    Rule mode checks domains, addresses, or rule sets in order; policy groups determine the outbound route for a match. Use the Connections page and logs to confirm the actual route instead of relying on a toggle’s status.

  • Keep local changes separate

    Use the client’s override or merge features to save custom fields. Let the subscription provide the base configuration and the local layer add rules. After an update, check which settings are actually in effect.

# Example configuration structure; no proxy nodes included
mixed-port: 7897
mode: rule
proxy-groups:
  - name: Default
    type: select
    proxies:
      - DIRECT
rules:
  - MATCH,Default
View the YAML field reference →
Browse by use case

mihomo core & client settings

First identify how traffic enters, then decide which rules to match. These snippets explain individual fields; they aren’t complete subscriptions.

Rules match in order; policy groups choose the outbound route

Rule mode doesn’t send every connection through the same route. mihomo checks rules from top to bottom and sends traffic to the corresponding policy group when a rule matches. Put specific domains before broader rules, and leave the catch-all rule at the end. The client can show policy groups and let you switch options, but it won’t fix an incorrect rule order. If a site takes an unexpected route, check the matched rule in the connection details, then make sure the policy group name matches the configuration. Unlike changing only the system proxy, rule-based routing lets you define exactly what should bypass the proxy on your LAN and how other traffic is handled.

rules:
  - DOMAIN-SUFFIX,example.com,DIRECT
  - IP-CIDR,192.168.0.0/16,DIRECT,no-resolve
  - MATCH,Default
Explore rule syntax →

Choose a Clash client for your device

Desktop and mobile clients handle traffic differently. Choose your operating system first, then compare clients, processor architecture, and installation options.

Windows

The download page lists options such as Clash Plus and Clash Verge Rev. Before getting started, check the Windows requirements, import your configuration, and enable the system proxy. Set up service permissions for TUN only if you need it; there’s no need to enable every feature during installation.

Go to downloads

macOS

Choose the right installer for your Apple Silicon or Intel processor. Configure network extensions, the system proxy, and background permissions as prompted by the client. If you’re looking for a ClashX Meta download, compare maintenance status before deciding whether to use an archived client.

Go to downloads

Android

Compare clients such as Clash Plus, Clash Meta for Android, and FlClash. Mobile clients typically use the system VPN permission to route traffic. Check that no other VPN is running, and note that background battery restrictions can interrupt long-running connections.

Go to downloads

iOS

The Clash iOS client page links to Clash Plus on the App Store and lists the official site, clashplus.io. After importing a configuration, grant network access when prompted by iOS. Don’t assume desktop scripts or platform-specific fields will work the same way on a phone.

Go to downloads

Linux

For desktop use, start with Clash Verge Rev or FlClash and choose a package for your Linux distribution. Server and router users should consult the core guides and plan service startup, listening addresses, and permissions separately. Don’t expose a local proxy port directly to the public internet.

Go to downloads

Before migrating from Clash for Windows, keep a copy of your old configuration and rules. Then verify subscription parsing, policy group selection, and system proxy restoration in the new client. The same configuration file extension doesn’t mean different cores support exactly the same fields. For help choosing, read the client comparison, then return to the download page to pick an installer.

View all clients →
Open-source projects & configuration sources

Clients, cores & maintenance boundaries

Understanding what each layer does is more useful for troubleshooting than focusing on a single toggle. This site curates download links and configuration guides; software behavior depends on the project implementation and your actual configuration.

Clients and cores in the Clash ecosystem

Graphical clients in the Clash ecosystem typically handle the window, tray menu, subscription storage, and system integration. The core handles proxy protocols, rule matching, and DNS resolution. mihomo continues the technical direction of Clash Meta and supports its corresponding configuration features. Clash Verge Rev is one client that uses mihomo; not every feature in its interface is a core configuration field. For example, launch at startup depends on the client and operating system working together. Copying generic YAML can’t guarantee it will work on every system.

Open-source code provides a basis for tracing behavior

To verify how something works, start with the project documentation, release notes, and issue tracker, then look at the source code. The mihomo public repository is under the MetaCubeX organization and is useful for checking supported fields, protocol handling, and known issues. Star counts and download numbers aren’t substitutes for technical evaluation; even accurate figures can’t tell you whether a setting suits your network. When reporting a problem, include your operating system, steps to reproduce it, and redacted logs so others can reproduce what you’re seeing.

Check compatibility before updating

The graphical interface and core may update separately. If your configuration breaks after a client update, check the logs for the field or line number, then consult the documentation for the corresponding core. Don’t migrate every old script, DNS setting, and override at once. Get the base subscription working first, then restore local changes one at a time and verify after each change. This makes it easier to pinpoint whether a problem comes from the subscription, merge order, or network environment.

Configuration sources & scope of use

A client is a tool for managing configuration and connections, not a network service. You choose and manage your own nodes, subscription URLs, and access permissions; this site doesn’t provide subscription accounts. Before downloading, distinguish software sources from subscription sources. Before changing a listening address, understand who will be able to connect. Follow the laws where you live and the rules of the networks you use. For work devices or shared networks, get the required authorization before changing system proxy, virtual adapter, or routing settings.

Client selection & troubleshooting notes

Find steps for issues ranging from subscription formats to migrating from older clients. Keep a working configuration, then track down changes one at a time.

Download client