🌐 Official Website: clashmac.app

• Route Map: Take off from your city, arc across the globe, land at proxy nodes

  • Multi-hop Transit: dialer-proxy chain visualization, transit flights reach further
  • Live Flights: Every active connection is an airplane, flight status refreshes every 10s
  • Flight Log: Live / Today / This Month / Last Month, review every flight path
  • Global View: Scroll to zoom, drag to pan, double-click to return home
  • Smart Viewport: Auto-adjust view when switching time dimensions, all routes in sight
  • Continental Routes: Color-coded by destination continent, Asia/Europe/America routes at a glance
  • Night Lights: Routes glow like city lights in dark mode
  • Privacy Mode: 190+ cities as random departure points, only you know your location
  • Boarding Ritual: The world is vast, we need a small ceremony

• Connection Topology: Native traffic topology visualization, see where your data comes from and goes

  • Complete Chain: Source IP → Process → Rule → Proxy → Egress, fully transparent
  • Multi-layer Nesting: Supports nested subgroups, complex proxy structures clearly presented
  • Smart Highlight: Hover to illuminate upstream/downstream paths instantly
  • Hover Menu: Path hover shows statistics, popular domains aggregated

• Traffic Statistics: Native traffic statistics engine, track every byte precisely

  • 4D Tracking: Statistics by Proxy/Process/Interface/Host
  • Traffic Trends: 7-day bar chart with daily average, usage patterns at a glance
  • Subscription Usage: Traffic progress, expiry date at a glance
  • Rule Statistics: Visualize rule match counts, one-click reset

• Native Built: SwiftUI + macOS native APIs, deeply integrated with the system
• Dual Proxy Modes: System Proxy + TUN Enhanced, complete traffic coverage
• Lightweight: Menu bar resident, minimal memory footprint

• Standalone Dashboard: Native Dashboard app with Proxies/Rules/Connections/Logs at a glance
• Privacy Mode: One-click hide sensitive info like IP/nodes, share screenshots worry-free

• Real-Time Stats: Menu bar shows speed, connections, memory usage
• Quick Switch: Switch nodes from menu bar/dashboard, one-click latency test
• Auto-Disconnect: Auto-disconnect existing connections on node switch, traffic flows through new node immediately
• Global Hotkeys: System-level shortcuts for proxy control, one-key dashboard access
• One-Click Rules: Add proxy rules for current webpage, supports major browsers

• Zero Config: Auto-complete DNS/TUN/GEO parameters, ready out of the box
• Subscription Management: Remote config import, auto-update, smart naming
• Drag & Drop: Drop YAML config, auto-switch and apply
• Config Pre-Check: Auto-validate before import, pinpoint errors precisely
• Parameter Override: Unified config across subscriptions, no file modification
• Video Boost: Disable overseas QUIC, say goodbye to YouTube buffering

• Crash Diagnosis: Auto-identify issues, provide solutions
• Customizable UI: Show/hide menu items, create your own layout
• Bilingual: Auto-switch between English and Chinese
• Password-Free: Privileged helper handles auth, no password prompts

Minimum Version: macOS 13.5+

Download the latest version from the Releases page:

• Apple Silicon (M1/M2/M3/M4): ClashMac-v*-macos-arm64.zip
• Intel Mac: ClashMac-v*-macos-x86_64.zip

Compatible Configuration: Please refer to Test Configurations

Installation Steps:

1. Unzip the downloaded zip file
2. Drag ClashMac.app to the "Applications" folder
3. On first launch, right-click and select "Open" (to bypass security check)

Tip: Not sure which Mac you have? Click the menu at the top left → About This Mac, and check the "Chip" information.

Note: Mac Gatekeeper may block unsigned applications

1. Try to open ClashMac, click "Done" when the security warning appears
2. Open System Settings → Privacy & Security
3. Scroll down and find the message: "ClashMac was blocked from opening"
4. Click "Open Anyway" next to it
5. Click "Open Anyway" again in the popup dialog

Enter in Terminal:

xattr -cr /Applications/ClashMac.app

Press Enter and reopen the application

Enter in Terminal:

xattr -d com.apple.quarantine /Applications/ClashMac.app

Press Enter and reopen the application

Privileged Helper Security Hardening: Fixed potential command injection vulnerabilities

• Whitelist Path Validation: Only allows kernel execution from /Applications/ClashMac.app/
• Permission Tightening: Restricted to admin user access only
• POC Verified: Attacks like /bin/sh, path traversal are all blocked

"Security is a process, not a product." — Bruce Schneier

This application runs entirely locally on macOS and does not collect or upload user data.

Network access occurs only when explicitly configured by the user, or when the user manually checks for updates (downloads are served via GitHub).

The application requests only the minimum system permissions required for its functionality.

ClashMac is a proprietary, closed-source application.
Only binary releases are provided in this repository.

This project uses third-party open-source components.
The full list of licenses is available at:

THIRD_PARTY_LICENSES

• mihomo
• Vernesong
• Zashboard

Crafted with ❤️ for macOS