ClashMac: macOS Network Proxy Management Tool
GitHub RepoImpressions1k

ClashMac: macOS Network Proxy Management Tool

@githubprojectsPost Author

Project Description

View on GitHub

ClashMac: A Clean macOS Proxy Manager That Won't Get in Your Way

If you've ever wrestled with network proxies on macOS, you know the pain. System Preferences feels clunky, terminal-based tools like networksetup work but aren't fun, and most GUI tools are either abandoned or overengineered.

ClashMac might actually fix that. It's a lightweight macOS-native proxy management tool built around Clash — the popular rule-based proxy engine. But it does something simple that I find rare: it gets out of your way.


What It Does

ClashMac is a macOS menu bar app that wraps Clash's core functionality into a clean, native interface. It lets you:

  • Manage multiple proxy configurations (HTTP, SOCKS5, Shadowsocks, etc.)
  • Toggle system-wide proxy on/off with one click
  • Switch between different proxy modes (global, rule-based, direct)
  • View real-time traffic stats and connection details
  • Edit Clash configuration files directly from the app

It doesn't reinvent proxy management — it just makes the parts you use daily actually pleasant to interact with.


Why It’s Cool

The standout feature is how unobtrusive ClashMac is. Most proxy managers either force you into a web dashboard or require constant terminal interaction. This one lives in your menu bar, does its job, and stays silent until you need it.

A few things that impressed me:

  • Native macOS look and feel — SwiftUI-based UI that actually respects system dark mode, font rendering, and keyboard shortcuts. It doesn't look like a web app stuffed into a dock icon.
  • Snappy traffic monitoring — You get a live bandwidth graph and per-connection logs without the usual UI lag.
  • One-click proxy mode switching — From "direct" (no proxy) to "global" (all traffic proxied) to "rule-based" (using your custom Clash rules). No reloading configs, no toggling system settings manually.
  • Built-in configuration editor — Tired of editing YAML files in VS Code? The app has a stripped-down text editor for Clash's config. Nothing fancy, but it works.

Under the hood, it's using Clash's core API, so it supports all the protocol backends Clash supports (V2Ray, Trojan, SSR, etc.). But you don't need to care about that unless you want to.


How to Try It

Clone the repo, build, and run. It's as simple as:

git clone https://github.com/666OS/ClashMac
cd ClashMac
open ClashMac.xcodeproj

Then hit Cmd+R in Xcode. Or grab a prebuilt release from the Releases page. No Homebrew formula yet, but it's planned.

You'll need macOS 12.0+ (Monterey) and a Clash config file ready to go. The app provides a default config to help you get started.


Final Thoughts

ClashMac won't revolutionize your workflow. But if you're already using Clash — or thinking about trying it — this is the kind of tool that makes the experience feel native and effortless. No searching for the right terminal command, no reloading configs through a web UI.

For developers who bounce between VPNs, corporate proxies, and personal setups, this is a low-friction way to keep your network under control. It's still early days (the repo has active development), but the core is solid.

Worth a look if you're tired of proxy friction on macOS.


Found this useful? Follow us at @githubprojects for more dev tools and projects.

Back to Projects
Project ID: a8a530fc-1cbc-4838-a17a-1570e5de1af2Last updated: April 28, 2026 at 07:02 AM