Skip to content
/ ClashMac Public

基于 Clash (mihomo) 内核的轻量级 macOS 菜单栏客户端。Lightweight macOS Clash (mihomo) menu bar client.

License

Notifications You must be signed in to change notification settings

666OS/ClashMac

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

29 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

ClashMac Logo

ClashMac

Lightweight macOS Clash Menu Bar Client

🌐 Official Website: clashmac.app

Latest Release Downloads Official Website

ClashMac Website

Preview

Dark Light
Dark Light
Dashboard

Features

  • Native Development: Built with SwiftUI, deeply integrated with macOS
  • Dual Proxy Modes: System Proxy + TUN Enhanced, complete traffic coverage
  • Standalone Dashboard: Native Dashboard app with Proxies/Rules/Connections/Logs at a glance
  • Traffic Tracking: 4-dimension statistics by Proxy/Process/Interface/Host, byte-level precision
  • 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 directly from menu bar, one-click latency test
  • 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
  • Shortcuts: Rich keyboard shortcuts for efficient control
  • 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

Feature Minimum Version
Basic Features macOS 12.4+
Dashboard/Traffic Stats/Privacy Mode macOS 13.0+

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


Made with ❤️ for macOS

About

基于 Clash (mihomo) 内核的轻量级 macOS 菜单栏客户端。Lightweight macOS Clash (mihomo) menu bar client.

Topics

Resources

License

Stars

Watchers

Forks

Packages

No packages published