Tutorials & Tips

Clash Tutorials Blog

In-depth analysis of Clash proxy configuration, covering subscription import, rule splitting, TUN global proxy, and more to help you master Clash features.

174 Tutorials in Total
Last updated: October 11, 2026
Tutorial

Lightweight mode does not replace the proxy core or switch to Direct mode. It closes the graphical main window while keeping the background app running. Open Dashboard from the tray when you need to view nodes or logs again. This guide covers entering and leaving that mode without confusing a missing window with an app exit.

Tutorial

A missing Logs entry does not necessarily mean FlClash is broken: turning off Logcat hides it. Enable capture in General settings under Tools, then return to the main navigation. This guide covers collecting a useful troubleshooting record and checking it before sharing.

Tutorial

To change the default target for node latency checks, open Miscellaneous in Settings and edit Default Latency Test. A proxy group’s own test address can take priority, however. This guide covers editing, checking, and restoring this setting without changing subscription rules or treating latency as download speed.

Tutorial

Before reorganizing your configuration or moving to another computer, export a local ZIP backup of FlClash data. Open Backup and restore on the Tools page, then use Backup in the Local section. This guide covers exporting, checking, and storing that file—not restoring data or overwriting your current configuration.

Configuration

If FlClash opens in English, you do not need a separate Chinese edition. Choose Simplified Chinese from the language setting on the Tools page. This guide covers that setting, the Default option, and how to switch back; it does not change subscriptions or proxy settings.

Tutorial

If you cannot find a tray speed switch, you may not have missed a setting. In Clash Verge Rev v2.5.7, that feature is limited to macOS. On Windows, open Traffic Stats on Home to see the current upload and download rates. This guide covers reading those figures and restoring a hidden card; no subscription changes or patches are needed.

Configuration

You do not need a skin download or custom CSS to make Clash Verge Rev dark. Select Dark under Theme Mode in Settings, or choose System if you want the app to follow Windows appearance. Here is how the three options differ, how to check your choice, and how to return to your previous theme.

Configuration

If you want to choose when to check for a new version, turn off Auto Check Update in Clash Verge Rev. You will find it in Miscellaneous, and you must save the change. It is separate from subscription updates and does not cancel a download already in progress or clear an update already downloaded.

Configuration

Chinese is already included in Clash Verge Rev; you do not need a separate language patch. Open Settings, find Language in the Verge Basic Setting group, and choose Simplified or Traditional Chinese. This guide covers the English menu labels, how to check the result, and how to return to your original language.

Configuration

If FlClash already works and you simply want it to open when you sign in to Windows, use its built-in Auto launch setting. You will find it under Application on the Tools page. Auto launch, Silent launch, and Auto run do different jobs; check those differences before testing a fresh sign-in.

Configuration

To keep one phone app outside Clash Meta for Android’s VPN, exclude it through access control. Choosing the right mode matters: the same checked list has opposite meanings in the two selection modes. This guide changes only app bypass settings, not subscriptions or node rules.

Configuration

Keep OpenClash working for the rest of your network while one TV or computer connects directly. This guide changes one device’s IPv4 blacklist entry, without editing subscriptions or switching the whole network to direct mode.

Configuration

If Clash Verge Rev already works when opened manually, its Auto Launch switch can save you opening it after each Windows sign-in. This guide covers that switch, Silent Start, verification and undoing the change—not a new proxy setup.

Tutorial

A useful support log covers the failure, not your entire configuration directory. Find the application and core logs, make private copies and redact sensitive values before sharing—without changing log levels or deleting evidence.

Tutorial

Before changing OpenClash, save its current configuration on your computer. This guide covers downloading and inspecting a full backup, how it differs from a single YAML file or a router system backup, and why a completed download is not a recovery guarantee.

Configuration

Make one website bypass the system proxy without switching the whole client to Direct mode. This guide covers the prerequisites for a first exception in v2.5.2 on Windows, hostname syntax, verification and restoring the default scope.

Tutorial

Use the official all-in-one Compose file to run the MetaCubeXD dashboard, control agent, and bundled Mihomo kernel as one service, while keeping its credentials, published ports, writable data, health status, and update boundary explicit.

Troubleshooting

Proxy-server hostnames and ordinary client destinations can take different resolution paths. Locate the failing path before changing bootstrap DNS, IPv6 upstreams, or interception rules.

Tutorial

The official Windows release provides an installer and a portable ZIP, but their prerequisites and system integration are not identical. This guide stays focused on choosing the package, launching it correctly, and changing package types safely.

Troubleshooting

