Clash-FX /ClashFX

ClashFX — macOS proxy tool with Enhanced Mode (TUN)

★ 306⑂ 27👁 0⑃ 173● 104▤ 124
SwiftAGPL-3.0Created 2026-03-19
Download: 1.1.111.1.11 ↓1.1.112026-09-14
+0
Daily
306
stars
27
forks
0
watchers
173
prs
104
issues
124
releases

README

ClashFX
  


A rule-based macOS proxy client with Enhanced Mode (TUN) — powered by mihomo core.



English | 简体中文 | 繁體中文 | 日本語 | Русский



---

 ✨ Features

- Enhanced Mode (TUN) — Global traffic capture via TUN device, one-click setup
- HTTP/HTTPS and SOCKS protocol support
- Rule-based routing (Domain, IP-CIDR, GeoIP, Process)
- Support for VMess/VLESS/Trojan/Shadowsocks/Hysteria2 protocols
- DNS security with Fake-IP mode
- gVisor userspace network stack
- Apple Silicon native support
- macOS 10.14+ compatibility (including macOS 15 Sequoia)

 📥 Installation

Download from the Releases page.

 🧪 Update Channels: Stable & Lab

 The Lab channel has been live since v1.1.0. Stable remains the default and recommended choice; opt into Lab in Settings → Debug → Update Channel → Lab (Experimental) if you're on v1.1.0+.

ClashFX ships through two update channels. You can choose either — both are first-class.

| | 🟢 Stable | 🟠 Lab |
|---|---|---|
| Default | ✅ | — |
| Release cadence | Every 2–7 days, when fixes accumulate | As soon as a fix lands — sometimes daily |
| What you get | Tested fixes only | Latest fixes + occasional experimental features |
| Visual badge | None | Small orange dot on the top-right of the Dock / Applications icon |

Opt into Lab: open ClashFX → Settings → Debug → Update Channel → Lab (Experimental) and confirm. The orange dot appears immediately. You can switch back to Stable from the same place at any time.

Found a Lab bug? Use Help → Send Feedback… to open a pre-filled GitHub issue (diagnostic info auto-attached and redacted), or Help → Copy Diagnostic Info… to copy the report manually.

Stable users: you're already on the recommended channel — nothing to change.

 🔨 Build from Source

 Prerequisites

- macOS 10.14 or later
- Xcode 15.0+
- Python 3
- Golang 1.21+

 Build Steps

1. Install Golang
   bash
   brew install golang
   

2. Install dependencies
   bash
   bash install_dependency.sh
   

3. Open and build
   bash
   open ClashFX.xcworkspace
    Build in Xcode (Cmd+R)
   

 ⚙️ Configuration

 Default Paths

The default configuration directory is $HOME/.config/clashfx

The default configuration file name is config.yaml. You can use custom config names and switch between them in the Config menu.

 Enhanced Mode

ClashFX's core feature — TUN-based global proxy that captures all TCP/UDP traffic from every application, not just browsers.

How to enable:
1. Menu Bar → Enhanced Mode → Enable
2. Grant administrator privileges on first use
3. All traffic is now routed through ClashFX

 Claude Proxy Lock

Pin Claude Desktop, Claude Code, and Anthropic web traffic to one concrete node with fail-closed protection. See Claude Proxy Lock usage and limits.

 URL Schemes

- Import remote config:
  
  clashfx://install-config?url=http%3A%2F%2Fexample.com&name=example
  clash://install-config?url=http%3A%2F%2Fexample.com&name=example
  

- Reload current config:
  
  clash://update-config
  

 🤝 Companion Repo: cn-apps-direct

The 

Top issues

Latest release

1.1.11 1.1.11 2026-09-14
Bug Fixes

- Invalid TUN Descriptors No Longer Trigger a Log Storm — The embedded core now treats Darwin bad file descriptor and socket operation on non-socket read failures as closed TUN devices instead of retrying forever. ClashFX also recognizes either signature as an immediate Enhanced Mode recovery signal and rate-limits the errors independently of unrelated traffic logs, preventing the CPU, memory, and UI lockup seen during some post-reboot starts.

---

 修复

- 无效 TUN 描述符不再引发日志风暴 — 内嵌核心现在会把 Darwin 的 bad file descriptor 和 socket operation on non-socket 读取错误视为 TUN 已关闭,不再无限重试。ClashFX 也会把两种错

Snapshot: 2026-11-16T09:23:14Z · Data license Apache-2.0 · JSON