ClashX Common Issues & Solutions
Connection failed? Cannot update subscription? Here are the most common issues and fixes.
Troubleshooting
v1.123.0 Released
Built for macOS
Professional Proxy Tool
Native development, perfectly fits macOS design language. Supports Apple Silicon, delivering unparalleled performance and stability. Making network connections simple again.
Open Source
Users Trust
Community
GitHub Stars
Maintained
Free & Open Source
Overview
Connected: Rule
Upload Speed
24 KB/s
Download Speed
5.2 MB/s
Set as System Proxy
Enhanced Mode
Sponsored
Our Mission and Core Values
We help Mac users use ClashX in a legal, transparent, and controlled way instead of just handing over a download button.
The pain points we see are consistent: beginners worry about making mistakes and hesitate to import subscriptions; system upgrades such as Sequoia can create compatibility uncertainty; menu bar tools are often misunderstood as black boxes or privacy risks; Rules and TUN settings feel too complex; long sessions raise concerns about battery life and performance; and developers still need reliable networking for Git, terminals, and CI. To solve this, we provide an open-source, auditable client, structured tutorials and troubleshooting guides, fully local YAML validation and Rules generation tools, and clear explanations of risk boundaries and compliant use cases throughout the site.
Our solution path is straightforward: 1) official GitHub download and verification guidance to avoid tampered packages; 2) step-by-step visuals for Dashboard, TUN, Rules, and subscriptions that cover principles, actions, and verification; 3) local tools that protect privacy and never upload configs; 4) performance and power optimization advice with measurable indicators; 5) common error codes and log examples for self-diagnosis; 6) a developer column covering Git, Homebrew, terminal, and script proxy workflows; and 7) curated Rules sets with one-click add to reduce repeated trial and error. We want to make the distance between "it connects" and "I can trust it long term" measurable and repeatable.
- Safe sources: we only point to official GitHub releases and verification files, and never distribute third-party modified packages.
- Privacy first: tool pages and validators run entirely in the browser and never upload configs.
- Verifiable guidance: each tutorial includes context, steps, checkpoints, and further reading to avoid fragmented how-tos.
- Compliance notice: we emphasize lawful use and target-site terms, with clear risks and disclaimers.
- Long-term maintenance: changelogs and version notes stay public so content remains aligned with releases.
Powerful, and Beyond
Every detail carefully designed to provide the smoothest macOS proxy experience.
Apple Silicon Native Support
Optimized for M1/M2/M3 chips. Written in Go, minimal memory usage, almost no CPU consumption, keeping your Mac cool.
Safe & Reliable
Open source and transparent, hosted on GitHub, community reviewed
Native UI Design
Follows macOS Human Interface Guidelines, supports dark mode, perfectly integrated with the system.
Smart Routing
Automatically routes traffic based on rules. Direct for domestic, proxy for overseas. Best of both worlds.
Visual Dashboard
Intuitive traffic statistics charts, real-time upload/download monitoring, network status at a glance.
Get Started in 3 Steps
No complex configuration, get started in minutes.
1
Download & Install
Download the latest .dmg package and drag it to your Applications folder.
Go to Download β2
Import Config
One-click import subscription link, or drag config file to the menu bar icon.
View Tutorial β3
Enable Proxy
Check "Set as System Proxy" in the menu bar to start browsing freely.
User Guide
Advanced Tutorial
How to Configure Custom Routing Rules
Learn to edit config files, route specific websites through specific nodes for precise control.
Comparison
ClashX vs ClashX Pro
What are the differences? What is Enhanced Mode? Help you make the choice.
Why Trust Us
We are more than a download page, focused on delivering value you can verify and rely on.
Open Source Transparency and Minimal Data Exposure
Maintained continuously since 2018, with code hosted on GitHub for auditing; no personally identifiable data is collected by default, and tool pages (YAML validation, Rules generation) run entirely locally.
Focused on the macOS Experience
Built around Apple HIG, with support for Intel and M-series Macs and a native UI/UX; includes full workflow guides for TUN, Rules debugging, and Dashboard.
Knowledge Base and Practical Guides
Tutorials, troubleshooting, and comparison reviews cover the full workflow, and every article includes background, principles, steps, and further reading instead of only a download link.
Safety and Compliance
We only link to official GitHub release packages; the project is open-source under GPL-3.0; and we clearly outline lawful use cases and risks while respecting target-site terms.
Latest Updates
Continuously updated to keep content aligned with releases.
2026-03-15
v1.123.0 - Fix false update prompt: align CFBundleVersion with CFBundleShortVersionString to stop Sparkle from incorrectly reporting available updates.
2026-03-12
v1.122.0 - Auto-update fix: add Sparkle EdDSA signing key, fix greyed-out 'Check for Updates' menu item.
2026-03-11
v1.121.0 - Helper installation optimization: silent fallback when SMJobBless fails; Dashboard auto-connect improvement.
2025-12-21
v1.120.0 - Dashboard fix release: replaces the deprecated Clash Dashboard with MetaCubeX/Yacd-meta, adds automatic API URL detection, and improves error handling.
2025-10-16
v1.119.0 - macOS Sequoia compatibility update: fixes key crashes and compatibility issues on macOS 15 Sequoia, resolves launch crashes, and refines the proxy menu UI.
Security and Compliance Statement
We clarify sources, usage, and responsibilities to protect both users and the platform.
Software Source
We only link to official GitHub releases and verification files, and do not provide third-party modified packages.
Open Source License
Distributed under the GPL-3.0 license; use it only within legal and compliant boundaries, and never for infringing or unlawful purposes.
Privacy and Data
We do not collect personally identifiable information; tools and verification features run in the local browser and never upload any config content.
Risk Notice
Before using third-party nodes, make sure the source is trustworthy; comply with local laws and the target site's terms of service.
Content Transparency
We publish our editorial standards, author information, and revision history.
ClashX Download: How to Confirm It Comes from Official GitHub Releases
To keep your download safe, always get ClashX from official channels. The official download source is GitHub Releases, with URLs in the format github.com/ClashX-Pro/ClashX/releases.
β 3 Ways to Verify the Download Source:
- Check that the domain is
github.com - Confirm the file size is about 24.4 MB (DMG format)
- Review the file's SHA256 checksum (provided on the release page)
How to Use ClashX: 3 Steps for Beginners
1
Download and Install
Download the official .dmg file and drag it into the Applications folder. On first launch, allow it to run in System Settings.
2
Import Subscription
Click the menu bar icon β Config β Remote Config β Manage, paste your subscription link, and set it as the current config.
3
Enable Proxy
Set the mode to "Rules" and turn on "Set as System Proxy." Your browser and apps should now be able to connect.
ClashX Not Connecting? Start With This Checklist
π΄ Most Common Issue: Subscription Link Invalid
Fix: contact your provider for a new subscription link, or check whether the current one has expired. Then choose "Update Config" from the menu to fetch it again.
π Another Common Issue: System Proxy Not Enabled
Fix: click the ClashX menu bar icon and make sure "Set as System Proxy" is checked. For terminal apps, you may also need to enable TUN mode.
π’ Node Issue: All Nodes Time Out
Fix: use the "Delay Test" feature to test all nodes and choose the one with the lowest latency. If they all fail, check your local network or contact your provider.