Skip to content

666OS/ClashMac

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

36 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ClashMac Logo

ClashMac

Native Proxy Experience Built for macOS

🌐 Official Website: clashmac.app

Latest Release Downloads Official Website

Dashboard
Topology
Dark Light

Core Experience

  • Native Built: SwiftUI + macOS native APIs, deeply integrated with the system
  • Dual Proxy Modes: System Proxy + TUN Enhanced, complete traffic coverage
  • Standalone Dashboard: Native Dashboard app with Proxies/Rules/Connections/Logs at a glance
  • Connection Topology: Native traffic topology visualization, see where your data comes from and goes
  • Traffic Tracking: 4-dimension statistics by Proxy/Process/Interface/Host, byte-level precision
  • Traffic Trends: 7-day bar chart with daily average, usage patterns at a glance
  • Rule Statistics: Visualize rule match counts, one-click reset
  • Privacy Mode: One-click hide sensitive info like IP/nodes, share screenshots worry-free
  • 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
  • Real-Time Stats: Menu bar shows speed, connections, memory usage
  • Subscription Info: Usage, expiry date, progress bar at a glance
  • 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
  • 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
  • Video Boost: Disable overseas QUIC, say goodbye to YouTube buffering
  • Parameter Override: Unified config across subscriptions, no file modification
  • Crash Diagnosis: Auto-identify issues, provide solutions
  • Global Hotkeys: System-level shortcuts for proxy control, one-key dashboard access
  • Lightweight: Menu bar resident, minimal memory footprint
  • Customizable UI: Show/hide menu items, create your own layout
  • Auto Update: Detect new versions, one-click upgrade
  • Bilingual: Auto-switch between English and Chinese
  • Password-Free: Privileged helper handles auth, no password prompts

System Requirements

Minimum Version: macOS 13.5+

macOS 12.x Users: Please continue using v1.4.24, stable and reliable

Download

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

Solutions

Method 1: Allow in System Settings

  1. Try to open ClashMac, click "Done" when the security warning appears
  2. Open System SettingsPrivacy & 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

Method 2: Remove Restrictions via Terminal

Enter in Terminal:

xattr -cr /Applications/ClashMac.app

Press Enter and reopen the application

Method 3: Remove Quarantine Attribute

Enter in Terminal:

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

Press Enter and reopen the application

Security Design

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

Security & Privacy

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.

License

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

Acknowledgments

Star History

Star History Chart


Crafted with ❤️ for macOS