README
<p align="center">
<img src="assets/cat.svg" alt="ClashMac Logo" width="300">
</p>
<h1 align="center">ClashMac 27</h1>
<h3 align="center" style="margin-top: 0; margin-bottom: 10px;">Native Proxy Experience Built for macOS</h3>
<p align="center">
🌐 <a href="https://clashmac.app"><strong>Official Website</strong></a>
📖 <a href="https://clashmac.app/guide/"><strong>User Manual</strong></a>
</p>
<p align="center" style="margin-top: 0; margin-bottom: 20px;">
<a href="https://github.com/666OS/ClashMac/releases/latest">
<img src="https://img.shields.io/github/v/release/666OS/ClashMac?style=flat-square&logo=github&color=green" alt="Latest Release">
</a>
<a href="https://github.com/666OS/ClashMac/releases">
<img src="https://img.shields.io/github/downloads/666OS/ClashMac/total?style=flat-square&logo=dropbox&logoColor=white&color=gold" alt="Downloads">
</a>
<a href="https://clashmac.app">
<img src="https://img.shields.io/badge/Official-Website-orange?style=flat-square&logo=safari" alt="Official Website">
</a>
<a href="https://t.me/Pinched666">
<img src="https://img.shields.io/badge/Telegram-Channel-blue?style=flat-square&logo=telegram">
</a>
</p>
<table>
<tr>
<td colspan="2" align="center"><img src="./assets/dashboard_b.jpg" alt="Dashboard"></td>
</tr>
<tr>
<td colspan="2" align="center"><img src="./assets/Route_b.jpg" alt="Route"></td>
</tr>
<tr>
<td colspan="2" align="center"><img src="./assets/Topology_b.jpg" alt="Topology"></td>
</tr>
<tr>
<td colspan="2" align="center"><img src="./assets/menu_b.jpg" alt="Menu"></td>
</tr>
</table>
✨ Features
🗺️ Visual Route Map
- Live Flight Routes: Watch your active proxy traffic fly across the globe in real-time, updating every 10 seconds.
- Interactive Control: Zoom, pan, and hover over paths for instant telemetry. Supports historical audit logs.
- Smart Obfuscation: Mask your precise location by randomizing your departure point across 190+ global cities.
🔍 Active Connections & Rules
- Live Traffic Grid: Check which apps are consuming bandwidth, their speeds, protocols, and routing rules.
- One-Click Rule Maker: Instantly add custom proxy or blocking rules for the active browser tab or process.
- Instant Cut-off: Disconnect any hogging connection with a simple right-click.
📊 Real-time Dashboard
- Speed Curves: High-definition, smooth graph tracking upload and download bandwidth over a 60-second window.
- Leaderboards: Automatically lists your most active target domains, matched rules, and destinations.
- Resource Monitoring: Track system memory footprint of both the UI and the underlying network engine.
---
🛠️ Built for macOS
- 100% Native: Built exclusively in SwiftUI for native performance. Resides quietly in the menu bar with minimal CPU and memory footprints.
- TUN Enhanced: System-wide proxy integration with complete UDP/TCP capture.
- No Setup Needed: Ready out of the box with automated DNS, TUN, and routing database parameters.
- Video Boost: Disable QUIC protocols to prevent ISP throttling and eliminate buffering on YouTube and Netflix.
- No Repeated Passwords: Authorize network helper tool installation once—never get prompted for admin passwords again.
---
💻 Get Started
- System Requirement: macOS 15.0+ (Sequoia or later)
Installation
1. Download the latest
ClashMac.dmg disk image from the Releases page.2. Double-click the
.dmg and drag ClashMac.app into your Applications folder.> [!CAUTION]
> Do not run ClashMac directly from the
.dmg installer window, as macOS security sandbox will prevent the application from saving settings and installing system network services.3. On first launch, right-click
ClashMac.app and select Open. ClashMac will register its system helper tool and automatically download the correct kernel engine matching your Mac's CPU architecture (Apple Silicon or Intel).---
🛡️ Bypassing Gatekeeper
If macOS blocks launching with a warning (e.g., "developer cannot be verified"), use one of these solutions:
- System Settings: Go to System Settings $\rightarrow$ Privacy & Security, scroll down to find the block notice, and click Open Anyway.
- Terminal Command: Run the following command in Terminal to clear the quarantine flag:
sudo xattr -rd com.apple.quarantine /Applications/ClashMac.app---
🔒 Security & Privacy
- 100% Local: All settings, traffic details, and history stay locally on your Mac. No data collection, tracking, or logs.
- Secure Helper: The background system helper is hardened and restricted to run core files solely from /Applications/ClashMac.app/.
---
📄 License & Credits
ClashMac is proprietary, closed-source software. Binary releases are provided in this repository.
View third-party credits and licenses here:
👉 THIRD_PARTY_LICENSES
---
Star History
[](https://star-history.com/#666OS/ClashMac&Date)
<p align="center">
Crafted with ❤️ for macOS
</p>
---