The subscription button starts a chain rather than one operation, from an HTTP request through validation and file writing to core reload. This guide reads the OpenClash log by stage and preserves the last working profile instead of resetting the plugin first.

Configuration

An override stores a small custom patch separately from the downloaded subscription. This guide uses the current Clash Party name while acknowledging the former Mihomo Party wording, and focuses only on YAML import, binding, merge behavior, verification, and rollback.

Troubleshooting

Service Mode gives the Mihomo core the elevated context needed for TUN without requiring the full interface to run as administrator every time. This guide checks package origin, elevation, stale service state, and security events before testing the smallest working path.

Guide

FlClash publishes both a Windows setup program and a ZIP package. This guide focuses on choosing between those two builds, launching each one correctly, and changing versions without casually overwriting working data.

Troubleshooting

An unmarshal error is not synonymous with bad indentation. This guide separates YAML grammar from the Mihomo configuration schema, uses the first line reference to bound the fault, and verifies one reversible correction at a time.

Guide

When a project name and its packaged asset names transition at different speeds, users can mistake one release for two products. This guide anchors identity in the official repository and release, then protects existing data through a reversible upgrade.

Troubleshooting

A core update is a pipeline, not one operation. This guide follows the project script through metadata lookup, download, archive testing, architecture selection, executable validation, replacement, and service verification so each failure has a bounded next step.

Tutorial

A reliable migration starts by opening the directory the running client actually uses, not by copying one guessed YAML file. This guide maps the data set, combines built-in exports with a quiet filesystem snapshot, and verifies recovery before the original is removed.

Tutorial

This guide uses the complete installer and Windows archive from the community 0.20.39.3 Release. It verifies the unofficial source, protects configuration, applies one package format, and keeps deprecated resource-replacement methods outside the workflow.

Tutorial

Clash and VPN apps can both route internet traffic, but they are not the same kind of product. This guide breaks down the ecosystem in plain English, compares the main options, and gives first-time users a safer path for choosing a client, subscription, and trustworthy source.

Configuration

This practical walkthrough shows Windows users where to find TUN settings in Clash Verge Rev and which options to check before turning the mode on. Follow the steps to create a working system-wide tunnel, then verify routing and troubleshoot the most common permission or adapter conflicts.

Configuration

Amazon and Shopify sellers cannot afford random login failures, slow dashboards, or unstable access while traveling. This guide maps Clash settings to real ecommerce tasks, showing how to route store management, research, advertising, and ordinary browsing separately while keeping a dependable backup plan.

An airport subscription is only useful after its profile is added correctly. This guide walks through importing a subscription URL into Clash, updating node lists, checking compatibility, managing several providers, and reducing security risks.

Configuration

Learn how to make Mihomo select a healthier proxy when latency rises or a node stops responding. You will create practical API scripts, secure the controller endpoint, schedule recurring checks, and troubleshoot switching behavior through logs and HTTP responses.

Configuration

Follow a clear Windows walkthrough for turning on TUN mode in Clash Verge Rev. You will configure the required permissions, confirm that the virtual adapter is active, test traffic capture, and restore normal routing if a conflict occurs.

Configuration

When Git, package managers, or Docker fail mid-task, switching browser proxy settings is not enough. Learn how developers can route terminal traffic through Clash TUN mode, apply targeted rules to engineering tools, and keep repositories, dependencies, and container images accessible.

Tutorial

Researchers often switch between scholarly databases, reference managers, and collaborative writing tools in a single session. Learn how to route research traffic through Clash while keeping local services direct for a cleaner, more dependable academic workflow.

Tutorial

A focused Clash setup can keep Notion, Figma, and Miro responsive while local websites stay on a direct route. Learn how to build app and domain rules, select suitable nodes, and tune TUN and DNS settings for smoother remote collaboration on desktop and shared devices.

Configuration

A beginner-friendly Windows 11 guide to enabling TUN mode in Clash Meta, checking administrator permissions and the virtual network adapter, then verifying proxy and DNS routing without confusing it with the normal system proxy switch.

Troubleshooting

Google Gemini CLI is a free terminal AI agent that exploded in 2026, but OAuth login, API key checks, and model calls often time out while websites load fine. The gap is routing: shells ignore system proxy, GEOIP shortcuts steal first-match wins, and npm install traffic uses different hosts than generativelanguage.googleapis.com. This guide maps Gemini CLI into explicit Clash lanes and shows how to verify each hop without blindly enabling global tunnel mode.

Tutorial

