{"id":40890998,"url":"https://github.com/666OS/ClashMac","last_synced_at":"2026-01-31T05:00:43.832Z","repository":{"id":326835545,"uuid":"1105733943","full_name":"666OS/ClashMac","owner":"666OS","description":"Native Proxy Experience Built for macOS","archived":false,"fork":false,"pushed_at":"2026-01-23T10:53:38.000Z","size":8277,"stargazers_count":4085,"open_issues_count":104,"forks_count":163,"subscribers_count":6,"default_branch":"main","last_synced_at":"2026-01-23T18:34:52.110Z","etag":null,"topics":["clash","clash-meta","macos","mihomo","network","proxy","swiftui"],"latest_commit_sha":null,"homepage":"https://clashmac.app","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/666OS.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2025-11-28T04:41:02.000Z","updated_at":"2026-01-23T15:33:39.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/666OS/ClashMac","commit_stats":null,"previous_names":["666os/clashmac"],"tags_count":112,"template":false,"template_full_name":null,"purl":"pkg:github/666OS/ClashMac","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/666OS%2FClashMac","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/666OS%2FClashMac/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/666OS%2FClashMac/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/666OS%2FClashMac/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/666OS","download_url":"https://codeload.github.com/666OS/ClashMac/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/666OS%2FClashMac/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28929862,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-31T04:05:25.756Z","status":"ssl_error","status_checked_at":"2026-01-31T04:02:35.005Z","response_time":128,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["clash","clash-meta","macos","mihomo","network","proxy","swiftui"],"created_at":"2026-01-22T02:00:24.137Z","updated_at":"2026-01-31T05:00:43.827Z","avatar_url":"https://github.com/666OS.png","language":null,"readme":"\u003cp align=\"center\"\u003e\n  \u003cimg src=\"assets/Logo-Default.png\" alt=\"ClashMac Logo\" width=\"300\" style=\"filter: drop-shadow(0 4px 12px rgba(0, 0, 0, 0.15));\"\u003e\n\u003c/p\u003e\n\u003ch1 align=\"center\"\u003eClashMac\u003c/h1\u003e\n\u003ch3 align=\"center\" style=\"margin-top: 0; margin-bottom: 10px;\"\u003eNative Proxy Experience Built for macOS\u003c/h3\u003e\n\u003cp align=\"center\"\u003e\n  🌐 \u003ca href=\"https://clashmac.app\"\u003e\u003cstrong\u003eOfficial Website: clashmac.app\u003c/strong\u003e\u003c/a\u003e\n\u003c/p\u003e\n\n\u003cp align=\"center\" style=\"margin-top: 0; margin-bottom: 20px;\"\u003e\n  \u003ca href=\"https://github.com/666OS/ClashMac/releases/latest\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/v/release/666OS/ClashMac?style=flat-square\u0026logo=github\u0026color=green\" alt=\"Latest Release\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://github.com/666OS/ClashMac/releases\"\u003e\n    \u003cimg src=\"https://img.shields.io/github/downloads/666OS/ClashMac/total?style=flat-square\u0026logo=dropbox\u0026logoColor=white\u0026color=gold\" alt=\"Downloads\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://clashmac.app\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/Official-Website-orange?style=flat-square\u0026logo=safari\" alt=\"Official Website\"\u003e\n  \u003c/a\u003e\n  \u003ca href=\"https://t.me/Pinched666\"\u003e\n    \u003cimg src=\"https://img.shields.io/badge/Telegram-Channel-blue?style=flat-square\u0026logo=telegram\"\u003e\n  \u003c/a\u003e\n\u003c/p\u003e\n\n\u003ctable\u003e\n  \u003ctr\u003e\n    \u003ctd colspan=\"2\" align=\"center\"\u003e\u003cimg src=\"./assets/dashboard.jpg\" alt=\"Dashboard\"\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd colspan=\"2\" align=\"center\"\u003e\u003cimg src=\"./assets/Route.jpg\" alt=\"Route\"\u003e\u003c/td\u003e\n  \u003c/tr\u003e \n  \u003ctr\u003e\n    \u003ctd colspan=\"2\" align=\"center\"\u003e\u003cimg src=\"./assets/Topology.jpg\" alt=\"Topology\"\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd\u003e\u003cimg src=\"./assets/preview_dark.png\" alt=\"Dark\"\u003e\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src=\"./assets/preview_light.png\" alt=\"Light\"\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\n## Core Experience\n\n- **Route Map**: Take off from your city, arc across the globe, land at proxy nodes\n  - Multi-hop Transit: dialer-proxy chain visualization, transit flights reach further\n  - Live Flights: Every active connection is an airplane, flight status refreshes every 10s\n  - Flight Log: Live / Today / This Month / Last Month, review every flight path\n  - Global View: Scroll to zoom, drag to pan, double-click to return home\n  - Smart Viewport: Auto-adjust view when switching time dimensions, all routes in sight\n  - Continental Routes: Color-coded by destination continent, Asia/Europe/America routes at a glance\n  - Night Lights: Routes glow like city lights in dark mode\n  - Privacy Mode: 190+ cities as random departure points, only you know your location\n  - Boarding Ritual: The world is vast, we need a small ceremony\n\n- **Connection Topology**: Native traffic topology visualization, see where your data comes from and goes\n  - Complete Chain: Source IP → Process → Rule → Proxy → Egress, fully transparent\n  - Multi-layer Nesting: Supports nested subgroups, complex proxy structures clearly presented\n  - Smart Highlight: Hover to illuminate upstream/downstream paths instantly\n  - Hover Menu: Path hover shows statistics, popular domains aggregated\n\n- **Traffic Statistics**: Native traffic statistics engine, track every byte precisely\n  - 4D Tracking: Statistics by Proxy/Process/Interface/Host\n  - Traffic Trends: 7-day bar chart with daily average, usage patterns at a glance\n  - Subscription Usage: Traffic progress, expiry date at a glance\n  - Rule Statistics: Visualize rule match counts, one-click reset\n\n### Native Architecture\n- **Native Built**: SwiftUI + macOS native APIs, deeply integrated with the system\n- **Dual Proxy Modes**: System Proxy + TUN Enhanced, complete traffic coverage\n- **Lightweight**: Menu bar resident, minimal memory footprint\n\n### Visual Dashboard\n- **Standalone Dashboard**: Native Dashboard app with Proxies/Rules/Connections/Logs at a glance\n- **Privacy Mode**: One-click hide sensitive info like IP/nodes, share screenshots worry-free\n\n### Proxy \u0026 Control\n- **Real-Time Stats**: Menu bar shows speed, connections, memory usage\n- **Quick Switch**: Switch nodes from menu bar/dashboard, one-click latency test\n- **Auto-Disconnect**: Auto-disconnect existing connections on node switch, traffic flows through new node immediately\n- **Global Hotkeys**: System-level shortcuts for proxy control, one-key dashboard access\n- **One-Click Rules**: Add proxy rules for current webpage, supports major browsers\n\n### Configuration\n- **Zero Config**: Auto-complete DNS/TUN/GEO parameters, ready out of the box\n- **Subscription Management**: Remote config import, auto-update, smart naming\n- **Drag \u0026 Drop**: Drop YAML config, auto-switch and apply\n- **Config Pre-Check**: Auto-validate before import, pinpoint errors precisely\n- **Parameter Override**: Unified config across subscriptions, no file modification\n- **Video Boost**: Disable overseas QUIC, say goodbye to YouTube buffering\n\n### System \u0026 Experience\n- **Crash Diagnosis**: Auto-identify issues, provide solutions\n- **Customizable UI**: Show/hide menu items, create your own layout\n- **Bilingual**: Auto-switch between English and Chinese\n- **Password-Free**: Privileged helper handles auth, no password prompts\n\n## System Requirements\n\n**Minimum Version**: macOS 13.5+\n\n## Download\n\nDownload the latest version from the [Releases page](https://github.com/666OS/ClashMac/releases/latest):\n\n- **Apple Silicon (M1/M2/M3/M4)**: `ClashMac-v*-macos-arm64.zip`\n- **Intel Mac**: `ClashMac-v*-macos-x86_64.zip`\n\n**Compatible Configuration**: Please refer to [Test Configurations](https://github.com/666OS/YYDS/tree/main/mihomo/config)\n\n**Installation Steps**:\n1. Unzip the downloaded zip file\n2. Drag `ClashMac.app` to the \"Applications\" folder\n3. On first launch, right-click and select \"Open\" (to bypass security check)\n\n**Tip**: Not sure which Mac you have? Click the  menu at the top left → About This Mac, and check the \"Chip\" information.\n\n\u003e **Note: Mac Gatekeeper may block unsigned applications**\n\n### Solutions\n\n#### Method 1: Allow in System Settings\n1. Try to open ClashMac, click \"Done\" when the security warning appears\n2. Open **System Settings** → **Privacy \u0026 Security**\n3. Scroll down and find the message: \"ClashMac was blocked from opening\"\n4. Click \"Open Anyway\" next to it\n5. Click \"Open Anyway\" again in the popup dialog\n\n#### Method 2: Remove Restrictions via Terminal\nEnter in Terminal:\n\n```bash\nxattr -cr /Applications/ClashMac.app\n```\nPress Enter and reopen the application\n\n\n#### Method 3: Remove Quarantine Attribute\n\nEnter in Terminal:\n```bash\nxattr -d com.apple.quarantine /Applications/ClashMac.app\n```\nPress Enter and reopen the application\n\n## Security Design\n\n**Privileged Helper Security Hardening**: Fixed potential command injection vulnerabilities\n\n- **Whitelist Path Validation**: Only allows kernel execution from `/Applications/ClashMac.app/`\n- **Permission Tightening**: Restricted to admin user access only\n- **POC Verified**: Attacks like `/bin/sh`, path traversal are all blocked\n\n\u003e *\"Security is a process, not a product.\"* — Bruce Schneier\n\n## Security \u0026 Privacy\n\nThis application runs entirely locally on macOS and does not collect or upload user data.  \n\nNetwork access occurs only when explicitly configured by the user, or when the user manually checks for updates (downloads are served via GitHub).  \n\nThe application requests only the minimum system permissions required for its functionality.  \n\n## License\n\nClashMac is a proprietary, closed-source application.  \nOnly binary releases are provided in this repository.\n\nThis project uses third-party open-source components.  \nThe full list of licenses is available at:\n\n[THIRD_PARTY_LICENSES](https://github.com/666OS/ClashMac/blob/main/THIRD_PARTY_LICENSES.txt) \n\n## Acknowledgments\n\n- [mihomo](https://github.com/MetaCubeX/mihomo)\n- [Vernesong](https://github.com/vernesong/mihomo)\n- [Zashboard](https://github.com/Zephyruso/zashboard)\n\n## Star History\n[![Star History Chart](https://api.star-history.com/svg?repos=666OS/ClashMac\u0026type=Date)](https://star-history.com/#666OS/ClashMac\u0026Date)\n\n---\n\n\u003cp align=\"center\"\u003e\n  Crafted with ❤️ for macOS\n\u003c/p\u003e\n","funding_links":[],"categories":["Others"],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F666OS%2FClashMac","html_url":"https://awesome.ecosyste.ms/projects/github.com%2F666OS%2FClashMac","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2F666OS%2FClashMac/lists"}