OpenAI GPT-Realtime-2 and the Realtime API keep a long-lived WebSocket open on api.openai.com while streaming audio in both directions. Handshake failures, mid-session drops, and jittery latency often trace to Mihomo rule order, DNS that bypasses fake-ip, or SDK runtimes that ignore system proxy hints. This guide maps Realtime endpoints, compares TUN versus mixed-port capture, walks an OPENAI_REALTIME lane, and ties verification to live connection logs.

Tutorial

Agent Toolkit fans out across MCP endpoints on api.aws, IAM-controlled regional APIs, STS credential hops, IDE toolkit manifests on idetoolkits.*, and optional Amazon Q language-server paths—not one tidy hostname list. When AI coding agents stall inside Cursor or VS Code, the durable fix is Mihomo-first rule order, resolver alignment, and log-backed DOMAIN rows that leave domestic defaults untouched.

Tutorial

Claude workloads on AWS in 2026 still split across console sign-in, STS credential hops, regional Bedrock inference hostnames under amazonaws.com, and sometimes direct Anthropic API calls. Separate Mihomo lanes with explicit DOMAIN rows above blunt GEOIP, align DNS fake-ip with SDK capture, validate each hop via connection logs, then retry the smallest failing console or Invoke action instead of swapping nodes blindly.

Tutorial

When ChatGPT quietly defaults conversations through GPT-5.5 Instant but only web, plugins, or the OpenAI API feel laggy or time out, the culprit is often routing: carve ChatGPT plus OpenAI hostnames into Mihomo-era proxy-groups ordered ahead of GEOIP, align DNS fake-ip capture, tighten node selection for long SSE streams versus REST calls, and verify first-match hits from Mihomo logs rather than blaming the rollout headline.

Tutorial

When Gemini Enterprise consoles feel fine yet Agent Builder or Vertex-backed Gemini APIs swing between 200-series success and stalled SDK calls, routing—not model quality—is often the bottleneck. Here is how to carve a repeatable Google Cloud policy lane in Mihomo-era Clash: OAuth alignment, narrowed googleapis inventories, disciplined rule order and DNS coupling that survives enterprise SSO—not a rebranded ChatGPT cookbook.

Installation Guide

Windows Server 2022 is not the same SKU as desktop Windows 11 for tray GUIs: default firewall baselines, IE Enhanced Security Configuration, Defender SmartScreen, and RDS quirks all matter before the first Mihomo-compatible Clash subscription import. This playbook walks Administrators from official GitHub Releases through firewall decisions to a validated system-proxy or TUN check.

Advanced Config

Readers learn how Mihomo-backed Clash Verge Rev builds ordered failover strips on Windows 11 via fallback policy groups: why health-check strategy URLs trump guesswork, how intervals pace reconnect drama, YAML ordering that determines which proxies get skipped automatically, pragmatic validation when latency colors lie, plus how differs from latency-first url-test groups you may already tune elsewhere.

Tutorial

Codex desktop builds and Codex MCP plugins do not speak to a single pretty hostname. Model calls, platform metadata, CDN assets, attachment buckets, and auth hops spread across official OpenAI edges—then third-party MCP bridges add their own. When tool invocations stall while browsing looks fine, the usual culprits are first-match rule order, DNS that bypasses Mihomo, and IDE outbound stacks that ignore polite system proxy hints. This tutorial names the OpenAI-shaped surfaces, walks a concrete OPENAI_API lane in Clash Verge, and ties verification to live connection logs.

Tutorial

AWS MCP Server inside Cursor or VS Code fans out to STS, IAM, partition-specific APIs, console sign-in, and sometimes corporate IdPs—not a single chat domain. When connections flap or hang, the fix is usually Clash rule order, DNS that actually passes through Mihomo, and capture depth that matches the IDE host. This hands-on guide walks the AWS-shaped split path without hiding behind generic MCP labels.

Tutorial

Claude Code lives in your shell, not in a browser tab. When model calls, login, or self-updates stall while websites load fine, the culprit is usually routing: GEOIP direct rules, DNS that bypasses Clash, or a CLI stack that ignores system proxy. This guide maps Anthropic API traffic and typical dependency lanes into explicit Clash rules, then shows how to verify each hop without blindly flipping to global tunnel mode.

Troubleshooting

Git operations and GitHub Actions steps time out when only part of the GitHub edge fleet rides a healthy path. Put github.com, API, and raw.githubusercontent.com traffic into a dedicated Clash group ordered above GEOIP. Match TUN or proxy env to the shell or self-hosted runner actually running git. Confirm rule hits in Mihomo before swapping nodes.

Installation Guide

Arch Linux and Manjaro users converge on the AUR for a maintained Clash Verge Rev build, but the first hour still mixes vocabulary—PKGBUILD review, Mihomo profiles, Polkit prompts, and session autostart. This guide walks from empty system to working subscription import and a systemd user unit that survives reboot, without conflating legacy clash-verge-bin packages with the Rev line.

Router Tutorial

Your router already runs OpenClash; this guide stays inside LuCI for the tasks you repeat every week—pull fresh subscription data, adjust proxy groups without guessing YAML paths, switch outbound nodes for policy chains you actually use, and read logs or live connections so you can tell traffic is flowing through the path you expect. It is not a reinstall walkthrough or a mesh networking blueprint.

Troubleshooting

<strong>npm</strong>, <strong>pnpm</strong>, and <strong>yarn</strong> behind restricted networks often mix fast <strong>registry.npmjs.org</strong> probes with stalled <strong>tarball HTTPS</strong> GETs ending in <strong>ETIMEDOUT</strong>: fence npmjs-shaped hosts ahead of GEOIP; keep competent domestic mirrors DIRECT; tune TUN, DNS fake-ip alignment, Mihomo logs, and concurrency before blindly rotating nodes.

Troubleshooting

Q2 stocking and ads: Temu and Shein seller backstage—onboarding, tickets, Ads console—timeouts while Slack works behind Clash: log-first DOMAIN-SUFFIX above GEOIP, MARKETPLACE_SELLER vs CDN groups, DNS fake-ip and TUN, gsp-style edges mis-routed DIRECT or wrong node before 618—cross-border sellers, not Prime Video or Netflix hostname dumps.

Troubleshooting

Discord Windows client update stuck at 0% or voice drops behind Clash: TUN capture versus browser-only proxy, DNS fake-ip alignment, log-first DOMAIN-SUFFIX for discord.com and discord.media-shaped CDN before GEOIP, DISCORD_APP versus DISCORD_MEDIA groups, UDP RTP WebRTC path and NAT—methodology like Epic or Steam launcher guides with Discord host evidence, not recycled steampowered lists.

Troubleshooting

Prime Video region banners or stuck playback behind Clash while generic proxy works: log-first DOMAIN-SUFFIX for primevideo.com and recurring aiv-* style Amazon Video edges before GEOIP, dedicated PRIME_MEDIA proxy-groups versus retail amazon.com splits, DNS fake-ip aligned with Mihomo—not Netflix nflx-, Disney+ BamGrid-, Max Warner-, or YouTube googlevideo-only lists.

Troubleshooting

Mainland portals slow through proxy despite GEOIP snippets: greedy DOMAIN-KEYWORD or RULE-SET rows before GEOIP cn DIRECT, MATCH miswired to flaky groups, DNS fake-ip vs resolver fallback bypassing Mihomo—not Sniffer-first streaming tweaks; first-match reordering, GEOIP positioning, RULE-PROVIDER merge audits, QUIC and IPv6 edge cases versus browser-only TUN guide.

Troubleshooting

Epic Games Launcher weekly free claims or 0 B/s downloads while browsers work through Clash: DOMAIN-SUFFIX epicgames.com-shaped hosts ahead of GEOIP, Epic Web vs CDN proxy-groups, DNS fake-ip and TUN—not Steam steampowered lists; EOS login helpers, sale peaks, Sniffer for IP-only shards, subscription provider order, checklist—distinct Valve Steam UDP guide.

Advanced Config

ChatGPT works but OpenAI Sora or the video page spins: Clash DOMAIN-SUFFIX for sora.openai.com, openai.com, oaistatic.com, and chatgpt.com with rule order before GEOIP—video and CDN traffic distinct from api.openai.com chat rules; DNS fake-ip, TUN, Sniffer for IP-only edges; log-first checks—complements the ChatGPT and Claude article, not a duplicate host list.

Troubleshooting

Steam store blank or download at 0 B/s while the browser works through Clash: TUN vs system proxy for the thick client, DNS and fake-ip alignment, log-first DOMAIN-SUFFIX for steampowered and steamstatic ahead of GEOIP, slow-download vs region mirrors, UDP and NAT for multiplayer, SteamWebHelper on Windows, verification checklist—gaming platform and UDP, not streaming or AI tool domain recycling.

Advanced Config

Hugging Face Hub downloads stall while pages load: Clash DOMAIN-SUFFIX for hf.co and huggingface.co, Git LFS and cdn-lfs-style hosts, dedicated HF_HUB proxy-groups before GEOIP, DNS fake-ip and TUN alignment, Sniffer for IP-only CDN flows, stable nodes for large checkpoints—developer artifact delivery, not OpenRouter or Cursor API hostname recycling.

Troubleshooting

Clash on Windows fails after install or update with port 7890 or mixed-port already in use: netstat and Get-NetTCPConnection to PID, Task Manager mapping, free the listener or edit YAML mixed-port and system proxy, external-controller and duplicate-instance notes, WSL2 and Docker pointer—user-intent port conflict guide, not Allow LAN or TUN repeats.

Troubleshooting

Max (HBO) not available in your region behind Clash: log-first DOMAIN-SUFFIX for Warner streaming hosts, dedicated MAX_STREAM-style proxy-groups before GEOIP, DNS fake-ip and TUN without leaks, Sniffer for IP-only TLS, nodes that match your plan—complements Netflix and Disney+ articles, not the same domain paste.

Troubleshooting

Clash and Mihomo rule-providers: fix remote ruleset update failures with correct YAML (type, url, path, behavior, format, interval), PATH permissions and working directory, GitHub or TLS/DNS gotchas, log-first split between download errors and parse errors, and RULE-SET order versus fetch—complements the rule split guide, not a duplicate.

Advanced Config

Firefly and Creative Cloud behind Clash in 2026: sign-in spinners and empty panels from split identity versus library paths; log-derived DOMAIN-SUFFIX for adobe.com, adobe.io, adobelogin.com, typekit.net; dedicated ADOBE_CC proxy-groups before GEOIP; DNS fake-ip with TUN for desktop agents; Sniffer for IP-only TLS; verification before node swaps—not ChatGPT or Cursor hostname recycling.

Advanced Config

Disney+ “not available in your region” behind Clash: BamGrid and Disney+ domain patterns from logs, dedicated STREAMING proxy-groups ahead of GEOIP, DNS fake-ip and TUN alignment, node picks that match your account region—not generic AI domain lists—with verification and compliance notes.

Troubleshooting

When every Clash node shows red on delay test: separate UI probes from real browsing, fix subscription merge and capture mode, align DNS fake-ip with TUN or system proxy, understand UDP and STUN versus TCP latency, tune url-test health checks, and rule out firewall and corporate TLS inspection—cross-platform triage for Mihomo-based clients.

Troubleshooting

Clash works in the browser but docker pull and builds fail: point Docker Desktop HTTP/HTTPS proxy at the local mixed port, separate WSL2 backend behavior on Windows from engine settings, pass HTTP_PROXY into containers and BuildKit build-args, and tell registry timeouts from routing issues using our WSL2 guide when the whole Linux side is offline.

Advanced Config

When Perplexity loads but searches or API calls stall, fix split routing: DOMAIN-SUFFIX rules for perplexity.ai and related hosts, a dedicated proxy-group for long HTTP/2 streams, CDN-aware ordering ahead of GEOIP, DNS fake-ip alignment, and practical node picks—without treating AI traffic as one anonymous bucket.

Installation Guide

Run Clash Verge Rev on Fedora Workstation with SELinux enforcing: fix common AVC patterns around TUN helpers and home-directory binaries, open only the ports your mixed HTTP/SOCKS listeners need in firewalld, scope LAN access with zones or rich rules, and verify bindings before blaming Wi-Fi isolation.

Advanced Config

Toolchain-focused Clash routing for Cursor IDE: separate proxy-groups for *.cursor.sh model APIs versus marketplace.cursorapi.com and CDN binaries, optional VS Code marketplace mirrors, DNS fake-ip alignment, HTTP/2 streaming pitfalls, and verification when the browser works but extensions or inline AI stall—distinct from ChatGPT-only split guides.

Troubleshooting

Clash runs on your PC but phones on the same Wi-Fi cannot use the proxy: verify subnet reachability and guest-network isolation, enable Allow LAN with bind on all interfaces, align HTTP, SOCKS, and mixed port fields on the phone, add Windows Defender Firewall inbound rules and macOS incoming allowances, then rule out sleep and port collisions.

Advanced Config

Split Google Gemini, AI Studio, and the Generative Language API in Clash: DOMAIN-SUFFIX inventory for generativelanguage.googleapis.com and Google OAuth hosts, a dedicated GEMINI proxy-group, DNS fake-ip alignment, rule order before GEOIP, regional node notes, and a short verification checklist distinct from ChatGPT-only rules.

Haven't downloaded Clash yet?

Free and open-source. Supports Windows, macOS, Android, iOS, and Linux. Ready to use in 5 minutes.